Для учёта кликов и их корректной атрибуции на стороне трекинговой системы в кампаниях VK Рекламы используются трекинговые ссылки.
Трекинг-ссылка — это ссылка, при переходе по которой пользователь попадает в магазин приложений для установки приложения или, если приложение уже установлено, открывает его.
Все трекинг-ссылки включают в себя определённые домены и токены ссылки. Кроме того, ссылки также содержат параметры для сбора дополнительных данных о кампании, вовлечённости пользователей, а также для перенаправления пользователей в приложение или в магазин приложений.
Структура ссылки
Пример трекинг-ссылки со значениями:
https://app.appsflyer.com/com.greatapp?pid=mail.ru_int&c=GreatCampaign&af_siteid=A1b1
Общие требования к трекинг-ссылкам
- В ссылке всегда должны быть 3 обязательных параметра:
- pid — идентификатор партнёра Appsflyer
- c — название рекламной кампаний
- af_siteid — уникальный идентификатор паблишера. Другими словами, сайт или приложение, на котором отображается реклама.
Остальные параметры из текущей конфигурации не являются обязательными, и мы их считаем опциональными (необязательными).
- Параметр pid должен всегда иметь значение mail.ru_int.
- У каждого параметра ссылки должен быть свой конкретный макрос. Пример ниже.
https://app.appsflyer.com/{APP_ID}?pid=mail.ru_int&c={{campaign_name}}&af_siteid={{site_id}}&af_c_id={{campaign_id}}&af_adset_id={{banner_id}}&af_click_lookback=30d&clickid={clickid}&sub1=&sub2={{gender}}&sub3={{age}}
- В ссылке не должно быть несколько одинаковых обязательных параметров с разными значениями:
http://app.appsflyer.com/id774652325?af_prt=mobio&c=Mobio_Evolution_iOS_032014_5&af_sub4=87769&af_sub2=1527&af_sub3=5&pid=mail.ru_int&clickid={clickid}&pid=vk_int
Рекламная система не позволит сохранить рекламный баннер, если:
- используется домен, отличный от app.appsflyer.com
- в трекинг-ссылке отсутствуют все или какие-то обязательные параметры
- у обязательных параметров указан неверный макрос или значение
- у обязательных параметров отсутствует значение или макрос
- в трекинг-ссылке встречаются несколько одинаковых обязательных параметров
Требования к обязательным параметрам ссылок
Следующие специальные символы запрещено использовать в названиях всех параметров и их значениях:
;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %
| Параметр | Ограничение |
|---|---|
| pid |
|
| c |
|
| af_siteid |
|
| click_id |
|
Правила валидации трекинг-ссылок для Android-приложений при использованнии Единого дашборда
Если в AppsFlyer вы используется единый дашборд, то для Android-приложений в ссылке обязательно должен быть параметр af_r, который содержит прямую ссылку на приложение в магазине приложений. Эта прямая ссылка также должна быть энкодирована, иначе кабинет не примет её.
Пример трекинг-ссылки для Google Play:
https://app.appsflyer.com/com.miHoYo.GenshinImpact?pid=mail.ru_int&c={{ad_plan_name}}&af_siteid={{site_id}}&af_c_id={{ad_plan_id}}&af_adset={{ad_group_name}}&af_adset_id={{ad_group_id}}&af_ad={{banner_name}}&af_ad_id={{banner_id}}&af_click_lookback=7d&clickid={clickid}&sub1=&sub2={{gender}}&sub3={{age}}&af_r=https%3A%2F%2Fplay.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.miHoYo.GenshinImpact
В трекинг-ссылках для приложений из RuStore параметр af_r должен стоять после связки параметр-макрос pid=mail.ru_int и перед параметром c.
Пример трекинг-ссылки для RuStore:
https://app.appsflyer.com/com.vegetables.happyfarm?pid=mail.ru_int&af_r=https%3A%2F%2Fwww.rustore.ru%2Fcatalog%2Fapp%2Fcom.vegetables.happyfarm&c={{campaign_name}}&af_siteid={{site_id}}&af_c_id={{campaign_id}}&af_adset_id={{banner_id}}&af_click_lookback=30d&clickid={clickid}&sub1=&sub2={{gender}}&sub3={{age}}
Правила валидации трекинг-ссылок для Android-приложений при использованнии Дашборда на каждый магазин
Если в AppsFlyer вы используется Дашборд на каждый магазин, то для Android-приложений в ссылке необязательно должен быть параметр af_r. Параметр af_r может понадобиться в некоторых случаях для приложений из RuStore. Он должен содержать прямую ссылку на приложение в магазине приложений RuStore. Эта прямая ссылка должна быть энкодирована, иначе кабинет не примет её. Параметр af_r также должен стоять после связки параметр-макрос pid=mail.ru_int и перед параметром c.
Пример трекинг-ссылки для RuStore:
https://app.appsflyer.com/com.vegetables.happyfarm-Rustore?pid=mail.ru_int&af_r=https%3A%2F%2Fwww.rustore.ru%2Fcatalog%2Fapp%2Fcom.vegetables.happyfarm&c={{campaign_name}}&af_siteid={{site_id}}&af_c_id={{campaign_id}}&af_adset_id={{banner_id}}&af_click_lookback=30d&clickid={clickid}&sub1=&sub2={{gender}}&sub3={{age}}
Если ваш аккаунт в AppsFlyer открыт через аккаунт агентства, то проверьте, чтобы в трекерной ссылке был проставлен параметр af_prt со значением названия агентства. В автоматически сформированных трекерных ссылках этот параметр проставляется автоматически.