Conversions: Difference between revisions

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


= Общий алгоритм работы =
<!--T:2-->
На показе вы запускаете наш скрипт и передаёте в него уникальный индентификатор показа в параметре cnvId. Мы проверяем показ и пишем результаты проверки в базу данных.
= 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-->
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.


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


<!--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 43: 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-->
После того, как опции включена и механизм передачи cnvId реализован, в статистике в разделе метрики у вас появится пункт '''Конверсии'''. С его помощью можно посмотреть какие срезы конвертили больше, а какие меньше. Например, мы смотрим срез по '''Sub 5'''.
= 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]]
[[File:Conversion 2.png]]


Если нажать на значение конверсии, вы попадёте на статистику, в котором будут только те показы, которые сконвертили в данном срезе. Например, все конверсии среза Sub 5=807. Чтобы выйти из этого среза и вернуться на предыдущую таблицу, нажмите на стрелку около цифры 4.
<!--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]]
[[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"