Макросы в трекинг-ссылках — это специальные метки или маркеры, которые используются в ссылках для подсчёта кликов и показов для получения дополнительных сведений о переходах по рекламе.
Например, в таком шаблоне ссылки:
https://trk.mail.ru/c/a12345/?idfa={mt_idfa}&clickId={clickId}&sub1={mt_sub1},
макросы — это:
{mt_idfa} — идентификатор устройства{clickId} — идентификатор атрибутированного клика{mt_sub1} — сведения по рекламной кампании
При генерации финальной ссылки
(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 на макросы партнёра (см. макросы партнёра).
Подробнее о том, как формируется шаблон трекинг-ссылки, и откуда в нём берутся параметры, см. раздел Ссылки для подсчёта кликов и показов
Если партнёр использует собственные макросы в трекинг-ссылках, то в MyTracker должны быть выполнены дополнительные настройки.
Для интегрированных партнёров (обозначенных символом ) макросы настроены по умолчанию. Если вам нужно внести изменения, вы можете обратиться в нашу службу поддержки
Для партнёров, которых вы подключили самостоятельно, вы можете настроить макросы следующим образом:
Например, партнёр сообщил вам следующую информацию:
%%IDFA%%%%CLICK_ID%%%%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, которые могут быть использованы в трекинг-ссылках:
| Макрос | Описание | Пример |
|---|---|---|
| {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 |
