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

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

Основа постбека: 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}&currency={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