Хитрые постбеки

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

Работаем с дубликатами

Иногда постбек на создание лида может сработать дважды для одного лида и создать лишний дубликат. Иногда постбек на создание лида должен сработать дважды и двумя лидами нужно управлять отдельно. В обоих случаях нам поможет параметр exto - уникальный ID лида на стороне рекламодателя.

Пример постбека с уникальным ID:

https://domain.com/api/site/click.json?token=12-abc&click={click}&exto={lead_id}

Если в постбеке указаны и клик, и уникальный ID, нужный лид ищется по их сочетанию. Для одинаковой пары клика и ID новый лид создаваться не будет. Функция изменения статуса также найдёт именно лид с нужным уникальным ID.

Работаем с целями

Оффер может работать с разными целями. Например, кроме стандартной воронки "регистрация+депозит" могут использоваться дополнительные отчисления по модели Revenue Share.

Параметр goal принимает символьный ID цели. Настройки символьных ID целей производятся в разделе "Цели" оффера. У каждой цели может быть как основной ID, так и несколько псевдонимов. Это удобно, если целевая сеть может использовать разные значения для одного и того же действия (например, reg и registration).

Пример постбека с указанием цели:

https://domain.com/api/site/click.json?token=12-abc&click={click}&goal={goal}

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

Особые названия статусов

При отправке статуса лида через параметр status, его распознавание происходит автоматически. Вы можете изменить это поведение, напрямую указав в параметрах запроса, какие именно статусы считать аппрувом, отменой или трешем.

  • sta - статус, распознаваемый как аппрув
  • stc - статус, распознаваемый как отмена заказа
  • stt - статус, распознаваемый как треш
  • sth - статус, распознаваемый как заказ в холде
  • stw - статус, распознаваемый как заказ в обработке
  • stn - статус, распознаваемый как новый заказ (создаёт лид вместо изменения статуса)

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

Пример постбека с особым статусом аппрува:

https://domain.com/api/site/status.json?token=12-abc&click={click}&status={status}&sta=lead_ok

Единый постбек для всех статусов

Простая работа со статусами подразумевает использование не менее двух постбеков - создание лида и изменение статуса лида. В некоторых ситуациях рекламодатель позволяет установить только один постбек - изменение статуса.

Нам поможет параметр stn. Уточняем у рекламодателя, какой статус они используют для новых лидов. Например, это может быть new или pending. Указываем этот статус в параметре stn в постбеке на изменение статуса. Такой постбек создаст новый лид, если получит статус, указанный в stn.

Пример постбека на все статусы:

https://domain.com/api/site/status.json?token=12-abc&click={click}&status={status}&stn=new

В чём отличие stn=new от auto=1? При использовании параметра stn лид создаётся только в том случае, если статус совпадает с указанным в stn и попадает в статус "Новый". При использовании auto=1 лид будет создан сразу в нужном статусе, если не был найден другой лид с тем же ID клика.

Особое отчисление для рекламодателя

В некоторых ситуациях вам может потребоваться сохранить реальное отчисление рекламодателя, но при этом вебмастеру выдать отчисление, выбранное системой. Для этого добавьте параметр pay с указанием суммы отчисления рекламодателя. Также рекомендуется использовать параметр cc для указания валюты отчисления.

Пример постбека с отчислением рекламодателя:

https://domain.com/api/site/click.json?token=12-abc&click={click}&pay={payout}&cc={currency}

Вы можете одновременно использовать и параметр wm, и параметр pay, чтобы напрямую указать отчисления для вебмастера и рекламодателя. Использование параметра pay не будет менять отчисления вебмастера.

Работаем без ID клика

В некоторых случаях мы не располагаем ID клика для качественного трекинга. Такое часто случается при работе с приложениями. В подобной ситуации можно использовать идентификатор потока в параметре flow или символьный код потока в параметре code.

Пример запроса по идентификатору потока:

https://domain.com/api/site/click.json?token=12-abc&flow=1234

Пример запроса по символьному коду потока:

https://domain.com/api/site/click.json?token=12-abc&code=5FAC-D4E8

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