# S2S postback макросы (placeholders)

Макросы используются для вставки дополнительных значений в S2S Postback URL.

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

Добавляйте в Postback URL, необходимые макросы.

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

https://adnetwork.com/postback?cid={external_id}
1

TIP

Все значения по умолчанию экранируются. Если необходимо вставить в сыром виде, добавьте _ к названию макроса: {_placeholder}

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

# Встроенные макросы

Макрос Псевдоним Описание
{external_id} Содержимое переданного параметра External ID
{status:mapping} Статус конверсии с обучением ( {status:lead=0 sale=1 rejected=2} ). Только для S2S-постбэков
{revenue} Доходы из конверсии
{subid} Sub ID
{tid} ID транзакции
{ad_campaign_id} Содержимое переданного параметра ad_campaign ID
{browser_version} Версия браузера
{browser} Название браузера
{city:lang} Город
{connection_type:lang} Тип соединения
{cost} Стоимость клика
{creative_id} Содержимое переданного параметра creative ID
{current_domain} Текущий домен, с которого идет запрос
{date:format} Дата (UTC). {date:U} для unixtime
{destination} Направление (URL лендинга, оффера, редиректа, текст)
{device_brand} Бренд устройства
{device_model} Модель устройства
{device_type:lang} Тип устройства
{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. (Для входящих и S2S-постбеков или вывода случайного числа на странице лендинга/оффера)
{revenue} Доход
{sample:var1,var2,varN} Вставка одного из значений: var1, var2, varN
{source} Сайт, площадка
{stream_id} ID потока
{sub_id_1-15}
{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 Referrer
{region:lang} region_name Код или название региона
{search_engine} se Поисковик или содержимое переданного параметра se
{user_agent} ua,useragent
{offer} Создаёт защищённую ссылку на оффер. Для мультиофферных лендингов можно задавать ID оффера %%{offer:ID}%%
{conversion_cost} Расходы из конверсии
{conversion_revenue} Доходы из конверсии
{conversion_profit} Прибыль из конверсии
{conversion_time:format} Дата и время конверсии ()
{original_status} Оригинальный статус postback

# Замена статусов

Для макроса {status} можно описать как переводить статусы.

Пример:

{status: rejected=-1 lead=0 sale=1}
1

Где будет -1 - отмена, 0 - регистрация, 1 - продажа.

Другой пример:

{status: rejected=trash lead=install sale=bill}
1

# Конвертация в другую валюту

В денежных макросах можно добавить дополнительным параметром валюту.

Пример:

{conversion_revenue:eur}
1

Доступные валюты: eur, usd, gbp, rub или uah.

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

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