СтатьиDiscussions
Статьи

TD Macros

Макросы в ссылке для кликов

Suggest Edits

Для удобства отслеживания информации и сбора статистических данных мы предоставляем возможность добавления в ссылку для кликов специальных переменных - макросов. Благодаря макросом возможно получить дополнительные сведения о переходах по рекламе.

Доступен следующий набор макросов:

МакросОписание макросаВозможен в ссылке переходаВозможен в пикселе аудитаВозможен в коде баннераПример
{CAMP_ID}ID кампании, макрос позволяет в финальную ссылку подставить идентификатор кампанииДаНетДа5417F50869AB18D4
{CAMP_ID_STR}ID кампании в строковом форматеНетДаДаtdm4%23ms-5.18
{CAMP_NAME}Название кампанииДаДаДаname campaign test
{CAMP_NAME_ESC}Экранированное название кампанииДаДаНетname%20campaign%20test
{CR_ID}ID креатива, макрос позволяет в финальную ссылку подставить идентификатор креативаДаНетДа84150CB53BA3B355
{CR_ID_STR}ID креатива в строковом форматеНетДаДаtdm4%23ms-5.18.1
{CR_NAME}Название креативаДаДаНетname creative test
{CR_NAME_ESC}Экранированное название креативаДаДаНетname%20creative%20test
{SRC_ID}хэш от ID ССПТолько в ссылке-переходаДа
{SRC}ID источникаДаНетДаsniperadn
{SRC_XXH64}XXH64 от ID источника, не используется в видеоДаДаДа
{TR_KEY}ID клика, макрос позволяет в финальную ссылку подставить идентификатор клика. {TR_KEY} при показе принимает одно значение, при клике - другое.ДаНетДаCgjLhHMcmGwAahCS0N4NGOTP_5IH
{RID}ID клика/показа, макрос позволяет в финальную ссылку подставить идентификатор клика/показа. Отличается от макроса {TR_KEY}, тем что не меняется при клике. При показе и при клике макрос {RID} постоянен.ДаНетДаP4zA9tTKa-g*
{W}ширина блока, макрос позволяет во время показа объявления добавлять в специальный код сведения о ширине рекламного блока.НетНетНет300px
{H}высота блока, макрос позволяет во время показа объявления добавлять в специальный код сведения о высоте рекламного блока.НетНетНет600px
{TS}timestamp, временная метка клика/показа. Если нет дополнительных особенностей, то макросу будет присвоено значение текущего timestamp сервера.ДаНетНет761628590
{RND}рандомное число для блокировки кэша. Макрос блокировки кеша нужен для того, чтобы сервер объявлений получал новый запрос при каждом выполнении кода: это обеспечивает точную статистику показов.ДаНетДа761628590
{LINK_ESC}Целевая ссылка перехода с однократным экранированием. Обычно выбор типа экранирования (без экранирования, однократное или двойное) зависит от стороннего поставщика.НетНетДаhttps%3A%2F%2Flog%2Ebumlam%2Ecom%2F%3Fsrc%3Dsadn1%26s%5Fact%3Dc%26s%5Ftrk%3DCfbLhHMcmGwAahCS0N4NGOTP%5F5IG
{LINK_UNESC}Целевая ссылка перехода без экранирования. Обычно выбор типа экранирования (без экранирования, однократное или двойное) зависит от стороннего поставщикаНетНетДаhttps://sync.terratraf.com/r/?id=CfbSUi1URVNUEOTP_5IGGN6CvV8g6-22bA
{UID}ID пользователя, макрос заполняется при наличии пользователя в матчингеДаНетДа
{UID3}ID пользователя в формате UID3, макрос заполняется при наличии пользователя в матчингеДаНетДа
{SSP_UID}ID пользователя на стороне SSPДаНетНет7c309246-7382-11ec-a6e9-002590c82448
{HEX_UID}хэш гуглового ID пользователя, макрос может быть использован только для GoogleНетНетНет
{UNIQ_ID}ID пользователя, в макрос будет подставляться тот ID, по которому считается уникальность пользователяНетНетНет
{BLOCK_ID}ID блока, идентификатор рекламного блокаДаНетДа
{S_DMN}доменДаНетДаdemo.terratraf.com
{S_DMN_OR_APP_ENC}универсальный макрос, возвращает домен либо ID приложения, в зависимости от того, это веб или приложение.ДаДаДаdemo.terratraf.com
{COUNTRY}Страна, двухбуквенный код страныДаНетНетru
{CITY}Название города, строкаДаНетНетmoscow
{CITY_CODE}Код города, обозначается, как связка страна:город.ДаНетНетru:msk
{GEONAME}Целочисленное ID географического регионаДаНетНет524901
{ERID}Единый рекламный идентификатор данных, используется для отслеживания статистики. Внутри зашифрованы ID самого креатива и ответственного ОРД.ДаНетДаefr25i
{PUBLISHER}ID ПаблишераДаНетНетadsn-pub-273000190
{GEO_REGION}Регион для контента DCO баннера, позволяет показывать разный текст на банере в зависимости от ГЕОНетНетНетдля Волгоградской области ru:vgg

При формировании ссылки можно в get-параметрах указать один или несколько из этих макросов (наличие макросов в ссылке не обязательно).

При генерации финальной ссылки (ссылка, по которой перейдет конечный пользователь), макросы будут автоматически заменены на конкретные значения. Замена макроса на соответствующее значение будет выполнена автоматически.

Корректная ссылка будет иметь следующий вид (пример, с несколькими макросами):
https://www.your_link.ru/?camp_id={CAMP_ID}&cr_id={CR_ID}&src_id={SRC_ID}&str_key={TR_KEY}

Примеры использования макросов

Пример 1:
Пользовательская ссылка:
https://www.your_link.ru/?camp_id={CAMP_ID}&cr_id={CR_ID}

В данном примере использовались два макроса: {CAMP_ID} и {CR_ID}. Далее при показе баннера макросы автоматически заменятся на соответствующие пользовательские значения. Например, для данного пользователя его
campaign ID=6596f2bb147e5638 и creative ID=CgiaFuHAXVmrZxDSkJq5ChiGu6XuBSC1vKXuBQ**. (Значения в формате xxhash64)

Тогда ссылка автоматически примет вид:
https://www.your_link.ru/?camp_id=6596f2bb147e5638&cr_id=CgiaFuHAXVmrZxDSkJq5ChiGu6XuBSC1vKXuBQ**

Пример 2:
Пользовательская ссылка:
https://www.your_link.ru/?camp_id={CAMP_ID}&cr_id={CR_ID}&s_dmn={S_DMN}&str_key={TR_KEY}

В данном примере использовались четыре макроса. Далее при показе баннера макросы автоматически заменятся на соответствующие пользовательские значения. Например, для данного пользователя его
campaign ID = 6588f2aa147e7738
creative ID=s:9fbb20a987765342df2010e3f735b4a4
domain ID=demo.terratraf.com
click ID=CgjifzCW8PhxyRCEt7flBhj-4L3vBQ**
Все ID-значения в формате xxhash64.

Тогда ссылка автоматически примет вид:
https://www.your_link.ru/?camp_id=6588f2aa147e7738&cr_id=s:9fbb20a987765342df2010e3f735b4a4&s_dmn=demo%2Eterratraf%2Ecom&str_key=CgjifzCW8PhxyRCEt7flBhj-4L3vBQ**

Таким образом, примеры использования макросов показывают, что конечные ссылки содержат пользовательскую информацию удобную для анализа и сбора статистики.

Updated 3 months ago