Трекеры приложений в VK Рекламе: ссылки, макросы и параметры по каждому трекеру

Общее для всех трекеров

• Для postview-атрибуции используют те же ссылки, что и для postclick. Отдельные трекеры и ссылки под показы не заводят, поддержка заложена в интеграции трекера с VK Рекламой. Это написано на страницах MyTracker, AppMetrica, AppsFlyer, Adjust, Tenjin и Singular.
• Трекинг-ссылка ведёт человека в магазин приложений, а если приложение уже стоит, открывает его. В ней есть домен, токен ссылки и параметры для данных о кампании, вовлечённости и перенаправления.
• В кабинет вставляют именно ссылку клика: у MyTracker это ссылка для подсчёта кликов, у Adjust — Click URL, у AppsFlyer — Click attribution link, у Singular — Click-through tracking link.
• Кабинет не даст сохранить баннер, если домен не из списка, нет всех или части обязательных параметров, у параметра неверный макрос или значение, нет значения или макроса, либо один обязательный параметр повторён с разными значениями.
• Если в ссылке есть параметр со значением, начинающимся с =https://, ссылку в этом параметре экранируют, готовый вариант берут в трекере. Пример из справки: https://app.adjust.com/2h8nx0?campaign=RU&adgroup={{geo}}&creative=1190_{{banner_id}}_{{gender}}_{{age}}&install_callback=https%3A%2F%2Fpostback.plarin.net%2Fw1fqoFCxyvvqEopfdKrutefs%3Fg1%3D{{banner_id}}%26g1_value%3D69%26currency%3Drub%26tracker_limit%3D100000
• Макросы из таблицы выше дают данные для оптимизации кампаний, про передачу других параметров смотрят справку своего трекера.
• SDK трекера встраивают в приложение заранее: это названо на страницах MyTracker, AppMetrica, AppsFlyer, Adjust, Branch и Tenjin. Добавить приложение в кабинет трекера заранее просят MyTracker, Adjust, Branch и AppsFlyer.

Партнёр в трекере и куда вставляют код приложения

Код приложения есть в разделе «Мобильные приложения» кабинета VK Рекламы. Он нужен один раз, чтобы подтвердить владение приложением. Статус владельца появляется, когда VK Реклама получает постбек с этим кодом.

MyTracker

• Перед настройкой: приложение добавлено в кабинет MyTracker, встроен MyTracker SDK.
• Подключение: «Партнеры» → «VK Ads + MyTarget» → вкладка «Отправка событий» → выбрать приложение → вставить код в «App ID» → выбрать стандартные события и режим их отправки. Событие «Установка» MyTracker передаёт сам, в списке его нет.
• Ссылка: «Кампании» → «Добавить» или «+» рядом с пунктом «Кампании» → заполнить обязательные поля, в списке «Партнер» выбрать «VK Ads + myTarget» → на вкладке «Трекинг-ссылки» указать название, приложение и целевую ссылку → «Добавить» → скопировать ссылку для подсчёта кликов.
• Целевая ссылка зависит от платформы и магазина. В требованиях сказано указывать ссылку на конкретный магазин: Google Play, RuStore, AppGallery, App Store.
• Окно VTA ограничивают при создании ссылки: на этапе создания трекера задают значения окон атрибуции для этой ссылки. Сами значения справка не называет.
• Пример ссылки: https://trk.mail.ru/c/m2ckw3?mt_sub3={{banner_id}}&mt_sub4={{campaign_id}}&mt_sub5={{ad_plan_id}}&mt_campaign={{ad_plan_name}}&mt_adset={{campaign_name}}

AppMetrica

• Интеграция в два этапа: встроить AppMetrica SDK в приложение, затем настроить трекинг в кабинете AppMetrica.
• При создании трекера AppMetrica сама добавляет постбек на событие «Установка». Он обязателен и не редактируется, в него нельзя добавить mt_app_id. Поэтому создают ещё один постбек на «Установка» и вносят в него mt_app_id с кодом приложения. После подтверждения владения дублирующий постбек удаляют.
• Трекер для установки: «Трекинг» → «Создать трекер» → в «Описание кампании» название, приложение, партнёр VK Ads (ex. myTarget) → в «Настройка целевой ссылки» платформа Android или iOS → в «Настройка постбеков» в списке «Получатель постбека» выбрать «VK Ads (ex. myTarget)», в поле «Событие» выбрать «Установка» → шаблон Install_postback, в конец добавить &mt_app_id= и код приложения → сохранить, скопировать ссылку и использовать в объявлении.
• Трекер для события внутри приложения: те же шаги, но в поле «Событие» выбирают «Событие», а в списке «Событие» — то, на которое оптимизируют рекламу. Шаблон Event_postback, в конец тоже &mt_app_id= с кодом. Для каждого события делают отдельный трекер.
• Чекбокс «Отправлять постбек только для первого целевого события» настоятельно рекомендуют выключить, так реклама оптимизируется лучше.
• Чтобы модель обучалась на неатрибутированных установках и событиях, делают копии постбеков установки и целевых событий и включают чекбокс «Отправлять постбек по действиям всех пользователей».
• Ссылка для postview-атрибуции создаётся автоматически при создании трекера. Окно VTA ограничивают настройками при создании ссылки, подробности — в справке AppMetrica.
• Пример ссылки: https://redirect.appmetrica.yandex.com/serve/1234?click_id={clickid}&pid=mail.ru_int&gender={{gender}}&age={{age}}&c={{campaign_id}}&banner_id={{banner_id}}

Пример постбек-ссылки начинается с https://r.my.com/external/yandex и содержит такие параметры.

AppsFlyer: подключение

• Перед настройкой приложение добавляют в AppsFlyer и встраивают SDK AppsFlyer.
• Путь: «Сотрудничество» → «Маркетплейс партнеров» при первом подключении или «Сотрудничество» → «Активные интеграции» для изменений. Найти партнёра VK Ads (myTarget, Mail.ru), в управлении интеграцией поставить «Активировать партнера» в положение «Включено». Переключатель держат включённым всё время работы с VK Рекламой.
• В поле «App id» вставляют код приложения из VK Рекламы, он нужен один раз.
• В секции Default postbacks включают отправку события Install. Для лучшей эффективности рекомендуют вариант All media sources, including organic и передачу Install с view-through атрибуцией.
• В секции In-app event settings код из VK Рекламы вставляют в «App id» ещё раз.
• Чтобы оптимизировать рекламу на события внутри приложения, включают In-app events postback и настраивают In-app события. Рекомендуют в Sending options выставить All media sources, including organic, в Send revenue — Values and revenue, и включить передачу событий с view-through атрибуцией.
• В ссылке In-app events postback параметр af_siteid приводят к виду af_siteid = {{site_id}}.
• Формируют и сохраняют трекинговую ссылку, затем кнопка Save Integration. Ссылки OneLink в VK Ads не поддерживаются, для ретаргетинга берут стандартные ссылки атрибуции.
• Окна атрибуции задают параметрами в ссылке: af_click_lookback={значение}d для post-click и af_viewthrough_lookback={значение}h для post-view. Параметр для post-view добавляют в ту ссылку, что используется в кабинете VK Рекламы. Без них действуют значения по умолчанию: 7 дней и 24 часа.

AppsFlyer: ссылка и параметры

• Пример ссылки с окнами атрибуции: https://app.appsflyer.com/yourbestapp?pid=mail.ru_int&c={{campaign_name}}&af_siteid={{site_id}}&af_c_id={{campaign_id}}&af_adset_id={{banner_id}}&clickid={clickid}&sub1=&sub2={{gender}}&sub3={{age}}&af_viewthrough_lookback=12h&af_click_lookback=20d
• Обязательных параметров три, остальные опциональны. У каждого параметра свой конкретный макрос. Два одинаковых обязательных параметра с разными значениями в ссылке недопустимы (в примере ошибки pid повторён как mail.ru_int и vk_int).
• Запрещённые символы в названиях и значениях параметров: точка с запятой, звёздочка, восклицательный знак, @, решётка, вопросительный знак, доллар, каретка, двоеточие, амперсанд, тильда, обратная кавычка, равно, плюс, апостроф ’, больше, меньше, косая черта, обе фигурные скобки и процент.
• Для Android при едином дашборде обязателен параметр af_r с энкодированной прямой ссылкой на приложение в магазине, без энкодирования кабинет ссылку не примет.
• Для RuStore af_r ставят после pid=mail.ru_int и перед параметром c.
• При дашборде на каждый магазин af_r необязателен; для приложений из RuStore он может понадобиться, правила те же: энкодированная прямая ссылка на RuStore и место после pid и перед c.
• Если аккаунт AppsFlyer открыт через агентский, в ссылке должен стоять параметр af_prt с названием агентства. В автоматически созданных ссылках он ставится сам.
• Примеры af_r: для Google Play — af_r=https%3A%2F%2Fplay.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.miHoYo.GenshinImpact; для RuStore — af_r=https%3A%2F%2Fwww.rustore.ru%2Fcatalog%2Fapp%2Fcom.vegetables.happyfarm.

AppsFlyer: несколько магазинов Android

• Для приложений Android в нескольких магазинах есть два режима: единый дашборд (Single dashboard) с данными всех магазинов или отдельный дашборд на магазин (Dashboard per store, он же Multi-dashboard, multidash). В каждом режиме по-своему настраивают имя пакета (package name) и af_store в APK, детали — в справке трекера.
• При едином дашборде в трекерную ссылку добавляют af_r.
• При дашборде на каждый магазин для Google Play имя канала не задают. Для альтернативных магазинов в параметре «Имя канала» пишут rustore для RuStore и appgallery для AppGallery.
• В разделе «Out-of-store app URL» указывают ссылку на приложение в каталоге RuStore или AppGallery, пример https://www.rustore.ru/catalog/app/com.vkontakte.android.
• Домен rustore.ru добавляют в список разрешённых для редиректа доменов (redirect allowlist).

AppsFlyer: передача расходов

• Траты передаются через InCost API, включением и выключением управляет сам рекламодатель. После настройки VK Реклама в интерфейсе AppsFlyer получает значок «Стоимость».
• Функцию надо включить с двух сторон: в VK Рекламе и в AppsFlyer. Если включить только в одном продукте, передача не работает.
• В AppsFlyer: меню «Integrated Partners» → вкладка «Cost» → переключатель «Get cost data». В агентском аккаунте владелец приложения должен выдать права на передачу.
• В VK Рекламе: «Мобильные приложения» → «Настройки» в строке приложения → вкладка «События» → на баннере «Включить» → «Передать расходы». Передача доступна только для приложений с подключённым AppsFlyer.
• Если траты уходят в агентский кабинет AppsFlyer, отмечают «У меня агентский кабинет AppsFlyer» и указывают название агентства (параметр af_prt).
• Вводят уникальный идентификатор приложения из AppsFlyer. При отдельном дашборде на магазин нужен полный идентификатор с именем канала, пример com.abc.def-rustore.
• Выключают передачу кнопкой «Отключить» на баннере той же вкладки «События».
• Данные идут каждый день за предыдущие 7 дней с момента включения, включая текущий. Пример: кампания запущена 1 января, траты включены 20 января — в этот день видны 14–20 января, 27 января — 21–27 января. Траты старше 7 дней передать нельзя, например 27 января за 19 января.

AppsFlyer: AAP и агентства

• Aggregated Advanced Privacy (AAP) — метод атрибуции, при котором трекер отдаёт результаты в агрегированном виде. Он используется для устройств Apple с iOS 14.5 и новее и включается в трекере.
• VK Реклама поддерживает обычные (regular) постбеки и AAP-постбеки, часть полей в AAP ограничена. Передачу AAP включают на уровне приложения в трекере, иначе в кабинете не отобразятся атрибуцированные установки. Тогда метрики в AppsFlyer и VK Рекламе совпадают.
• AppsFlyer ввёл предварительное одобрение агентских аккаунтов: VK Реклама должна одобрить значение af_prt из трекинг-ссылок. Чтобы добавить агентство в список авторизованных, представители обращаются к своему менеджеру.
• С 14 июля 2024 года AppsFlyer регистрирует и измеряет трафик только от агентств, авторизованных рекламными сетями.

Adjust

• Перед настройкой: приложение добавлено в кабинете Adjust, встроен Adjust SDK.
• Создание ссылки: на плитке "Campaign Lab" кнопка "New Partner" → партнёр VK Ads (ex. myTarget) → "Next" → приложение → передача данных: "Edit" в блоке "Enable data sharing for VK Ads (ex. myTarget)" → переключатель "Enabled" → код приложения в поле APP ID → название ссылки → "Next" → куда вести людей, у которых приложение установлено или нет → настройки атрибуции по умолчанию, их можно менять → "Create Link" → скопировать Click URL.
• Окно VTA: при создании ссылки кнопка Edit в блоке Impression.
• Передача расходов возможна только для кабинетов клиентов агентств. В Adjust: раздел DataWorks → «Подключения» → «Новое подключение» → партнёр VK Ads (ex. MyTarget) → услуга «Ad Spend» → «Подключить». В VK Рекламе: выбрать аккаунт клиента, которому дают доступ, выбрать имя клиента для передачи расходов (за подключение только 1 клиент), подтвердить доступ.
• Для приложений из RuStore в ссылке обязателен параметр redirect с прямой ссылкой на RuStore. В примере справки там старый адрес https://apps.rustore.ru, его рекомендуют заменить на https://www.rustore.ru.
• Пример ссылки: https://app.adjust.com/abc123?campaign=Example_CampaignName&adgroup=Example_AdGroupName&creative=Example_CreativeID&mytarget_click_id={clickid}

Branch

• Перед настройкой: приложение добавлено в кабинете Branch, встроен Branch SDK.
• Подключение партнёра: страница Ads → раздел Partner Management в боковом меню → выбрать партнёра MyTarget и сохранить.
• Основные постбэки, например на установку, появляются автоматически.
• Ссылка: на основном дашборде кнопка «Create» → в окне «App Install or Engagement» → настроить ссылку по требованиям.
• Пример ссылки: https://lr.app.link/kUVn9QPWuob?%243p=a_mytarget&~campaign={campaign_name}&~campaign_id={campaign_id}&cod=BRC00152392RU&~ad_name={banner_name}&~ad_id={banner_id}&impression_install_window_days=1&impression_session_start_window_days=1&impression_conversion_window_days=30
• Параметры impression_install_window_days=1, impression_session_start_window_days=1, impression_conversion_window_days=30 стоят в этом примере, страница их не поясняет.
• Пример постбэка на установку идёт на адрес https://r.vk.ru/external/branch_install.

Tenjin

• Перед настройкой встраивают SDK Tenjin.
• В Tenjin: вкладка Apps → нужное приложение → блок Callbacks → New callback → в поиске слева (Callback name) найти VK → в поле VK App ID ввести APP ID из кабинета VK Рекламы → сохранить коллбек.
• Чтобы получить APP ID: раздел «Мобильные приложения» → найти приложение → «Посмотреть код» → скопировать код из окна.
• Кампания: Configure → Campaigns → Create Campaign → Marketing Accounts — VK ADS, Apps — нужное приложение, Name — имя кампании → Create Campaign.
• Окно VTA ограничивают при создании ссылки, значения не названы.
• Пример ссылки: https://track.tenjin.io/v0/click/ddzoxkVVbvHZOWyHvly7AK?click_id={clickid}&advertising_id={gaid}

Singular

• Шаг 1, добавить VK Рекламу: Attribution → Partner configuration → Add Partner → ввести VKADS → в полях App выбрать приложение, в Site — адрес сайта → Save.
• Шаг 2, настроить трекинг: Partner Configuration → VKADS → значок карандаша. В Postback Key добавить значение параметра postback_key. В Click-through attribution lookback window выбрать период, в течение которого система отслеживает клик, после которого установили приложение. В Install Postbacks выбрать целевое действие, по умолчанию Install. В Event Postbacks значение Event Name должно совпадать с разделом «Действия» в аккаунте VKADS (Программа → Действия → столбец InApp event). При необходимости настроить postback-ссылку: изменить название целевого действия в параметре tracking, если к нему добавили идентификатор, или добавить параметр price для суммы покупки. Значок настроек — справа в блоке Event Postback section. Затем Done.
• Шаг 3, ссылка: Attribution → Manage Links → VKADS (если раздел пуст, включить Show Legacy Links) → поля Link Type — Partner, Source Name — VKADS, Tracking Link Name — VKADS Tracking Link.
• В блоке Link Settings and Redirects включают отслеживание действий в приложении для Android и/или iOS. В поле If the app is not installed go to указывают ссылку на Google Play или App Store, если включены обе опции — обе ссылки.
• В блоке Attribution settings можно включить отслеживание повторного использования приложения для действующих пользователей (re-engagement), если нужны все действия, и обязательно задать срок жизни cookie в блоке Click-through deterministic install.
• В блоке Link Summary копируют ссылку из поля Click-through tracking link и нажимают Done.
• Окно VTA ограничивают при создании ссылки, значения не названы.
• Пример ссылки с обязательными параметрами: https://c.singular.net/api/v1/ad?st=969569908367&andi={gaid}&aifa={gaid}&s={affiliate_id}&idfa={idfa}&cl={{clickid}}&pcn={{ad_plan_name}}&pcid={{ad_plan_id}}&pscn={{campaign_name}}&pscid={{campaign_id}}&pcrid={{banner_id}}&pcrn={{banner_name}}
• Пример postback-ссылки: https://ad.VKADS.com/r?pk={{p_k}}&uid={cl?VKADS}&oid={UTCM}&tracking=confirmed_purchase&device={ANDI}&client_id={AIFA}&price={AMOUNT}

Huawei AppGallery

• Заранее: настроить интеграцию с трекером (добавить приложение в трекер и создать ссылку, инструкции есть для myTracker, Adjust, AppMetrica, AppsFlyer), добавить приложение в кабинет VK Рекламы, подтвердить статус владельца или получить доступ.
• Добавить приложение в кабинет: раздел «Мобильное приложение» → «Добавить приложение» → ввести ссылку на приложение.
• Подтверждение владения: после добавления приложения система создаёт код. Его вставляют в определённый параметр при добавлении приложения в трекер (какой — зависит от трекера). Потом генерируют трекерную ссылку с этим параметром и запускают кампанию. Статус владельца появится, когда VK Реклама получит постбек с кодом.
• MyTracker, приложение: «Приложения» → «Добавить» или «+» → платформа Android → текущий статус приложения → ссылка на приложение из AppGallery с выбором варианта «AppGallery» → «Продолжить». Из ссылки убирают символ # → иконка и название → аккаунт и проект.
• MyTracker, ссылка: «Кампании» → «Добавить» → в списке «Партнер» «VK Ads + myTarget» → на вкладке «Трекинг-ссылки» название, приложение из AppGallery и целевая ссылка «Ссылка на AppGallery» → «Добавить» → скопировать ссылку для подсчёта кликов.
• Adjust, приложение: «AppView» → "New app" → название и валюта → "Add app" → "Add platform" → Android и магазин Huawei AppGallery → в поле App ID идентификатор приложения AppGallery, он должен начинаться с буквы C → "Save". Ссылки создают так же, как для других магазинов.
• AppMetrica, приложение: на главной в списке приложений «Добавить приложение» → название и часовой пояс отчётов.
• AppMetrica, ссылка: «Трекинг» → «Создать трекер» → название, в списке «Партнер» «VK Ads (ex. myTarget)» → платформа Android → целевая ссылка с названием и прямой ссылкой на приложение в AppGallery → «Сохранить» → скопировать ссылку.
• AppsFlyer, приложение: «My apps» → "Add app" → платформа "Android, AndroidTV, Fire" → вариант "Published out of store" → настройки приложения → "Next" → валюта отчётов, часовой пояс статистики, отметка, предназначено ли приложение для детей.
• AppsFlyer, ссылка: «Active Integrations» → в списке "App" выбрать приложение и партнёра → вкладка "Attribution link" → "Use a single-platform link" → при необходимости ползунок "Click-through lookback window" → скопировать ссылку из поля "Click attribution link".
• AppsFlyer, дашборд на каждый магазин: в параметре «Имя канала» указывают Channel name = appgallery.
• Для Branch, Tenjin и Singular порядок для AppGallery в справке не описан.

RuStore

• Добавить приложение в кабинет: «Мобильное приложение» → «Добавить приложение» → ссылка на приложение. Нужна прямая ссылка в магазин, не трекинговая.
• MyTracker: создать новую рекламную кампанию с партнёром "MyTarget"; в настройках ссылки в качестве Целевого URL указать ссылку на приложение в RuStore, например https://www.rustore.ru/catalog/app/com.vkontakte.android; в VK Рекламе использовать полученную трекинговую ссылку.
• Adjust: взять существующую или создать ссылку для кампании с партнёром MyTarget; добавить параметр redirect со ссылкой на RuStore в энкодированном виде (раздел «Дополнительные параметры» → «Перенаправление» в документации Adjust), например https%3A%2F%2Fwww.rustore.ru%2Fcatalog%2Fapp%2Fcom.vkontakte.android.
• AppMetrica: создать новый трекер, партнёр «MyTarget», платформа Android, целевая ссылка — на приложение в RuStore.
• AppsFlyer: добавить приложение RuStore в кабинет AppsFlyer; единый дашборд — добавлять af_r в ссылку; дашборд на магазин — Channel name = rustore, ссылка на каталог RuStore в «Out-of-store app URL», домен rustore.ru в redirect allowlist.
• Без трекера: указать ссылку на приложение в RuStore и запустить кампанию. Статистика по рекламным установкам будет только в кабинете VK Рекламы. Если трекер есть, но не используется, эти установки попадут в органику трекера.
• Для Branch, Tenjin и Singular порядок для RuStore в справке не описан.

Что на страницах не раскрыто

• Branch: куда вставляют код приложения из VK Рекламы, окна атрибуции, шаги настройки VTA.
• Tenjin и Singular: значения окон атрибуции и названия параметров окна; у Singular есть поля Click-through attribution lookback window и срок жизни cookie, но числа не названы.
• MyTracker и Adjust: окно VTA по умолчанию, диапазон значений.
• Лимиты на число событий и число трекинг-ссылок не названы.