Conversions: Difference between revisions

From Wiki Kaminari Click
No edit summary
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
Если вы хотите проверять с нашей помощью конверсии, это можно сделать с помощью опции '''Conversions'''.
<languages/>
<translate>
<!--T:1-->
If you want to check conversions with our help, activate the '''Conversions''' option on your integration.


= Option activation =
<!--T:2-->
Ask your manager to activate the '''Conversions''' option on your integration.
= General workflow =
At the hit, you run our script and pass it the unique identifier of the hit in the <code>cnvId</code> parameter. We check the visitor and write the verification results to the database.


= Общий алгоритм работы =
<!--T:3-->
На показе вы запускаете наш скрипт и передаёте в него в параметре cnvId уникальный индентификатор. Мы проверяем показ и пишем результаты проверки в базу данных.
After the conversion has occurred, you send us a postback with the same unique identifier. With its help, we combine conversion and hit's verification and display the result in statistics.


После того, как случилась конверсия вы шлёте нам постбек с тем же самым уникальным идентификатором. С помощью этого идентификатора мы склеиваем конверсию и проверку показа и показываем результат в статистике.
<!--T:4-->
 
= Implementation JS Check-type integration =
= Реализация в интеграции типа JS Check =
Add the <code>cnvId</code> key to <code>window.kmnr</code> with any unique identifier convenient for you.
Добавьте в <code>window.kmnr</code> ключ <code>cnvId</code> с любым удобным для вас уникальным идентификатором.


<!--T:5-->
[[File:Conversion 1.png]]
[[File:Conversion 1.png]]


= Реализация в интеграции типа Meta Redirect =
<!--T:6-->
Добавьте в URL GET-параметр <code>cnvId</code>.
= Implementation Meta Redirect-type integration =
Add the <code>cnvId</code> parameter into URL.


<!--T:7-->
<pre>https://kaminari.systems/v1/click?kmnrKey=111111111&cnvId=CONVERSION_ID&u=https%3A%2F%2Fsome.url</pre>
<pre>https://kaminari.systems/v1/click?kmnrKey=111111111&cnvId=CONVERSION_ID&u=https%3A%2F%2Fsome.url</pre>


= Постбек =
<!--T:8-->
После конверсии пришлите нам на URL <code>https://kaminari.click/v1/conversion</code> постбек
= Postback =
For any type of integration after conversion, send us a postback to the URL <code>https://kaminari.systems/v1/conversion</code> with the following parameters:


<pre>https://kaminari.click/v1/conversion?kmnrKey=111111111&cnvId=CONVERSION_ID&sub1=111&sub2=222&sub3=333&sub4=444&sub5=555&sub6=666&sub7=777&status=approved&currency=RUB&payout=12</pre>
<!--T:9-->
<pre>https://kaminari.systems/v1/conversion?kmnrKey=111111111&cnvId=CONVERSION_ID&sub1=111&sub2=222&sub3=333&sub4=444&sub5=555&sub6=666&sub7=777&status=l1&currency=RUB&payout=12</pre>


<!--T:10-->
{| class="wikitable"
{| class="wikitable"
|-
|-
! Name !! Value !! -
! Name !! Value !! -
|-
|-
| cnvId || Unique conversion identifier convenient for you || required
| cnvId || Unique conversion identifier convenient for you || '''required'''
|-
|-
| kmnrKey || Integration identifier || required
| kmnrKey || Integration identifier || '''required'''
|-
|-
| sub1 || Sub-tags that were sent with the hit || optional
| sub1 || Sub-tags that were sent with the hit || optional
Line 46: Line 55:
| sub7 || ... || optional
| sub7 || ... || optional
|-
|-
| status || Cтатус конверсии, возможные значения: <code>approved</code>, <code>reject</code>, <code>hold</code>, <code>test</code>  || required
| status || Conversion status, possible values are: <code>l1</code>, <code>l2</code>, <code>l3</code>, <code>l4</code>  || '''required'''
|-
|-
| currency || Валюта конверсии (<code>RUB</code>, <code>USD</code>, <code>EUR</code>). Полный список возможных значений: [https://www.xe.com/iso4217.php ISO 4217] || optional
| currency || Conversion currency (<code>RUB</code>, <code>USD</code>, <code>EUR</code>). Complete list of possible values: [https://www.xe.com/iso4217.php ISO 4217] || optional
|-
|-
| payout || Стоимость конверсии || optional
| payout || Conversion payout  || optional
|}
|}
<!--T:11-->
= How to view conversions in statistics =
After the option is enabled and the parameter <code>cnvId</code> passing mechanism is implemented, you will see the '''Conversion''' metric in your statistics. With its help, you can see which slices converted more and which converted less. For example, we are looking at a '''Sub 5''' slice.
<!--T:12-->
[[File:Conversion 2.png]]
<!--T:13-->
If you click on the conversion value, you will be taken to a table that will only show impressions that converted. For example, there were four conversions on the <code>Sub 5 = 807</code>, and here we can look at them in detail.
<!--T:14-->
[[File:Conversion 3.png]]
<!--T:15-->
To exit this slice and return to the previous table, click on the arrow under the column heading '''Conversions'''.
</translate>

Latest revision as of 19:35, 27 January 2025

Other languages:

If you want to check conversions with our help, activate the Conversions option on your integration.

General workflow

At the hit, you run our script and pass it the unique identifier of the hit in the cnvId parameter. We check the visitor and write the verification results to the database.

After the conversion has occurred, you send us a postback with the same unique identifier. With its help, we combine conversion and hit's verification and display the result in statistics.

Implementation JS Check-type integration

Add the cnvId key to window.kmnr with any unique identifier convenient for you.

Conversion 1.png

Implementation Meta Redirect-type integration

Add the cnvId parameter into URL. 

https://kaminari.systems/v1/click?kmnrKey=111111111&cnvId=CONVERSION_ID&u=https%3A%2F%2Fsome.url

Postback

For any type of integration after conversion, send us a postback to the URL https://kaminari.systems/v1/conversion with the following parameters: 

https://kaminari.systems/v1/conversion?kmnrKey=111111111&cnvId=CONVERSION_ID&sub1=111&sub2=222&sub3=333&sub4=444&sub5=555&sub6=666&sub7=777&status=l1&currency=RUB&payout=12
Name Value -
cnvId Unique conversion identifier convenient for you required
kmnrKey Integration identifier required
sub1 Sub-tags that were sent with the hit optional
sub2 ... optional
sub3 ... optional
sub4 ... optional
sub5 ... optional
sub6 ... optional
sub7 ... optional
status Conversion status, possible values are: l1, l2, l3, l4 required
currency Conversion currency (RUB, USD, EUR). Complete list of possible values: ISO 4217 optional
payout Conversion payout optional

How to view conversions in statistics

After the option is enabled and the parameter cnvId passing mechanism is implemented, you will see the Conversion metric in your statistics. With its help, you can see which slices converted more and which converted less. For example, we are looking at a Sub 5 slice.

Conversion 2.png

If you click on the conversion value, you will be taken to a table that will only show impressions that converted. For example, there were four conversions on the Sub 5 = 807, and here we can look at them in detail.

Conversion 3.png

To exit this slice and return to the previous table, click on the arrow under the column heading Conversions.

Retrieved from "https://wiki.kaminari.click/index.php?title=Conversions&oldid=1355"