Latest revision as of 03:09, 28 January 2025

Other languages:

English
русский

Если вы хотите проверять с нашей помощью конверсии, включите опцию Conversions на своей интеграции

Общий алгоритм работы

На показе вы запускаете наш скрипт и передаёте в него уникальный индентификатор показа в параметре 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.systems/v1/conversion постбек со следующими параметрами:

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	Уникальный идентификатор конверсии	обязательный
kmnrKey	Идентификатор интеграции	обязательный
sub1	Метки, отправленные нам на показе	необязательный
sub2	...	необязательный
sub3	...	необязательный
sub4	...	необязательный
sub5	...	необязательный
sub6	...	необязательный
sub7	...	необязательный
status	Cтатус конверсии, возможные значения: `l1`, `l2`, `l3`, `l4`	обязательный
currency	Валюта конверсии (`RUB`, `USD`, `EUR`). Полный список возможных значений: ISO 4217	необязательный
payout	Стоимость конверсии	необязательный

Показ конверсий в статистике

После того, как опция включена и механизм передачи cnvId реализован, в статистике у вас появится метрика Conversions / Конверсии. С её помощью можно смотреть какие срезы конвертили больше, а какие меньше. Например, мы смотрим срез по Sub 5.

Если нажать на значение конверсии, вы попадёте в таблицу, в которой будут только те показы, которые сконвертили. Например, на срезе Sub 5 = 807 было четыре конверсии, и мы можем подробно рассмотреть их.

Чтобы выйти из этого среза и вернуться на предыдущую таблицу, нажмите на стрелку под заголовком колонки Conversions.

@@ Line 1: / Line 1: @@
 <languages/>
-Если вы хотите проверять с нашей помощью конверсии, закажите у менеджера включение опции '''Conversions''' на своей интеграции
+Если вы хотите проверять с нашей помощью конверсии, включите опцию '''Conversions''' на своей интеграции
 = Общий алгоритм работы =
@@ Line 18: / Line 18: @@
 = Постбек =
-На любом типе интеграции после конверсии пришлите нам на URL <code>https://kaminari.click/v1/conversion</code> постбек со следующими параметрами:
+На любом типе интеграции после конверсии пришлите нам на URL <code>https://kaminari.systems/v1/conversion</code> постбек со следующими параметрами:
-<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>
+<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>
 {| class="wikitable"
@@ Line 44: / Line 44: @@
 | sub7 || ... || необязательный
 |-
-| status || Cтатус конверсии, возможные значения: <code>approved</code>, <code>reject</code>, <code>hold</code>, <code>test</code>  || '''обязательный'''
+| status || Cтатус конверсии, возможные значения: <code>l1</code>, <code>l2</code>, <code>l3</code>, <code>l4</code>  || '''обязательный'''
 |-
 | currency || Валюта конверсии (<code>RUB</code>, <code>USD</code>, <code>EUR</code>). Полный список возможных значений: [https://www.xe.com/iso4217.php ISO 4217] || необязательный