# Макросы (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} Дата (по умолчанию формат UTC.{_date:Y-m-d H:i:s} передаст в виде 2022-07-27 10:43:04)
{device_model} Модель устройства
{device_type:lang} Тип устройства
{destination} Направление (Landing URL, Offer URL, и т.д.)
{from_file:file} Загрузит содержимое файла из %%var/macros/file%%
{ip} IPv4 адрес
{is_bot} Вернет 1 если бот
{is_using_proxy} Вернет 1 если прокси
{isp} Имя интернет-провайдера
{keyword:charset} Keyword или поисковая фраза
{landing_id} ID лендинга
{language} Язык в ISO 639-1
{offer_id} ID оффера
{os_version} Версия операционной системы
{os} Операционная система
{parent_campaign_id} ID предыдущей кампании, если использовалось действие "Отправить в кампанию"
{profit} Прибыль (revenue - cost)
{random:min,max} Случайное число между 'min' и 'max'
{sample:val1,val2,valN} Вернет случайное значение из списка
{source} Сайт
{stream_id} ID потока
{sub_id_1 - sub_id_30} Дополнительные параметры sub_id
{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)
{conversion_time: format} {conversion_time:Y-m-d H:i:s} для передачи как 2022-07-27 10:46:25
{original_status} Оригинальный статус из postback
{status} Статус конверсии
{offer_name} Название оффера. Работает при функции выбора оффера Перед кликом. Смотрите мультиофферы.
{offer_value:NAME} Возвращает содержимое параметра из дополнительных настроек оффера — Значения. Смотрите мультиофферы.
{previous_status} Предыдущий статус конверсии
{affiliate_network_name} Название партнерской сети
{campaign_alias} Передача идентификатора кампании

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