Макросы в МТС DSP: список, где работают и как пробросить в Adriver, Weborama и другие

Макросы работают в кликовой ссылке, пикселях на события, VAST-ссылках и внутри внешних кодов; в обычном HTML-баннере они не работают, для js-кода Adriver внутри HTML нужен кастомный шаблон «HTML с макросами». Записывают их так: ${ИМЯ} заглавными, между макросами рекомендуют «!». В справке описаны 18 макросов; для охвата в приложениях передают ${F70B56015AF2B2F3}.

Цифры

Макросы по группам

Пример ссылки с метками: utm_source=mts_dsp, utm_medium=programmatic, utm_campaign=campaign_name, utm_term=${OFFER_ID}!${BANNER_ID}!${PLATFORM_ID}!${DEVICE}!${TRAFFIC_TYPE}!${DOMAIN}!${SEGMENT_ID}!${IMPRESSION_ID}!${TAGID}!${PUBLISHER_ID}.

Подробности

Группа	Макросы
Кампания и креатив	OFFER_ID (id кампании), BANNER_ID (id креатива), BANNER_GROUP (набор креативов), ERID (ЕРИР ID из кабинета)
Площадка и показ	PLATFORM_ID (id SSP), DOMAIN (домен показа), TAGID (id рекламного места), PUBLISHER_ID (паблишер), IMPRESSION_ID (id показа)
Трафик и устройство	DEVICE (mobile, desktop, tablet, smart tv), TRAFFIC_TYPE (inapp или web), F70B56015AF2B2F3 (id пользователя: кука в web, IDFA/GAID в app), DEVICE_ID (IDFA/GAID в app)
Аудитория	SEGMENT_ID (аудиторные сегменты, связанные с показом)
Служебные	RANDOM (уникальное значение)
Товары из фида	PRODUCT_ID (id из тега offer), PRODUCT_URL (ссылка из тега url), PRODUCT_URL_ENCODED (она же в энкодированном виде)

Проброс в системы измерения

Система	Что делать
Weborama	в конечной ссылке метка utm_term=~CUSTOM_ID~; в кликовую ссылку Weborama добавить a.ycp= с макросами; для in-app в a.ycp= ещё ${F70B56015AF2B2F3} (в пикселе показа, клике, внешнем VAST и внешнем коде)
Adriver	в конечной ссылке utm_term=![sdt11]; в клик Adriver добавить &custom=11= с макросами; для показов макросы кладут в пиксель или js-скрипт в HTML; для in-app добавляют &advid=${DEVICE_ID}
Adserving (ex. Sizmek)	в конечной ссылке utm_term=[%tp_LineID%]; в клик добавить макросы в LineID; для показа через параметр pcp; для in-app &puid=${F70B56015AF2B2F3}
Target Ads	в клик дописать utm-метки с макросами и параметры domain, ssp для оптимизации фрода; в событие показа ключи вида offer, banner, ssp, device_type, traffic_type, domain, imp_id, tag_id, device_id, cid
Яндекс Медиаметрика	динамические значения на посадку не пробросить; в пикселе показа поддерживается universal_device_id=${DEVICE_ID} для связи конверсий на сайте с показами в приложении

Смарт ТВ

В кампаниях Смарт ТВ в Adriver идентификатор передают в параметре aextid с макросом ${F70B56015AF2B2F3}; &advid=${DEVICE_ID} для Смарт ТВ не нужен.

erid в ссылках

Макрос ${ERID} подставляет ЕРИР ID из кабинета. Adriver: параметр erir=${ERID}. Weborama: erid%3D${ERID} в a.ycp= или в customparameter баннерного тега, для VPAID через utm%3Aerid%3D${ERID}; чтобы erid был виден в итоговой посадке, об этом сообщают Weborama. Adserving: &LineID=${ERID}. Вместо макроса можно вписать значение вручную, главное, чтобы оно совпадало с указанным в кабинете.

Важно знать

Если в Adserving метка передаётся через LineID, параметр erid в ссылку не попадёт; справка считает это не нарушением, потому что erid всегда передаётся в кликовой ссылке рекламной системы.
Выгрузка статистики Target Ads по этим параметрам пока вручную; значения ssp и domain у МТС DSP фиксированы и доступны в отчётах.