# Макросы (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} | Код страны |
{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 |
{status} | Статус конверсии |
{offer_name} | Название оффера. Работает при функции выбора оффера Перед кликом. Смотрите мультиофферы. |
{offer_value:NAME} | Возвращает содержимое параметра из дополнительных настроек оффера — Значения. Смотрите мультиофферы. |
{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