Постбеки

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

Типы постбеков

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

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

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

  • Может быть только один. Если указан в потоке - глобальный игнорируется.
  • Можно указать, на какие статусы будет срабатывать. При этом, если в потоке выбраны только определенные статусы, на остальные сработает глобальный постбек, если есть.
  • Агентства могут задать свой постбек отдельно на каждый из статусов.
  • Защищён от двойной отправки - если при смене статуса постбек не поменялся, повторной отправки не будет.
  • Идеален для работы с трекерами.

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

Настраиваются в подразделе "Постбек" раздела "Потоки" или "Трафик".

  • Постбеков такого типа может быть сколько угодно.
  • Поддерживают добавление POST-части запроса и отправку в JSON.
  • Могут быть глобальным или привязываться к офферу и его цели. Один постбек можно привязать только к одному офферу или одной цели выбранного оффера.
  • Не защищены от повторов - срабатывают каждый раз при подходящей смене статуса лида.
  • Пригодятся для настройки уведомлений в Telegram, Facebook и другие сторонние сервисы.

Ссылка постбека

Параметры в ссылке постбека и его POST-части указываются с помощью макросов.

Параметры для отслеживания

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

Мы используем двенадцать меток для subid с уникальными названиями и длиной до 255 символов:

  • {subid} - содержимое параметра subid.
  • {uuid} - содержимое параметра uuid.
  • {sub1} или {subid1} - содержимое параметра sub1.
  • {sub2} или {subid2} - содержимое параметра sub2.
  • {sub3} или {subid3} - содержимое параметра sub3.
  • {sub4} или {subid4} - содержимое параметра sub4.
  • {sub5} или {subid5} - содержимое параметра sub5.
  • {utm_source} - содержимое метки utm_source.
  • {utm_campaign} - содержимое метки utm_campaign.
  • {utm_content} - содержимое метки utm_content.
  • {utm_term} - содержимое метки utm_term.
  • {utm_medium} - содержимое метки utm_medium.

Статус лида

Мы используем несколько вариантов отправки статуса лида. Вам нужен {stage}, другие вам не пригодятся.

Символьный статус лида {stage} может принимать следующие значения

  • wait – лид в обработке
  • hold – холд
  • approve – лид принят
  • cancel – лид отменён
  • trash – треш

Числовой статус лид {phase} может принимать следующие значения:

  • 1 – лид в обработке
  • 2 – холд
  • 3 – лид принят
  • 4 – лид отменён
  • 5 – треш

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

Кроме основного статуса, мы можем предоставлять вам причину отказа в макросе {reason}. Стандартный список причин отказа:

  • 1 – Некорректный номер (треш)
  • 2 – Передумал
  • 3 – Не заказывал (треш)
  • 4 – Требует сертификат
  • 5 – Неверное ГЕО (треш)
  • 6 – Треш или тест (треш)
  • 7 – Дублированный заказ (треш)
  • 8 – Заказал в другом месте (треш)
  • 9 – Дорого
  • 10 – Не устраивает доставка (треш)
  • 11 – Не удалось дозвониться (треш)
  • 12 – Подозрения на фрод (треш)
  • 13 – Не говорит на языке колл-центра
  • 14 – Товар не подошел
  • 15 – Оффер отключен
  • 16 – Консультация

Уникальный ID клика

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

  • {fbclid} - идентификатор клика Facebook
  • {gclid} - идентификатор клика Google
  • {ttclid} - идентификатор клика Tik-Tok
  • {adclid} - классический идентификатор клика тизерных сетей
  • {unique_id} - классический идентификатор клика арендных приложений

Параметры для агентств

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

  • {extu} - уникальный идентификатор лида или клика, отправленный в параметре extu.
  • {exts} - идентификатор источника или вебмастера, отправленный в параметре exts.

Сумма отчисления за лид

Мы передаём сумму отчисления в макросе {cash} для лидов в любом статусе. Иногда вам может понадобиться получать сумму только для подтверждённых лидов, а в остальных случаях получать ноль. Для этого вы можете воспользоваться следующими макросами:

  • {cash} или {price} - показывается в любом статусе
  • {paid} - показывается только в статусе approve
  • {hold} - показывается только в статусе hold
  • {holded} - показывается в статусах hold и approve

Дополнительные параметры

Вы можете использовать дополнительные данные о своём лиде для уточнения статистики.

  • {id} - уникальный идентификатор лида на стороне AlterCPA
  • {offer} - идентификатор оффера
  • {offername} - название оффера
  • {flow} - идентификатор потока
  • {site} - идентификатор лендинга
  • {space} - идентификатор прелендинга
  • {mobile} - признак мобильного трафика (0 - десктоп, 1 - мобильный)
  • {ip} - IP-адрес лида
  • {geo} - двухбуквенный ISO-код страны лида
  • {goal} - символьный идентификатор цели (при наличии)
  • {date} - время поступления лида в формате UNIX timestamp
  • {now} - время отправки постбека в формате UNIX timestamp
  • {rand} - случайное целое число
  • {currency} - трёхсимвольный код валюты отчисления за лид
  • {custom} - текстовый статус лида из CRM поставщика (при наличии)
  • {domain} - домен, с которого был отправлен лид
  • {source} - символьный идентификатор источника трафика
  • {click} - идентификатор клика в AlterCPA (он вам не нужен)

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

Мы сохраняем все отправленные постбеки в журнале. Вы можете отыскать журнал в разделе "Потоки - Постбек" или "Трафик - Постбек" по кнопке "Журнал".

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

Вы можете повторно отправить любой постбек. Важно! Этот способ подходит только для повторной отправки того же постбека, который не дошел из-за зависания вашего трекера. Отправка пройдёт по тому же URL, по которому была выполнена ранее. Чтобы повторить отправку новых постбеков, например, после их корректировки в настройках потока, свяжитесь с техподдержкой своей сети.

Для администратора: повторная отправка постбеков для вебмастера выполняется из раздела "Управление - Настройки - Утилиты - Лиды и заказы". Поставьте галочку "Повторно отправить постбеки" и укажите критерии, по которым их отправлять - ID вебмастера, оффер, период, список лидов.