Интеграция и настройка

1. Что требуется от клиента для интеграции?

   • Настроить постбеки обратно на нас по инструкции Keitaro, Binom. В трекере нужно добавить наш postback-URL и передавать обязательные параметры, например click_id и event, чтобы мы могли фиксировать конверсии.
   • После этого мы присвоим вам идентификатор, например OMA, который вы всегда будете вставлять в sub1. OMA — это закреплённый за вами идентификатор, его нельзя менять.
   • В sub2 необходимо прописать ID вашей кампании в трекере.
   • sub3, sub4 и далее — любые параметры на ваше усмотрение: GEO, приложение, баер и т.д.

   Нейминг должен выглядеть так: OMA_ID_sub3_sub4_sub5_sub6_sub7_sub8.

   <aside> ❗

   Важно: должно быть одно подчеркивание между частями. Пример неверно: __. Пример верно: _.

   </aside>

2. Как подключить постбеки?

   Нужно в настройках трекера или источника трафика указать наш URL постбека (S2S postback) и обеспечить передачу обязательных параметров. Минимум: уникальный идентификатор клика (click_id или external_id) и событие (event). При каждом целевом действии (установка, покупка и т.п.) источник данных (например, MMP вроде AppsFlyer или Adjust) должен вызывать наш постбек URL, подставив соответствующие значения параметров.

3. Как можно передавать параметры в трекер (варианты ссылок)?

   Существует два способа интеграции ссылки в трекере:

   • Статический URL — когда ID кампании зашит в ссылку. Пример шаблона:

     https://yourDomain.com/YourCompanyId?external_id={subid}&sub2={sub2}&sub3={sub3}

     Здесь YourCompanyId — фиксированный идентификатор (например, код кампании XXX), {subid} — placeholder для уникального click ID из трекера, {sub2}, {sub3} и т.д. — дополнительные параметры, которые трекер подставит.

   • Динамический URL — когда идентификатор кампании передаётся как переменная. Пример шаблона:

     https://yourDomain.com/{sub2}?external_id={subid}&sub3={sub3}

     В этом случае {sub2} в пути URL должно динамически подставляться вашим трекером или источником. Удобно при работе с несколькими кампаниями или приложениями.

4. Как передать параметр external_id?

   external_id используется для передачи уникального идентификатора клика до MMP/приложения. Если в настройках трекера или MMP нет отдельного поля для External ID, добавьте его в ссылку вручную. Например:

   https://yourDomain.com/{sub2}?external_id={subid}&sub3={sub3}

   Здесь {subid} подставится трекером (Keitaro/Binom) как уникальный идентификатор клика. Убедитесь, что именно этот идентификатор затем возвращается в постбеке при конверсии. В Keitaro ключ external_id по умолчанию хранит внешний ID клика и поможет связать конверсию с конкретным кликом в цепочке MMP → Onmyads → трекер.

5. Какие параметры можно собирать дополнительно?

   Можно передавать любые полезные параметры, которые нужно трекать. Например:

   • &device={device} для типа устройства
   • &country={country} для гео
   • &campaign={campaign_id} для ID кампании источника

   Эти данные обычно передаются через токены источника трафика и кладутся в свободные sub-поля (sub2…sub8).

6. Где взять названия токенов/параметров для трекинга?

   Названия макросов зависят от источника трафика. Посмотрите в интерфейсе вашего рекламного источника или в справке по интеграции с трекером. В Keitaro при создании «Источник трафика» можно выбрать шаблон, и трекер автоматически подставит правильные параметры.

7. Какие события можно передавать постбеком?

   Любые заранее согласованные события: install, purchase, registration и т.д. В параметре события (event или аналогичном) передавайте точное название. Перед интеграцией уточните у команды Onmyads, какие ивенты целевые для оплаты. Можно передавать несколько типов событий, главное — чтобы они были настроены и согласованы.

8. Обязателен ли постбек для работы?

   Да, обязателен. Без настроенного постбека система Onmyads не получит данные о конверсиях и не сможет корректно рассчитать выплаты. Без S2S‑трекинга запуск невозможен.

9. Как передавать идентификатор рекламной кампании?

   ID или название кампании из источника трафика можно передать в одном из sub‑параметров при клике. Обычно используют sub2. Пример: sub2={campaign_id}. Параметр сохранится и позволит связывать конверсии с кампанией в статистике.

10. Нужно ли передавать app_id?

    • Если ведёте трафик на несколько приложений, обязательно передавайте app_id при каждом клике. Можно как отдельным параметром &app_id=XYZ, так и в один из sub‑параметров.
    • Если кампания и ссылка привязаны к одному приложению, app_id может не потребоваться.

Проверка работы и отладка

1. Как узнать, что постбек сработал?

   В статистике кампании появится событие.

2. Как проверить правильность постбека?

   Отправьте тестовое событие из источника трафика и убедитесь, что оно есть в статистике.

3. Что делать, если постбек не срабатывает?

   Проверьте URL, параметры и саму отправку событий.

4. Что делать, если в статистике нет событий?

   Проверьте обязательные параметры (click_id, event) и возможные ошибки в URL.

5. Можно ли проверить данные через MMP (AppsFlyer)?

   Да. Можно запросить статистику с click_id.

6. Почему в трекере не отображаются клики?

   Проверьте настройки и нейминг кампании.

7. Какие клики должны отображаться?

   Все клики, даже без конверсий.