Яндекс Директ

Серверная интеграция с рекламным кабинетом Яндекс Директа по продукту App Tracking. Директ подставляет макросы в клик-ссылку, Tracehub отправляет постбэки на https://postback.yandex.net/postback.

Подключение

Источник подключается из каталога: Источники → Каталог → Яндекс Директ. Пресет заполняет адрес постбэка и макросы автоматически; секрет аутентификации pass-phrase — секрет платформы, Tracehub подставляет его сам, вводить ничего не нужно.

Клик-ссылка

https://links.tracehub.ru/l/{tracker_token}
  ?yclid={logid}
  &gps_adid={google_aid}
  &idfa={ios_ifa}
  &oaid={oaid}
  &android_id={android_id}
  &campaign_id={campaign_id}
  &adgroup_id={gbid}
  &creative_id={ad_id}

Макросы клика

Обяз.	Параметр	Макрос Директа	Описание
✓	`yclid`	`{logid}`	ID клика в Яндекс Директе
✓	`gps_adid`	`{google_aid}`	Google Advertising ID
✓	`idfa`	`{ios_ifa}`	Identifier for Advertisers (iOS)
	`oaid`	`{oaid}`	Open Advertising ID (HMS)
	`android_id`	`{android_id}`	ANDROID_ID, универсальный резервный идентификатор
	`campaign_id`	`{campaign_id}`	ID кампании сети
	`adgroup_id`	`{gbid}`	ID группы объявлений
	`creative_id`	`{ad_id}`	ID объявления

Постбэк

Один URL на все события — различается только значение параметра event.

https://postback.yandex.net/postback
  ?reqid=<CLICKID>
  &package-name=<BUNDLE_ID>
  &idfa=<IDFA>
  &google-ad-id=<GAID>
  &os=<android|ios>
  &click-time=<UNIX_SECONDS>
  &install-time=<UNIX_SECONDS>
  &event-time=<UNIX_SECONDS>
  &event=<INSTALL_APP|PURCHASED|...>
  &is-attributed=<0|1>
  &is-impression=<0|1>
  &tracker=tracehub
  &pass-phrase=<SECRET>

Обязательные параметры

Ключ	Описание
`reqid`	ID клика — значение `yclid` из клик-ссылки
`package-name`	Bundle ID (iOS) или package name (Android)
`os`	`ios` или `android`
`click-time`	Время клика, UNIX-секунды
`install-time`	Время установки, UNIX-секунды
`event-time`	Время события, UNIX-секунды
`event`	`INSTALL_APP` для установки, иначе значение из перечня ниже
`is-attributed`	1 / 0
`is-impression`	1 / 0
`tracker`	Константа `tracehub`
`pass-phrase`	Секрет аутентификации

Необязательные параметры

package-version, idfv, oaid, app-user-agent, app-client-ip, device-manufacturer, device-model, device-type, os-version, event_type, orig-event-name, event-value (JSON), revenue, currency, transaction-id, ya-app-id, ecom_feed_counter_id.

Перечень событий

Директ принимает только значения из своего перечня:

INSTALL_APP, ACHIEVED_LEVEL, APP_LAUNCHED, ADDED_PAYMENT_INFO,
ADDED_TO_CART, ADDED_TO_WISHLIST, COMPLETED_REGISTRATION,
COMPLETED_TUTORIAL, INITIATED_CHECKOUT, PURCHASED, RATED, SEARCHED,
SPENT_CREDITS, UNLOCKED_ACHIEVEMENT, VIEWED_CONTENT, SPENT_TIME_IN_APP,
SHARED, EVENT_1, EVENT_2, EVENT_3

Автоматического сопоставления на стороне Директа нет. Соответствие задаётся в Tracehub на карточке источника во вкладке Постбэки: для типовых событий подставляется подсказка (purchase → PURCHASED, registration → COMPLETED_REGISTRATION, add_to_cart → ADDED_TO_CART), событию вне перечня достаются свободные слоты EVENT_1–EVENT_3. Подробнее — см. страницу Постбэки.

Правила приёма

HTTP 200 OK — единственный успешный код. Любой другой статус считается ошибкой доставки.
Постбэки принимаются только с IP-адресов, заранее переданных Яндекс Директу при заявке на интеграцию.
pass-phrase обязателен — без него постбэк отбрасывается молча.

Ссылка показа

Показ-ссылка несёт только идентификаторы устройства:

https://links.tracehub.ru/imp/{tracker_token}
  ?app_token=<APP_TOKEN>
  &gps_adid={google_aid}
  &oaid={oaid}
  &android_id={android_id}