S2S-постбеки кампании и источника

Когда трекер принимает конверсию, он отправляет GET-запросы по двум спискам адресов: постбеки источника и постбеки кампании. Списки работают одновременно и настраиваются отдельно; кампания без источника отправляет только свои адреса. Адреса кампании настраивает тот, кто может её изменять, постбек источника — владелец и администратор.

Постбек источника

Постбек источника действует на все кампании с этим источником. Он задаётся в карточке источника, в блоке S2S-постбэк в источник, в одном из двух режимов:

• Один URL на все статусы — один адрес получает конверсию с любым статусом.
• Отдельный URL на каждый статус — до 20 строк, отправляются все строки с совпавшим статусом.

Порядок настройки — на странице S2S-постбэк в источник.

Добавить постбек кампании

1. Откройте кампанию и перейдите на вкладку S2S-постбеки.
2. В блоке Постбеки кампании нажмите + Добавить постбек.
3. Выберите статус в списке. По умолчанию стоит Все статусы.
4. Впишите адрес в поле под списком статусов.
5. Нажмите Сохранить постбеки. Появится надпись «Постбеки сохранены».

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

https://example.com/postback?subid={subid}&status={status}&payout={payout}

Счётчик рядом с кнопкой показывает число строк, например 3 / 20. В списке не больше 20 строк вместе с выключенными: на двадцатой кнопка + Добавить постбек отключается.

Кнопка Сохранить постбеки активна, когда есть несохранённые правки. Отменить изменения возвращает последнее сохранённое состояние.

Под списком находится раскрывающийся блок Постбеки источника: адреса источника этой кампании и состояние Facebook CAPI. Изменить их здесь нельзя. Владелец и администратор видят адреса целиком, остальные — только домен.

Выключить или удалить адрес

• Снимите флажок у номера строки, например Постбек 1, — строка останется в списке, но запросы по ней отправляться не будут.
• Нажмите Удалить — строка исчезнет из списка.

Оба действия вступают в силу после нажатия Сохранить постбеки.

Статусы

При выборе Свой статус рядом появляется поле с подсказкой «Например, approved». Значение обязательно, до 32 символов, без пробелов. Регистр не учитывается.

Макросы

Работают и макросы по токенам источника: по значению колонки Название и по имени параметра ссылки.

• Значения кодируются для URL. Префикс _ вставляет значение без кодирования: {_subid}.
• Статус можно заменить значением получателя: {status:lead=lead sale=dep rejected=cancel}. Пары пишутся через пробел, статус без пары передаётся как есть.
• Макрос остаётся в адресе без замены, если трекер его не знает или у клика нет такого параметра.

Ссылка Справочник макросов на вкладке открывает раздел Макросы панели — общий список для ссылок и страниц, см. Макросы. В адресах постбеков действуют макросы из таблицы выше.

Когда запрос не отправляется

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

Если после подстановки макросов адреса совпали, получатель получает один запрос. Когда совпали адрес источника и адрес кампании, отправка в журнале называется S2S · источник + кампания.

Требования к URL

• Полный адрес, начинается с http:// или https://.
• До 2048 символов.
• Без пробелов и переносов строк. Пробелы допустимы только между парами внутри {status:…}.
• Фигурные скобки — только у макросов, после % — две шестнадцатеричные цифры.
• Адрес ведёт на публичный сервер. Запрос на локальный или частный адрес не отправляется, в журнале у него результат «Адрес заблокирован».

Проверка

1. Отправьте тестовую конверсию по клику этой кампании через входящий постбек.
2. Откройте Логи → Доставка событий. Раздел видят владелец и администратор.
3. Введите subid клика в поле Subid и нажмите Найти.
4. Найдите строку S2S · кампания в колонке Тип / получатель.

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

Если не получилось

Сообщение об ошибке появляется под списком после нажатия Сохранить постбеки. Номер в нём — номер строки.

Постбек кампании №1: укажите статус без пробелов (до 32 символов) или * для всех статусов

В поле своего статуса есть пробел. Впишите значение без пробелов.

Постбек кампании №1: URL не должен содержать пробелов и переносов строк

Уберите пробелы из адреса.

Постбек кампании №1: URL должен быть полным адресом http:// или https:// с корректным хостом (фигурные скобки — только у макросов, после % — две шестнадцатеричные цифры)

Адрес начинается не с http:// или https://, в нём нет домена, фигурная скобка стоит вне макроса или после % идут не две шестнадцатеричные цифры.

Постбек кампании №1: после % в query должны идти две шестнадцатеричные цифры

В параметрах адреса после ? за знаком % нет двух шестнадцатеричных цифр. Исправьте или уберите этот знак.

Адреса и настройка постбеков доступны пользователям с правом изменения кампании.

Эта надпись стоит на вкладке вместо списка, когда кампания открыта вам только для просмотра. Кто может менять кампанию — на странице Доступ к кампаниям и «Поделиться».