Conversions: Difference between revisions
No edit summary |
(Marked this version for translation) |
||
| Line 2: | Line 2: | ||
<languages/> | <languages/> | ||
<translate> | <translate> | ||
<!--T:1--> | |||
Если вы хотите проверять с нашей помощью конверсии, ask your manager to activate the '''Conversions''' option on your integration. | Если вы хотите проверять с нашей помощью конверсии, ask your manager to activate the '''Conversions''' option on your integration. | ||
<!--T:2--> | |||
= Общий алгоритм работы = | = Общий алгоритм работы = | ||
На показе вы запускаете наш скрипт и передаёте в него уникальный индентификатор показа в параметре <code>cnvId</code>. Мы проверяем показ и пишем результаты проверки в базу данных. | На показе вы запускаете наш скрипт и передаёте в него уникальный индентификатор показа в параметре <code>cnvId</code>. Мы проверяем показ и пишем результаты проверки в базу данных. | ||
<!--T:3--> | |||
После того, как случилась конверсия вы шлёте нам постбек с тем же самым уникальным идентификатором. С его помощью мы склеиваем конверсию и проверку показа и выводим результат в статистике. | После того, как случилась конверсия вы шлёте нам постбек с тем же самым уникальным идентификатором. С его помощью мы склеиваем конверсию и проверку показа и выводим результат в статистике. | ||
<!--T:4--> | |||
= Реализация в интеграции типа JS Check = | = Реализация в интеграции типа JS Check = | ||
Добавьте в <code>window.kmnr</code> ключ <code>cnvId</code> с любым удобным для вас уникальным идентификатором. | Добавьте в <code>window.kmnr</code> ключ <code>cnvId</code> с любым удобным для вас уникальным идентификатором. | ||
<!--T:5--> | |||
[[File:Conversion 1.png]] | [[File:Conversion 1.png]] | ||
<!--T:6--> | |||
= Реализация в интеграции типа Meta Redirect = | = Реализация в интеграции типа Meta Redirect = | ||
Добавьте в URL GET-параметр <code>cnvId</code>. | Добавьте в URL GET-параметр <code>cnvId</code>. | ||
<!--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> постбек со следующими параметрами: | На любом типе интеграции после конверсии пришлите нам на URL <code>https://kaminari.click/v1/conversion</code> постбек со следующими параметрами: | ||
<!--T:9--> | |||
<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¤cy=RUB&payout=12</pre> | <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¤cy=RUB&payout=12</pre> | ||
<!--T:10--> | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| Line 53: | Line 63: | ||
|} | |} | ||
<!--T:11--> | |||
= Показ конверсий в статистике = | = Показ конверсий в статистике = | ||
После того, как опция включена и механизм передачи <code>cnvId</code> реализован, в статистике у вас появится метрика '''Conversions / Конверсии'''. С её помощью можно смотреть какие срезы конвертили больше, а какие меньше. Например, мы смотрим срез по '''Sub 5'''. | После того, как опция включена и механизм передачи <code>cnvId</code> реализован, в статистике у вас появится метрика '''Conversions / Конверсии'''. С её помощью можно смотреть какие срезы конвертили больше, а какие меньше. Например, мы смотрим срез по '''Sub 5'''. | ||
<!--T:12--> | |||
[[File:Conversion 2.png]] | [[File:Conversion 2.png]] | ||
<!--T:13--> | |||
Если нажать на значение конверсии, вы попадёте в таблицу, в которой будут только те показы, которые сконвертили. Например, на срезе <code>Sub 5 = 807</code> было четыре конверсии, и мы можем подробно рассмотреть их. | Если нажать на значение конверсии, вы попадёте в таблицу, в которой будут только те показы, которые сконвертили. Например, на срезе <code>Sub 5 = 807</code> было четыре конверсии, и мы можем подробно рассмотреть их. | ||
<!--T:14--> | |||
[[File:Conversion 3.png]] | [[File:Conversion 3.png]] | ||
<!--T:15--> | |||
Чтобы выйти из этого среза и вернуться на предыдущую таблицу, нажмите на стрелку под заголовком колонки '''Conversions'''. | Чтобы выйти из этого среза и вернуться на предыдущую таблицу, нажмите на стрелку под заголовком колонки '''Conversions'''. | ||
</translate> | </translate> | ||
Revision as of 11:45, 9 February 2024
Если вы хотите проверять с нашей помощью конверсии, ask your manager to activate the Conversions option on your integration.
Общий алгоритм работы
На показе вы запускаете наш скрипт и передаёте в него уникальный индентификатор показа в параметре cnvId. Мы проверяем показ и пишем результаты проверки в базу данных.
После того, как случилась конверсия вы шлёте нам постбек с тем же самым уникальным идентификатором. С его помощью мы склеиваем конверсию и проверку показа и выводим результат в статистике.
Реализация в интеграции типа JS Check
Добавьте в window.kmnr ключ cnvId с любым удобным для вас уникальным идентификатором.
Реализация в интеграции типа Meta Redirect
Добавьте в URL GET-параметр cnvId.
https://kaminari.systems/v1/click?kmnrKey=111111111&cnvId=CONVERSION_ID&u=https%3A%2F%2Fsome.url
Постбек
На любом типе интеграции после конверсии пришлите нам на URL https://kaminari.click/v1/conversion постбек со следующими параметрами:
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¤cy=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 | Cтатус конверсии, возможные значения: approved, reject, hold, test |
required |
| currency | Валюта конверсии (RUB, USD, EUR). Полный список возможных значений: ISO 4217 |
optional |
| payout | Стоимость конверсии | optional |
Показ конверсий в статистике
После того, как опция включена и механизм передачи cnvId реализован, в статистике у вас появится метрика Conversions / Конверсии. С её помощью можно смотреть какие срезы конвертили больше, а какие меньше. Например, мы смотрим срез по Sub 5.
Если нажать на значение конверсии, вы попадёте в таблицу, в которой будут только те показы, которые сконвертили. Например, на срезе Sub 5 = 807 было четыре конверсии, и мы можем подробно рассмотреть их.
Чтобы выйти из этого среза и вернуться на предыдущую таблицу, нажмите на стрелку под заголовком колонки Conversions.