# Макросы (Placeholders)

# Использование

Макросы необходимы для замены каких то частей текста, ссылки или кода на динамические значения.

Пример:

<a href="{offer:1}">Get the Offer!</a>
1

В этом коде используется макрос {offer:1}, он выполняет генерацию Offer URL и подставляет результат.

# Список

Макрос Описание
{offer} Создает Offer URL. Поддерживается параметр ID {offer:ID}
{subid} Subid
{external_id} External ID, полученный от источника
{tid} Transaction ID
{revenue}
{ad_campaign_id} Ad campaign ID
{browser_version} Версия браузера
{browser} Название браузера
{city} Город
{connection_type:lang} Тип соединения
{cost} Стоимость клика
{current_domain} Вернет текущий домен трекера
{creative_id} Creative ID
{date:format} Date (по умолчанию формат UTC)
{device_model} Модель устройства
{device_type:lang} Тип устройства
{destination} Направление (Landing URL, Offer URL, etc.)
{from_file:file} Загрузит содержимое файла из %%var/macros/file%%
{ip} IPv4 адрес
{is_bot} Вернет 1 если бот
{is_using_proxy} Вернет 1 если прокси
{isp} Имя интернет провайдера
{keyword:charset} Keyword или поисковая фраза
{landing_id} Landing ID
{language} Язык в ISO 639-1
{offer_id} Offer ID
{os_version} Версия операционной системы
{os} Операционная система
{parent_campaign_id} ID предыдущей кампании, если использовалось действие "Отправить в кампанию")
{profit} Прибыль (revenue - cost)
{random:min,max} Случайное число между 'min' и 'max'
{sample:val1,val2,valN} Вернет случайное значение из списка
{source} Сайт
{stream_id}
{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}
{sub_id_10}
{sub_id_11}
{sub_id_12}
{sub_id_13}
{sub_id_14}
{sub_id_15}
{traffic_source_name} Название источника трафика
{ts_id} ID источника трафика
{visitor_code} Код посетителя (используется внутри Keitaro)
{campaign_id} ID кампании
{campaign_name} Название кампании
{country:lang} Страна или код страны, если не указан lang
{operator:lang} Мобильный оператор (устарело, используйте {isp})
{referrer} Referrer
{region:lang} Регион или код региона, если не передавать lang
{search_engine} Поисковая система
{user_agent} User agent
{conversion_cost} Стоимость конверсии
{conversion_revenue} Выплата по конверсии
{conversion_profit} Прибыль по конверсии (revenue - cost)
{original_status} Оригинальный статус из postback
{status} Статус конверсии

TIP

Доступны также все псевдонимы параметров кампании.

# Создание своего макроса

Смотрите страницу Создание макроса.

# FAQ по макросам

Почему появятся символы +, %D0, %B0 и т.д?

Все значения кодируются согласно правилам URL. Добавьте _ перед именем макроса, чтобы убрать это:

Пример:

{_city:en}
1
Как вставить UTM метки

Допустим, campaign URL следующий:

https://yourdomain.com/campaign?utm_source=123&utm_term=444

Становятся доступны макросы с такими же именами:

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

Читайте более подробно на странице Передача параметров от источника.

Как вставить случайное число или строку?

Используйте макрос {random}:

{random:10,1000}
1

Или {sample} ({_sample} вернет без кодирования символов):

{_sample: one, two, three}
1