Макросы

Макросы позволяют вставлять динамические элементы в URL или текст. Здесь вы можете использовать макросы:

  • В URL в потоках при схеме потока «Редирект»;
  • В текстовом поле, при схеме потока «Действие»;
  • В URL лендинга
  • В URL оффера
  • В Postback URL источника трафика
  • В S2S постбеках кампании

Как использовать макросы?

Любой макрос выглядит как {название} или {_название} для вставки без кодирования символов.

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

http://landing.com/search?q={keyword}
http://landing.com/search?q={_keyword}

При значении keyword «test keyword», результат:

http://landing.com/search?q=test+keyword
http://landing.com/search?q=test keyword

Некоторые макросы имеют параметры. Пример, {code} {sample:1,2,3,4} {code}

Это может быть и любой переданный в кампанию параметр:

{code} {utm_label1}, {utm_label2} {code}

Список макросов

Макрос Псевдонимы Описание
{ad_campaign_id} Содержимое переданного параметра ad_campaign_id
{browser_version} Версия браузера
{browser} Название браузера
{city:lang} Город
{connection_type:lang} Тип соединения
{cost} Стоимость клика
{creative_id} Содержимое переданного параметра creative_id
{date:format} Дата (UTC)
{device_model} Модель устройства
{device_type:lang} Тип устройства
{destination} Направление (URL лендинга, оффера, редиректа, текст)
{external_id} Содержимое переданного параметра external_id
{from_file:file} Подгрузка содержимого файла «file» из директории var/macros/
{ip} IP адрес
{is_bot} Является ли ботом (1, если бот)
{is_using_proxy} Выявлено ли прокси (1, если прокси)
{isp} Провайдер
{keyword:charset} Ключевик (кодировка в параметр charset)
{landing_id} ID лендинга
{language} Язык
{offer_id} ID оффера
{os_version} Версия ОС
{os} Операционная система
{parent_campaign_id} ID предыдущей кампании (если использовалось действие «Отправить в кампанию»)
{profit} Прибыль (доход - расход)
{random:min,max} Случайное число между min до max
{revenue} Доход
{sample:var1,var2,varN} Вставка одного из значений: var1, var2, varN
{source} Источник, площадка
{stream_id} ID потока
{sub_id_10}
{sub_id_1}
{sub_id_2}
{sub_id_3}
{sub_id_4}
{sub_id_5}
{sub_id_6}
{sub_id_7}
{sub_id_8}
{sub_id_9}
{subid} SubID (уникальный идентификатор клика)
{traffic_source_name} Имя источника трафика
{ts_id} ID источника трафика
{visitor_id} Внутренний идентификатор пользователя
{campaign_id} keitaro_campaign_id ID кампании Keitaro
{campaign_name} keitaro_campaign_name Имя кампании Keitaro
{country:lang} country_code,country_name Код или название страны
{operator:lang} carrier Сотовый оператор
{referrer} referer Реферер
{region:lang} region_name Код или название региона
{search_engine} se Поисковик или содержимое переданного параметра se
{user_agent} ua,useragent

Как перекинуть метки сквозь Keitaro?

Добавьте все метки к URL кампании:

http://tds.com/campaign?utm_source=123&utm_term=444

В потоках значения этих меток можно подставить одноименными макросами:

http://landing.com/?utm_source={utm_source}&utm_term={utm_term}

Перечень всех меток:

utm_source={utm_source}&utm_term={utm_term}&utm_content={utm_content}&utm_medium={utm_medium}&utm_campaign={utm_campaign}

Внимание! Если вы используете офферы в трекере, то нужно использовать макросы встроенных параметров {sub_id_1..10}, {creative_id} и т.д.

&utm_source={source}&utm_term={keyword}&utm_medium={sub_id_1}

Как генерировать макросом разные сайты?

Разместив в потоке такой макрос можно уводить пользователей на разные сайты случайным образом:

http://{_sample:site1.ru,site2.ru,siteN.ru}

Как показывать значение без кодирования?

Используйте формат макроса {_name}. Например, {_keyword}.

Как добавить свой макрос?

Читайте на странице Создание макросов.