Макросы в трекинг-ссылках

Макросы в трекинг-ссылках — это специальные метки или маркеры, которые используются в шаблонах click-, view- и direct URL для получения дополнительных сведений о переходах по рекламе.

Например, в таком шаблоне клик-ссылки: https://trk.mail.ru/c/a12345/?idfa={mt_idfa}&clickId={clickId}&sub1={mt_sub1},
макросы — это:

  • {mt_idfa} — идентификатор устройства
  • {clickId} — идентификатор атрибутированного клика
  • {mt_sub1} — сведения по рекламной кампании

Как работают

При генерации финального click-URL (URL, по которому будет переходить конечный пользователь), макросы должны быть заменены на конкретные значения. Например, вышеупомянутый шаблон может превратиться в такой URL:
https://trk.mail.ru/c/a12345/?idfa=AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA&clickId=click123&sub1=offer1.
Здесь произошли следующие замены:

  • {mt_idfa} → AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA
  • {clickId} → click123
  • {mt_sub1} → offer1

Замену макросов на конкретные значения выполняет партнёр. Обычно замена происходит в автоматическом режиме. Чтобы это было возможно, партнёр должен знать, какие макросы используются в URL.

Некоторые партнёры могут работать с теми макросами, которые MyTracker предоставляет по умолчанию (см. список макросов). Для других партнёров нужна дополнительная подготовка URL — замена макросов MyTracker на макросы партнёра (см. макросы партнёра).

Подробнее о том, как формируется шаблон трекинг-ссылки, и откуда в нём берутся параметры, см. раздел Клик-ссылка и URL подсчёта показов

Макросы партнёра

Если партнёр использует собственные макросы в трекинг-ссылках, то в MyTracker должны быть выполнены дополнительные настройки.

Для интегрированных партнёров (обозначенных символом ) макросы настроены по умолчанию. Если вам нужно внести изменения, вы можете обратиться в нашу службу поддержки

Для партнёров, которых вы подключили самостоятельно, вы можете настроить макросы следующим образом:

  1. Запросите у партнёра документацию или словесное описание требований по шаблону URL. Нужно выяснить, есть ли у партнёра предопределённый набор макросов для трекинг-ссылок.
  2. В интерфейсе MyTracker откройте страницу партнёра, кликнув на соответствующий блок в Списке партнёров.
  3. Перейдите на вкладку Макросы.
  4. Укажите замены, которые должны быть выполнены в трекинг-ссылках:
    • Нажмите Добавить макрос.
    • В левом столбце укажите название параметра в трекинг-ссылке. Название должно совпадать с названием макроса в MyTracker или с названием параметра из ссылки, который вы добавили как параметр URL в постбэке.
    • В правом столбце укажите название макроса, которое ожидает получить партнёр.
    • Добавьте нужное количество макросов и нажмите Сохранить.

Например, партнёр сообщил вам следующую информацию:

  • Для параметра mt_idfa нужно использовать макрос %%IDFA%%
  • Для параметра clickId — %%CLICK_ID%%
  • Для параметра mt_subId1 — %%OFFER%%

Это означает, что вам нужно заполнить форму Макросы как указано на рисунке ниже.

В результате все трекинг-ссылки для партнёра будут включать указанные замены, при этом уже созданные ссылки будут обновлены автоматически.

Например, старый шаблон клик-ссылки:
https://trk.mail.ru/c/a12345/?idfa={mt_idfa}&clickId={clickId}&sub1={mt_sub1}
будет перезаписан на новый:
https://trk.mail.ru/c/a12345/?idfa=%%IDFA%%&clickId=%%CLICK_ID%%&sub1=%%OFFER%%

И партнёру не составит труда заменить известные ему макросы, например %%IDFA%%, на конкретные значения.

Макросы MyTracker

Ниже приведён список макросов MyTracker, которые могут быть использованы в трекинг-ссылках:

Информация об устройстве

Макрос Описание Пример
{mt_idfa} IDFA устройства (только iOS) 82706CAC-3B4C-4C76-A9CB-B23F80D87692
{mt_waid} WAID устройства (только Windows) 82706CAC-3B4C-4C76-A9CB-B23F80D87692
{mt_gaid} advertising id устройства или GAID (только Android) 82706CAC-3B4C-4C76-A9CB-B23F80D87692
{mt_gaid_lc} advertising id устройства или GAID, приведённый к нижнему регистру (только Android) 82706cac-3b4c-4c76-a9Cb-b23f80d87692
{mt_idfa_or_gaid} IDFA, или advertising_id (GAID): зависит от платформы (Android/iOS) 82706CAC-3B4C-4C76-A9CB-B23F80D87692
{mt_idfa_upper_or_gaid_lower} IDFA, приведённый к верхнему регистру, или GAID, приведённый к нижнему регистру: зависит от платформы (Android/iOS) 82706CAC-3B4C-4C76-A9CB-B23F80D87692
{mt_android_id} android_id устройства (только Android) 96c504a0a4f0bb19
{mt_idfv} ios_vendor_id пары «приложение + устройство» (только iOS) 82706CAC-3B4C-4C76-A9CB-B23F80D87692
{mt_oaid} OAID устройства (только Huawei Store) 82706CAC-3B4C-4C76-A9CB-B23F80D87692
{mt_app_set_id} App set ID устройства (только Android) 82706CAC-3B4C-4C76-A9CB-B23F80D87692
{mt_mna_id} mna устройства (только Windows) 82706CAC-3B4C-4C76-A9CB-B23F80D87692
{mt_wna_id} wna устройства (только Windows) 82706CAC-3B4C-4C76-A9CB-B23F80D87692

Информация о клике/показе

Макрос Описание Пример
{mt_s2s} Признак вызова трекинг-ссылки с сервера партнёра, а не с пользовательского устройства. Такая ссылка не приводит к открытию целевой страницы, редиректа не происходит. Вместо этого трекер фиксирует факт перехода и возвращает 204 статус 1 (неизменяемое значение)
{mt_device_ua} User-Agent пользователя. Обязателен при использовании {mt_s2s} в клик-ссылке. Если MyTracker не получил {mt_device_ua}, то макросу будет присвоено пустое значение Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:35.0) Gecko/20100101 Firefox/35.0
{mt_device_ip} IP пользователя. Обязателен при использовании {mt_s2s} в клик-ссылке. Если MyTracker не получил {mt_device_ip}, то макросу будет присвоено пустое значение 172.16.255.2
{mt_ts} Временная метка клика/показа. Обязателен при использовании {mt_s2s} в клик-ссылке. Если MyTracker не получил {mt_ts}, то макросу будет присвоено значение текущего timestamp сервера 1592838075
{mt_no_redirect} Признак вызова трекинг-ссылки средствами партнёра, без редиректа MyTracker. Такая ссылка не приводит к открытию целевой страницы. Вместо этого трекер фиксирует факт перехода и возвращает 204 статус 1 (неизменяемое значение)

Информация о трафике

О детализации данных по рекламным кампаниям см. раздел SubID

Макрос Описание Пример
{mt_sub1} Дополнительная детализация Произвольная строка
{mt_sub2} Дополнительная детализация Произвольная строка
{mt_sub3} Дополнительная детализация Произвольная строка
{mt_sub4} Дополнительная детализация Произвольная строка
{mt_sub5} Дополнительная детализация Произвольная строка
{mt_network} Дополнительная детализация по сетям Произвольная строка
{mt_campaign} Дополнительная детализация по кампаниям Произвольная строка
{mt_adset} Дополнительная детализация по группам объявлений Произвольная строка
{mt_creative} Дополнительная детализация по креативам Произвольная строка

Информация о стоимости рекламной кампании

О стоимости рекламных кампаний см. раздел Кампании > Стоимость

Макрос Описание Пример
{mt_cost_currency} Код валюты: USD, RUB и т.д. USD
{mt_cost_value} Стоимость целевого действия 1.5
{mt_cost_count} Количество действий, за которое указана стоимость (целое положительное число) 1
{mt_cost_model} Модель оплаты: CPI, CPM, CPC и др. CPC