ВойтиПопробовать бесплатно
Разделы документации

S2S-постбэк в источник

Как отправлять конверсии обратно в рекламную сеть: один адрес на все статусы или отдельный адрес на каждый, макросы и правила отправки.

Постбек в источник — запрос, которым трекер сообщает рекламной сети о конверсии. Он настраивается в карточке источника, в блоке S2S-постбэк в источник. Понадобится адрес постбека из кабинета рекламной сети. Менять настройки могут владелец и администратор. Остальным поля закрыты, а от адресов виден только домен.

Выберите режим

  1. Откройте Источники и выберите источник в списке.
  2. В блоке S2S-постбэк в источник нажмите кнопку режима:
    • Один URL на все статусы — один адрес получает каждую конверсию. Режим по умолчанию.
    • Отдельный URL на каждый статус — для сетей, где лид и депозит принимаются на разные адреса.

Режим начинает действовать после нажатия Сохранить. Переключение не стирает ни общий адрес, ни строки по статусам. Отправляется только набор выбранного режима.

Один URL на все статусы

  1. Впишите адрес рекламной сети с макросами в поле URL на все статусы конверсий.
  2. Нажмите Сохранить.

Пример адреса:

text
https://ads.example.com/postback?click_id={external_id}&status={status}&payout={payout}

Если источник создан из шаблона каталога с адресом постбека, над полем стоит кнопка Вставить постбек из шаблона. Она заменяет содержимое поля адресом из шаблона.

Если кнопка называется Вставить постбек из шаблона · замените REPLACE и свои параметры, шаблону нужен ваш ID или ключ в рекламной сети. Такой источник создаётся с пустым адресом. Вставьте адрес кнопкой, замените REPLACE и остальные значения своего аккаунта и нажмите Сохранить.

Отдельный URL на каждый статус

  1. Нажмите Отдельный URL на каждый статус. Если строк ещё нет, появятся две: Лид (lead) и Продажа · деп (sale).
  2. Выберите Статус в каждой строке.
  3. Впишите адрес в поле URL постбэка.
  4. Нажмите + Добавить постбэк, если нужна ещё строка. Всего до 20 строк на источник.
  5. Нажмите Сохранить. Строки без адреса не сохраняются.

При конверсии уходят все строки, чей статус совпал. Одинаковые адреса отправляются один раз.

Статус строкиКогда срабатывает
Лид (lead), Продажа · деп (sale), Отклонён (rejected)По статусу конверсии после сопоставления в типах конверсий. Сеть прислала status=lead, а тип конверсии свёл его к sale — сработает только строка Продажа · деп (sale)
Свой статус…По значению status= входящего постбека, как его прислала партнёрская сеть. Введите его в поле под списком, например dep. До 32 символов, регистр не учитывается

Конверсия без статуса считается лидом. Холда в списке нет: выберите Свой статус… и введите hold.

Макросы

МакросЗначение
{external_id}Click ID рекламной сети — значение токена источника со слотом external_id
{subid}, {click_id}ID клика в трекере
{sub_id_1} … {sub_id_30}Sub ID клика
{status}Статус конверсии после типов конверсий: lead, sale, rejected, hold или статус сети, для которого типа нет
{raw_status}Статус, как его прислала партнёрская сеть
{payout}, {revenue}, {conversion_revenue}Выплата в USD, одно и то же значение
{currency}Всегда USD
{tid}, {txid}ID транзакции
{campaign_id}, {offer_id}, {ts_id}ID кампании, оффера и источника
{country}Страна клика, двухбуквенный код

Значение токена источника доступно по трём именам из его строки: Слот, Название и Параметр. Токен с названием site подставляется как {site}.

  • Значения кодируются для URL. Префикс _ вставляет значение без кодирования: {_external_id}.
  • Макрос, для которого у трекера нет значения, остаётся в адресе как есть: неизвестное имя или токен, который не пришёл в клике.

Сопоставление статусов

Если сеть ждёт свои названия статусов, перечислите пары через пробел внутри макроса {status}:

text
https://ads.example.com/postback?click={external_id}&status={status:lead=0 sale=1}

Для лида уйдёт status=0, для продажи — status=1. Статус без пары подставляется без изменений. Пары работают только у {status}.

Как идёт отправка

  • Запрос — всегда GET. Адрес должен вести на публичный сервер.
  • Адрес с подставленными значениями сохраняется при приёме конверсии. Изменение настроек действует на новые конверсии.
  • Успех — ответ с кодом 2xx.
  • При ответе 5xx или 429 и когда соединение не установилось, трекер повторяет отправку сам.
  • Другие ответы не повторяются. Если ответ не получен вовремя, отправка получает результат «Получение не подтверждено» и тоже не повторяется: запрос мог дойти.

Состояния, результаты и ручной повтор описаны на странице Журнал доставки событий.

Внимание.

Перед ручным повтором сверьте данные в рекламной сети. Если она уже приняла событие, повтор создаст дубль.

Когда постбек не уходит

  • У кампании не выбран источник или в источнике нет адреса для этого статуса.
  • У типа конверсии снят флажок слать постбэк в источник.
  • Партнёрская сеть прислала постбек с прежним ID транзакции: точный повтор, исправление выплаты без смены статуса, лид или холд после продажи — см. ID транзакции, дубли и корректировки.
  • Конверсии загружены импортом из CSV без флажка Отправлять исходящие S2S и CAPI.
  • Лицензия не активна. События ждут продления и после него уходят сами — см. Истечение лицензии.

Если итоговый адрес источника совпал с адресом из постбеков кампании, получатель получит один запрос.

Проверка

  1. Откройте Кампании → кампанию → вкладку S2S-постбеки.
  2. Раскройте блок Постбеки источника внизу вкладки.

В блоке показан общий адрес или строки по статусам, изменить их здесь нельзя. Текст «Общий S2S URL не задан» или «Шаблоны по статусам не заданы.» означает, что адрес в источнике не сохранён. «S2S источника не настроен.» — у кампании не выбран источник.

После первой конверсии откройте Логи → Доставка событий. У отправки с типом «S2S · источник» должно быть состояние «Выполнено».

Если не сохраняется

Сообщение появляется вверху страницы. Перед текстом об адресе или статусе указано поле: «Общий URL постбэка:» или «Постбэк №2:» с номером строки. Строки по статусам проверяются и в режиме Один URL на все статусы. Тогда после номера стоит «(режим «Отдельный URL на каждый статус»)»: переключите режим и исправьте строку.

URL должен быть полным адресом http:// или https:// с корректным хостом.

Адрес начинается не с http:// или https://. Уточнение после этого текста называет часть адреса с ошибкой: символы перед @, IPv6-адрес, хост, порт или знак %, за которым идут не две шестнадцатеричные цифры.

URL не должен содержать пробелов и переносов строк.

Уберите пробелы и переносы. Пробел допустим только между парами внутри {status:lead=0 sale=1}.

URL длиннее 2048 символов.

Сократите адрес: предел считается вместе с макросами.

Постбэк №2: не указан статус — выберите его или введите свой.

В строке с этим номером есть адрес, но статус пуст. Выберите статус из списка или заполните поле под пунктом Свой статус….

Укажите URL хотя бы для одного статуса или переключитесь на «Один URL на все статусы».

Выбран режим по статусам, но ни в одной строке нет адреса.

Обновлено Нужна помощь? ↗