Постбеки настраиваются на стороне рекламодателя - в личном кабинете или через персонального менеджера. Образцы постбеков вы можете получить на странице настроек редирект-сайта.
Основа постбека: ID клика
Самый важный элемент постбека - это идентификатор клика. Перед настройкой постбека вам необходимо узнать, как именно он выглядит в вашем случае. Это можно найти в документации по постбеку.
Чаще всего макрос для ID клика будет таким же, как и параметр, в который вы его передавали в URL перенаправления, но в фигурных скобках. Например, в ссылке он указан как sub1={click}, значит в постбеке он будет click={sub1}.
Самый простой вариант: спросите требуемый макрос у своего персонального менеджера в целевой сети. Если он отсутствует - обратитесь к документации.
Далее по тексту мы считаем, что макрос для клика выглядит как {click}, а макросы для других параметров также указываются в фигурных скобках.
SOI-постбек
Самый простой постбек, который создаёт подтверждённый лид. Используется в офферах по знакомству, с оплатой на сайте, в приложениях с оплатой за регистрацию.
Общий вид SOI-постбека:
https://domain.com/api/site/click.json?token=12-abc&click={click}&accept=1
Параметр accept=1 отвечает за автоматическое подтверждение лида в момент добавления. Можно обойтись без него и включить в настройках оффера опцию "Автоматически подтверждать все входящие лиды" - действие будет аналогично.
DOI-постбек
Используется пара постбеков: первый создаёт лид в ожидании, второй подтверждает его. Самый популярный вариант. Используется в офферах с подтверждённой регистрацией, оплатой за первый депозит, достижение бейслайн или любой другой вариант, в котором происходит подтверждение профиля после регистрации.
Постбек на создание лида: "Регистрация"
https://domain.com/api/site/click.json?token=12-abc&click={click}
Постбек на подтверждение лида: "Депозит"
https://domain.com/api/site/status.json?token=12-abc&click={click}&status=approve&auto=1
Параметр status=approve отвечает за то, чтобы подтвердить ранее созданный лид. Параметр auto=1 отвечает за то, чтобы создать лид, если по какой-то причине постбек на регистрацию был утерян (такое случается).
Обратите внимание: постбек на создание лида обращается к функции click, постбек на изменение статуса лида - к функции status.
Постбек со статусом
Это расширение варианта DOI-постбека. Используется пара или несколько постбеков. Постбеки на создание лида (регистрацию) и его подтверждение (депозит) остаются такими же. Добавляется ещё пара постбеков:
Постбек на отмену валидного лида: "Отмена"
https://domain.com/api/site/status.json?token=12-abc&click={click}&status=cancel&auto=1
Постбек на отмену невалидного лида: "Треш"
https://domain.com/api/site/status.json?token=12-abc&click={click}&status=trash&auto=1
В параметре status можно передавать самые разные значения, автоматика постарается распознать их и перевести в соответствующий статус. Вы можете использовать макрос {status} на стороне целевой сети в сочетании с параметром status.
Постбек на умное изменение статуса по макросу:
https://domain.com/api/site/status.json?token=12-abc&click={click}&status={status}&auto=1
Добавляем сумму выплаты
Вы можете получать сумму выплаты для вебмастера напрямую в постбеке. Для этого добавьте в него параметр wm с указанием суммы выплаты и cc с указанием ISO-кода валюты выплаты.
Постбек с указанием выплаты:
https://domain.com/api/site/click.json?token=12-abc&click={click}&wm={payout}&cc={currency}
Выплату можно добавлять как к постбеку изменения статуса, так и к постбеку создания лида.
Обратите внимание: если выплата передана в постбеке, она перезаписывает выплату, которая определена системой. Чтобы задать партнерскую комиссию, используйте «Ручные отчисления».
Добавляем страну
Иногда сумма выплаты зависит от страны, а страна на стороне целевой сети определяется по фазе пятой луны Сатурна. Вы можете добавить в постбек параметр country с указанием ISO-кода страны получателя.
Пример постбека с указанием страны:
https://domain.com/api/site/click.json?token=12-abc&click={click}&country={geo}
С помощью точного указания страны вам не потребуется использовать ручные отчисления.
Добавляем цену заказа
Важно! Цена заказа - это не сумма отчисления. Это сумма чека для товарных лидов или сумма депозита. По цене заказа может вычисляться процентное отчисление.
Пример постбека с ценой лида:
https://domain.com/api/site/click.json?token=12-abc&click={click}&base={price}¤cy={currency}
В параметр base передаётся сумма чека по заказу, в параметр currency - ISO-код валюты заказа.
Глобальный постбек
Иногда вам нужно подключить несколько офферов, но постбек вы можете задавать только один на всех. В этом случае пригодится глобальный ключ для постбека. Перейдите в раздел Управление - Настройки - Сайты. Ближе к низу страницы найдите «Глобальный ключ API» в блоке «Технические настройки». Укажите его в параметре token в ссылке постбека.
Например, было:
token=123-2fc78e4643ec1f8b6a8039e09d39dcc3
Станет вот так:
token=jkUYwu9EBECEolXfnL9GIuwgiOJiB0rG
Цифры и дефис тоже убираем. Остаётся только ключ из странного набора символов.
Проверка постбеков
После настройки постбеков, рекомендуется проверить, корректно ли они работают. Для этого перейдите в раздел Управление - Настройка - API запросы. В нём выберите поиск по приложению site. Вас интересуют функции click и status. Вы можете найти нужные запросы, указав ID сайта, для которого был создан постбек.
Лайфхак для глобальных постбеков: вы можете добавить к постбеку параметр z с произвольным значением. Например, указать в нём название партнёрской сети, с которой работаете. Поиск по параметру z выполняется через поле Тег. Впрочем, использование тега рекомендуется для любых постбеков.
Пример постбека с указанием тега:
https://domain.com/api/site/click.json?token=12-abc&click={click}&z=BestNetwork