Переходите к этому разделу только в том случае, если изучили предыдущий. В нём рассмотрены сложные варианты использования постбеков. В следующем разделе вы можете ознакомиться с полной документацией по 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.