VK Реклама

Серверная интеграция с кабинетом VK Реклама (бывшая myTarget). VK Реклама подставляет макросы в клик-ссылку, Tracehub отправляет постбэки на адреса VK Рекламы вида https://r.my.com/external/customtracker* — эти адреса задаёт VK Реклама, они едины для всех рекламодателей.

Подключение трекера

Перед запуском кампаний кабинет VK Реклама требует заявку на подключение трекера. В заявке указываются:

Поле	Значение
Название трекера	Tracehub
Описание	Сценарий использования
Шаблон клик-ссылки	См. раздел «Клик-ссылка»
Шаблон view-ссылки	Те же макросы, что и у клик-ссылки
IP-адреса для постбэков	Адреса, с которых Tracehub отправляет постбэки, — выдаёт поддержка Tracehub по запросу

Шаблоны клик-ссылки и ссылки показа возьмите из разделов «Клик-ссылка» и «Ссылка показа» ниже, подставив токен своей трекинг-ссылки. Список IP-адресов запросите в поддержке Tracehub — публично он не публикуется.

Клик-ссылку можно ставить в креативы после одобрения заявки.

Адрес постбэка VK Рекламы задан платформой

Постбэки уходят на общий адрес VK Рекламы — он единый для всех рекламодателей и в карточке источника не редактируется. Если ваш рекламный кабинет принимает конверсии только на персональный адрес из ответа на заявку, напишите в поддержку Tracehub.

Клик-ссылка

VK Реклама заполняет макросы автоматически в момент показа. Минимальная форма ссылки:

https://links.tracehub.ru/l/{tracker_token}
  ?vk_click_id={clickid}
  &vk_sha1_idfa={sha1_idfa}
  &vk_gaid_sha1={gaid_sha1}

Используйте имя параметра из списка

Идентификатор клика VK Рекламы распознаётся только в параметре vk_click_id — написания vk_clickid и click_id не подойдут. С другим именем постбэк уйдёт с пустым clickid, а установка попадёт в органику. Проверьте имя параметра в трекинг-ссылке до запуска кампании.

Параметры vk_sha1_idfa / vk_gaid_sha1 входят в шаблон, потому что их требует форма заявки VK Рекламы. Атрибуция VK Рекламы выполняется по vk_click_id — именно его наличие в ссылке и нужно проверять.

Макросы VK Рекламы (клик и показ)

Макрос	Описание
{clickid}	Уникальный ID клика на стороне VK
{sha1_idfa}	IDFA, SHA1 — рекомендуется вместо {idfa}
{gaid_sha1}	GAID, SHA1 — рекомендуется вместо {gaid}
{idfa}	IDFA (iOS) в открытом виде — нежелателен в публичных URL
{gaid}	GAID (Android) в открытом виде — нежелателен в публичных URL
{sha1_android_id}	Android ID, SHA1
{sha1_device_id}	Device ID, SHA1
{tnsdid}	TNS Device ID
{pad_id}	Идентификатор площадки
{sitename}	Название сайта или приложения
{product}	Продукт
{advertiser_id}	ID рекламодателя
{campaign_id}	ID кампании
{campaign_name}	Название кампании
{banner_id}	ID креатива (баннера)
{geo}	Геолокация (страна/регион)
{random}	Случайное число
{timestamp}	Время показа рекламы (UNIX timestamp)
{user_timezone}	Часовой пояс пользователя
{impression_weekday}	День недели показа (0 = вс, 6 = сб)
{impression_hour}	Час показа (локальное время)
{impression_id}	Уникальный ID показа
{location}	Местоположение пользователя
{search_phrase}	Поисковая фраза
{tps_client_id}	TPS client ID
{users_list_client_ids}	Список client_id из списка пользователей

В шаблоне пресета зафиксированы {clickid} и хэшированные идентификаторы устройства. Остальные макросы — по желанию: их можно добавить в клик-ссылку вручную, имена URL-параметров для них произвольные.

Постбэки

Общие правила VK Рекламы:

• Идентификаторы устройства передаются в открытом виде. Если в клик-ссылке пришёл только SHA1-хэш, отправляется это же значение — VK Реклама допускает оба варианта.
• Параметры именуются строго: clickid, idfa, advertising_id, android_id, event_name.
• Постбэки отправляются только с IP-адресов, заранее переданных VK Рекламе в заявке.

Постбэк установки

https://r.my.com/external/customtracker
  ?clickid=<CLICKID>
  &idfa=<IDFA>
  &advertising_id=<GAID>
  &android_id=<ANDROID_ID>

Ключ	Описание
clickid	ID клика — значение vk_click_id из клик-ссылки
idfa	Идентификатор устройства (iOS)
advertising_id	Идентификатор устройства (Android, GAID)
android_id	Android ID — резервный идентификатор, когда GAID недоступен

Tracehub заполняет все три параметра идентификатора одним и тем же значением — идентификатором устройства установки. Это согласовано с VK Рекламой: матчинг идёт по clickid и значению идентификатора, дубли безвредны.

Постбэк события

https://r.my.com/external/customtracker_event
  ?clickid=<CLICKID>
  &idfa=<IDFA>
  &advertising_id=<GAID>
  &android_id=<ANDROID_ID>
  &event_name=<EVENT_NAME>

Обязательный дополнительный параметр — event_name: сетевое имя события, выбранное на карточке источника во вкладке «Постбэки» (см. страницу Постбэки).

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

Рекомендуемые значения event_name:

addToCart, purchase, login, registration, subscription, userLevel,
unlockAchievement, userStatus, transactionConfirmation, beginCheckout,
addToWishlist, customEvent

Соответствие задаётся в Tracehub на карточке источника во вкладке «Постбэки»: для типовых событий подставляется подсказка (purchase → purchase, add_to_cart → addToCart, level_up → userLevel), остальным имя выбираете из списка вручную. Менять код приложения не требуется — в кабинете VK Рекламы события с этими именами сопоставляются с целями оптимизации.

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

• HTTP 200 OK — единственный успешный код.
• 403 — запрос с неизвестного IP, 404 — неверный URL; оба считаются ошибками доставки.
• Постбэки принимаются только с IP-адресов, заранее переданных VK Рекламе при заявке на интеграцию.

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

VK Реклама поддерживает view-ссылки (учёт показов) с тем же набором макросов, что и клик-ссылка. Шаблон view-ссылки подаётся вместе с заявкой на подключение трекера.

---