Постбэк: что это и как настроить S2S постбэк

Постбэк (postback) это запрос, который партнёрская сеть или рекламодатель отправляет на адрес вашего трекера, когда пользователь совершил целевое действие: купил, оставил заявку, пополнил счёт. В запросе приходят ID клика, выплата и статус. Такой вызов между серверами называют S2S (server-to-server), отсюда и «s2s постбэк».

Настройка занимает минут пятнадцать, если понимаете, какое значение куда подставляется. Большинство проблем возникает из-за одного пропущенного звена: ID клика должен выйти из трекера, пройти через ссылку оффера до сети и вернуться в постбэке.

Как постбэк проходит весь путь

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

1. Приходит клик. Пользователь кликает по объявлению и попадает на вашу ссылку трекера. Трекер фиксирует клик и генерирует уникальный ID, например a8f3c21d.
2. ID клика попадает в ссылку оффера. Трекер перенаправляет посетителя на оффер и добавляет ID в параметр, например ?subid=a8f3c21d. Название параметра то, которое ждёт сеть для поля sub ID.
3. Сеть сохраняет значение. Оно хранится вместе с её собственной записью о визите.
4. Посетитель конвертируется. Покупка, заявка или установка происходит на стороне рекламодателя, иногда через минуты, иногда через дни.
5. Сеть обращается к вашему постбэк-URL. Она отправляет запрос в трекер с сохранённым ID клика, выплатой и статусом.
6. Трекер записывает конверсию. Он находит клик по ID и привязывает к нему конверсию. С этого момента источник, кампания, гео и доход лежат в одной строке.

Запрос делает сервер сети, а не браузер посетителя. Поэтому постбэк работает, даже если вкладку закрыли, стоит блокировщик рекламы или выключены cookie.

Из чего состоит постбэк-URL

Это обычная ссылка с заглушками на месте значений. Общий пример:

https://track.example.com/postback?clickid={clickid}&payout={payout}&status={status}&txid={transaction_id}

Разберём по частям:

• Домен и путь. track.example.com/postback это адрес на вашем трекере, который принимает вызовы о конверсиях. Его выдаёт сам трекер.
• Параметр с ID клика. clickid={clickid} ключевое поле. Без него трекер не поймёт, какой клик сконвертировался.
• Выплата. payout={payout} сумма, которую рекламодатель платит за конверсию, обычно в валюте вашего аккаунта в сети.
• Статус. status={status} показывает, подтверждена конверсия, ожидает проверки или отклонена.
• ID транзакции. txid={transaction_id} необязательный уникальный номер самой конверсии. Нужен для дедупликации, о ней ниже.

Части в фигурных скобках называются макросами. В момент отправки сеть заменяет каждый макрос реальным значением. Названия макросов у разных сетей разные: где-то {clickid}, где-то {subid}, {aff_sub} или {sub1}. Пример выше нельзя вставить в реальную сеть как есть. Откройте документацию сети, найдите список макросов для постбэка и подставьте их по очереди.

Названия параметров слева от знака равенства (clickid, payout, status) задаёт ваш трекер. Макросы справа задаёт сеть. Путаница между ними самая частая ошибка при настройке.

Статусы конверсии: approved, pending, rejected

Не каждая конверсия, о которой сообщила сеть, станет деньгами. Рекламодатели проверяют заявки и продажи до выплаты, поэтому конверсия проходит несколько статусов.

Сети обычно отправляют постбэк при каждой смене статуса, поэтому по одной конверсии может прийти два-три вызова: сначала pending, потом approved или rejected. Трекер должен обновить существующую конверсию, а не создать новую. Здесь и нужен ID транзакции.

Значения, которые означают «подтверждено», тоже различаются. Одни сети присылают слово approved, другие число или буквенный код. Проверьте, что именно шлёт ваша сеть, прежде чем строить правила на статусе.

Дедупликация по ID транзакции

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

Обычная защита это уникальный ID транзакции для каждой конверсии. Трекер запоминает уже виденные ID. Когда приходит вызов с известным ID, он считает его обновлением или игнорирует, а не добавляет вторую конверсию. Допустим, в 10:00 сеть шлёт pending с txid=5521, а в 14:00 approved с тем же txid=5521. Трекер с дедупликацией покажет одну конверсию, сменившую статус. Трекер без неё покажет две.

Если у сети есть макрос ID транзакции или ID конверсии, добавьте его в постбэк. Если нет, уточните, как она обрабатывает повторы.

S2S постбэк или пиксель

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

Если сеть поддерживает оба варианта, для арбитража надёжнее S2S. Пиксель остаётся запасным вариантом, когда рекламодатель не отправляет серверные вызовы.

Чек-лист настройки

Идите по порядку. Каждый шаг убирает целый класс проблем до того, как они попадут в цифры.

1. Узнайте, какой параметр для ID клика ждёт сеть. Найдите в документации поле sub ID и запишите его точное название.
2. Добавьте ID клика в ссылку оффера в трекере. У трекера есть свой макрос для ID клика. Поставьте его значением параметра sub ID сети.
3. Скопируйте постбэк-URL из трекера. В нём уже есть ваш домен и названия параметров, которые читает трекер.
4. Откройте настройки постбэка в сети. Где-то он задаётся на оффер, где-то на аккаунт, где-то на группу офферов.
5. Замените заглушки макросами сети. Сопоставьте ID клика, выплату, статус и ID транзакции со списком макросов сети.
6. Выберите события, по которым отправляется постбэк. Если сеть позволяет выбрать статусы, отправляйте минимум approved и rejected. Добавьте pending, если хотите видеть конверсии на холде.
7. Проверьте протокол. Если на домене есть сертификат, используйте https.
8. Сохраните и проведите тестовую конверсию. Подробности ниже.

Проверка тестовой конверсией

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

1. Откройте свою ссылку трекера в браузере. В логе появится клик с известным ID.
2. Пройдите редирект до оффера и посмотрите на параметр sub ID в адресной строке. В нём должно быть настоящее значение, а не пустая строка и не буквальный текст макроса.
3. Попросите сеть зарегистрировать тестовую конверсию по этому клику или выполните оффер сами, если он недорогой. У некоторых сетей есть кнопка отправки тестового постбэка, куда ID клика вводится вручную.
4. Откройте отчёт по конверсиям в трекере. Конверсия должна появиться в строке тестового клика с правильной выплатой и статусом.
5. Если ничего не появилось, пройдите проверки из статьи Постбэк не приходит: чек-лист проверок.

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

Постбэки в TDS.SO

TDS.SO прежде всего система распределения трафика: одна ссылка в рекламе, за ней правила по гео, устройству и другим условиям, фильтрация ботов до того, как клик дойдёт до оффера. Трекерная часть с постбэками, конверсиями, доходом и ROI находится в бете. В трекере доход это сумма подтверждённых (approved) конверсий, а расход считается по всем кликам, поэтому ROI отражает то, что рекламодатель реально подтвердил.

Раз трекер в бете, актуальный постбэк-URL и названия параметров смотрите в своём кабинете, а не копируйте из статьи. Обзор раздела аналитики есть на странице Аналитика. Если вы направляете трафик правилами, на странице Редиректы описано, как клик попадает на оффер, а именно по этому пути должен пройти ваш ID клика. Вопрос о том, нужен ли вам трекер вообще, разобран в статье Когда нужен трекер.

Берегите ID клика

ID клика единственное значение, которое нельзя потерять. Если прокладка, редирект или лендинг отбросят параметр, сеть его не увидит, и постбэк придёт пустым. Каждый раз, когда между ссылкой трекера и оффером появляется новый шаг, откройте итоговый URL и убедитесь, что ID клика на месте. Это десять секунд, которые экономят неделю поисков пропавших конверсий.

FAQ

Постбэк что это простыми словами?

Это адрес, на который сеть обращается, чтобы сообщить трекеру о конверсии. В запросе есть ID клика, поэтому трекер знает, какому клику засчитать результат, а ещё выплата и статус.

Чем постбэк отличается от пикселя?

Постбэк отправляется с сервера сети на ваш сервер. Пиксель работает в браузере посетителя. Блокировщики рекламы и закрытая вкладка постбэку не мешают, поэтому для партнёрского трафика стандартом считается он.

Почему макросы не работают, если я скопировал URL из инструкции?

Названия макросов принадлежат сети. То, что в одной инструкции называется {clickid}, в вашей сети может быть {subid} или {aff_sub}. Берите список макросов из документации сети.

Нужен ли постбэк, если сеть и так показывает конверсии в своём кабинете?

Кабинет сети показывает итоги, но не знает ваш источник, кампанию и креатив. Постбэк переносит конверсию в трекер, где её можно разрезать по вашим параметрам и сравнить с расходом.

Может ли одна конверсия отправить несколько постбэков?

Да. Многие сети шлют один при регистрации конверсии и другой при смене статуса. ID транзакции позволяет трекеру считать их одной конверсией.

Как конверсии укладываются вместе с маршрутизацией и фильтрацией ботов на одной ссылке, смотрите на странице Аналитика TDS.SO и в тарифах.