Постбеки

Постбек — это запрос, который платформа сама отправляет на ваш адрес, когда с лидом что-то произошло: он поступил, ушёл в холд, принят или отклонён. Трекер или CRM узнают итог сразу и не опрашивают API. Постбеки нужны для интеграции с трекерами, для передачи конверсий и для уведомлений.

Ниже описано, куда вставить адрес, какие макросы в него можно подставить и как проверить, что запрос ушёл. Что значит каждая фаза лида, написано в справочнике значений. У агентства потоков нет, поэтому вместо флажков фаз на странице стоят пять адресов, по одному на фазу, и общий адрес: постбеки агентства.

Как работают постбеки#

Платформа отправляет запрос, когда лид поступает и когда у него меняется фаза. Фаз пять: Ожидает, Холд, Принят, Отмена и Треш. В каждом постбеке вы отмечаете, на какие из них он реагирует.

Запрос — обычный GET на ваш адрес, в котором вместо макросов подставлены значения по лиду. Соединение устанавливается не дольше 3 секунд, весь запрос занимает не больше 5. Перенаправления платформа не выполняет и сама запрос не повторяет. Любой ответ записывается в журнал: HTTP-код, время запроса и начало ответа вашего сервера. Если запрос не дошёл, повторите его вручную из журнала.

Постбеки бывают двух видов, и работают они независимо: на одну смену фазы могут сработать и основной, и несколько дополнительных.

Два вида постбеков.

Страница Постбек стоит в меню Потоки. Если сеть её не показывает, глобальный и дополнительные постбеки вам недоступны, а основной можно задать в настройках потока.

Основной постбек#

Основной постбек — тот, который ждут трекеры: по одному адресу он сообщает, что стало с лидом, и не дублирует себя. Он задаётся на двух уровнях.

• Глобальный — один на весь аккаунт. Поле Глобальный постбек и флажки фаз стоят вверху страницы Постбек.
• Потоковый — свой у каждого потока: поле Постбек и те же флажки в настройках потока, раздел Постбек и трекинг. Как их найти и сохранить, написано в настройках потока.

Какой адрес сработает для лида в этой фазе:

1. Если у потока лида указан адрес и для этой фазы в потоке стоит флажок, уходит адрес потока.
2. Иначе, если указан глобальный адрес и для этой фазы стоит его флажок, уходит глобальный.
3. Иначе основной постбек для этой фазы не отправляется.

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

Чтобы задать глобальный постбек:

1. Откройте страницу. В меню выберите Потоки › Постбек.

2. Отметьте фазы. Над полем адреса стоят флажки Ожидает, Холд, Принят, Отмена и Треш. У нового аккаунта включены все пять. Оставьте только те фазы, о которых вашему трекеру нужно знать.

3. Введите адрес. В поле Глобальный постбек вставьте адрес вместе с макросами, например https://track.meow.pro/postback?subid={subid}&status={stage}&payout={cash}. Готовые адреса для популярных трекеров собраны на странице Сторонние трекеры.

4. Сохраните. Нажмите Сохранить. Страница обновится с сообщением «Успешно выполнено».

12345

Защита от повторов

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

Из этого следует правило: чтобы трекер получал каждую смену фазы, в адресе должен быть макрос, который на разных фазах даёт разное значение, — {stage}, {phase} или {status}. Адрес только с {subid} уйдёт один раз, на первую отмеченную фазу, а остальные смены фазы трекер не увидит. Макросы {now} и {rand}, наоборот, при каждой отправке дают новое значение и отключают защиту: добавляйте их, только если нужны повторы.

Для дополнительных постбеков защиты нет.

Отправка методом POST

Основной постбек по умолчанию уходит методом GET. Чтобы отправить его методом POST, начните адрес с POST:. Часть адреса после знака ? станет телом запроса. Например, из адреса POST:https://track.meow.pro/postback?subid={subid}&status={stage} запрос уйдёт на https://track.meow.pro/postback, а в теле будут subid и status.

Дополнительные постбеки#

Дополнительные постбеки нужны там, где основной не подходит: уведомления в мессенджер, своя CRM, второй трекер, события только по одной цели. Их можно создать сколько угодно. Каждый работает сам по себе и основной не заменяет.

Чтобы добавить дополнительный постбек:

1. Откройте окно. На странице Потоки › Постбек нажмите Добавить. Откроется окно Добавить.

2. Назовите постбек и укажите адрес. Поля Название и URL обязательны. Название нужно только для списка, на отправку оно не влияет.

3. Отметьте фазы. В новом постбеке отмечены все пять фаз: оставьте нужные.

4. При необходимости добавьте тело запроса. Если в поле POST-тело запроса что-то написано, запрос уйдёт методом POST. Тело записывается в формате foo=bar&baz=123 с теми же макросами, что и в адресе. Флажок Отправлять POST в формате JSON отправит это же тело JSON-объектом.

5. Привяжите постбек. Выберите Оффер, а у оффера с целями ещё и Цель. Если оставить поля пустыми, постбек сработает по лидам любых офферов. Подробнее о привязке ниже.

6. Создайте. Нажмите Создать. Постбек появится в списке.

1234

Привязка к офферу и цели

Постбек срабатывает только по тем лидам, которые подходят под его привязку.

Привязка дополнительного постбека.

Постбек привязывается к одному офферу и к одной цели. Поле Цель появляется после выбора оффера, у которого есть цели. Группа целей объединяет цели разных офферов, например регистрации или депозиты. Список групп задаёт сеть, а поле показывается, только если группы есть.

Например, постбек на https://hooks.meow.pro/crm/deposits, привязанный к цели «First deposit» оффера Claw Quest и к фазам Холд и Принят, передаст вашей CRM только первые депозиты по этому офферу.

JSON и тело запроса

Без флажка Отправлять POST в формате JSON тело уходит как есть, в форме foo=bar&baz=123. С флажком то же самое тело превращается в JSON-объект, а значения в нём строками. Тело lead={id}&flow={flow}&status={stage}&payout={cash} для принятого лида 4021 по потоку 85 с вознаграждением 12,50 уйдёт так:

{
  "lead": "4021",
  "flow": "85",
  "status": "approve",
  "payout": "12.50"
}

Если поле POST-тело запроса пусто, флажок JSON ничего не меняет: запрос уйдёт методом GET.

Список постбеков

Список на странице Постбек показывает ваши постбеки, сначала новые, по 30 на странице. Фильтры над ним: поле Поиск (ищет по названию и адресу), список «— Оффер —» и список «— Статус —», который оставляет постбеки, срабатывающие на выбранной фазе. Столбцы Название, Группа целей (если группы есть), Оффер и Цель показывают привязку, пять столбцов с иконками — фазы. Кнопка Правка открывает то же окно с настройками, кнопка Удалить удаляет постбек после подтверждения.

Постбеки агентства#

Агентство находит страницу в меню Трафик › Постбек. Вместо флажков фаз вверху страницы стоят шесть полей: по одному адресу на каждую из пяти фаз (Ожидает, Холд, Принят, Отмена, Треш) и общий адрес Глобальный.

Какой адрес сработает на фазе:

1. Если поле этой фазы заполнено, уходит этот адрес.
2. Иначе, если заполнено поле Глобальный, уходит он: он покрывает все фазы, для которых нет своего адреса.
3. Иначе постбек на эту фазу не отправляется.

1. Откройте страницу. В меню выберите Трафик › Постбек.

2. Заполните адреса фаз. Впишите адреса для тех фаз, которые вам нужны, например отдельный адрес на Принят и на Отмена. Остальные поля оставьте пустыми.

3. Задайте общий адрес. Если нужен один адрес для всех остальных фаз, впишите его в поле Глобальный.

4. Сохраните. Нажмите Сохранить.

12

Потоков у агентства нет, ссылки оно берёт в генераторе ссылок, и на основной постбек влияют только поля этой страницы. Защита от повторов действует так же, как у основного постбека. Под полями стоит список дополнительных постбеков, такой же, как у остальных вебмастеров, и фазы в нём отмечаются флажками. Идентификаторы, которые агентство передаёт в параметрах extu и exts, возвращаются в макросах {extu} и {exts}: макросы для агентств.

Макросы#

В адресе постбека и в теле запроса макрос записывается в фигурных скобках, например {id}. Платформа заменяет его значением по лиду. Значения подставляются в URL-кодировке: пробел превращается в +, русские буквы — в последовательности вида %D0%9F. Макрос, которого нет в таблицах ниже, в адресе не заменяется: на ваш сервер уйдёт сама запись {имя}, так что проверяйте имена.

Пример. Для лида 4021 по потоку 85, принятого с вознаграждением 12,50, адрес

https://hooks.meow.pro/leads?lead={id}&flow={flow}&stage={stage}&payout={cash}

превратится в

https://hooks.meow.pro/leads?lead=4021&flow=85&stage=approve&payout=12.50

Статус лида

Для большинства трекеров достаточно {stage} или {phase}. Макрос {status} нужен, если вашей CRM важен подробный шаг обработки заказа.

Макросы статуса и фазы.

Вместо готовых значений можно подставить свои макросом {phase:…}. В нём пять значений через | в порядке фаз Ожидает, Холд, Принят, Отмена, Треш. Макрос {phase:0|0|1|2|2} выдаст 0 для ожидания и холда, 1 для принятого лида и 2 для отклонённого и треша, а {phase:P|P|A|D|D} подойдёт для OctoTracker. Укажите все пять значений: для недостающей фазы подставится пустая строка. Пишите значения латиницей и цифрами. Они подставляются без кодирования, а адрес с русскими буквами платформа не отправит.

Метки клика

Метки, которые вы передали в ссылке потока или в API, возвращаются в постбек. Их назначение разобрано на странице Метки и пиксели.

Макросы меток клика.

Идентификатор клика рекламной сети

Рекламные сети могут передавать свой идентификатор клика. Платформа сохраняет его и отдаёт в макросе {cuid}. Те же значения отдают привычные имена, под которыми идентификатор приходит из разных сетей:

• {fbclid} — идентификатор клика Facebook.
• {gclid} — идентификатор клика Google.
• {ttclid} — идентификатор клика TikTok.
• {adclid} — классический идентификатор клика тизерных сетей.
• {unique_id} — классический идентификатор клика арендных приложений.
• {click_uid}, {clid}, {gbraid}, {wbraid}, {adsclid}, {rb_clickid}, {ttlid}, {twclid}, {msclkid}, {yclid}, {bbg}, {external_id} и {adid}.

Вознаграждение

Сумма вознаграждения за лид передаётся числом: целая — без дробной части (12), иначе с двумя знаками (12.50). Отдельные макросы помогают получать сумму только в нужных фазах, а в остальных — ноль.

Макросы вознаграждения.

Лид, оффер и поток

Макросы лида, оффера и потока.

Данные потока

В постбек можно передать и настройки самого потока, например чтобы отправить событие в свой сервис вместе с идентификатором пикселя. Значение берётся из соответствующего поля настроек потока, а если поле пусто, подставляется пустая строка.

Макросы данных потока.

Макросы для агентств

Агентство получает обратно собственные идентификаторы, которые передало в параметрах extu и exts. Вебмастерам эти макросы не нужны, значения у них пустые.

Макросы агентства.

Журнал постбеков#

Платформа записывает каждый отправленный запрос в журнал: адрес с подставленными значениями, тело, HTTP-код, время запроса и ответ сервера. Сеть может ограничивать срок хранения записей, и тогда старые записи удаляются. Журнал видит только владелец постбеков.

1. Откройте журнал. На странице Потоки › Постбек нажмите Журнал. Откроется страница Лог постбеков. У агентства путь такой же: Трафик › Постбек › Журнал.

2. Найдите нужную запись. Введите номер лида в поле Заказ или выберите поток в списке «— Поток —», затем нажмите Найти. Те же фильтры включаются щелчком по номеру заказа или названию потока в строке.

3. Откройте подробности. Кнопка с лупой (Информация) показывает полный адрес, тело POST и ответ сервера.

В таблице по 30 записей на странице, новые сверху. Столбцы:

Столбцы журнала.

1234

Повторная отправка

Любую запись можно отправить ещё раз кнопкой со стрелками (Отправить ещё раз). Платформа спросит подтверждение и повторит запрос на тот же URL с теми же параметрами, а новая отправка появится в журнале отдельной записью. Так удобно повторить постбек, который не дошёл из-за сбоя вашего трекера.

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

Если постбек не пришёл

Что проверить, если постбек не пришёл.