Conversions: Difference between revisions
| Line 25: | Line 25: | ||
! 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 43: | ||
| sub7 || ... || optional | | sub7 || ... || optional | ||
|- | |- | ||
| status || Cтатус конверсии, возможные значения: <code>approved</code>, <code>reject</code>, <code>hold</code>, <code>test</code> || required | | status || Cтатус конверсии, возможные значения: <code>approved</code>, <code>reject</code>, <code>hold</code>, <code>test</code> || '''required''' | ||
|- | |- | ||
| currency || Валюта конверсии (<code>RUB</code>, <code>USD</code>, <code>EUR</code>). Полный список возможных значений: [https://www.xe.com/iso4217.php ISO 4217] || optional | | currency || Валюта конверсии (<code>RUB</code>, <code>USD</code>, <code>EUR</code>). Полный список возможных значений: [https://www.xe.com/iso4217.php ISO 4217] || optional | ||
Revision as of 11:36, 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.
