Что такое постбеки?

постбек — это автоматический HTTP-запрос, отправляемый системой (Affiliate TOP) на сервер используемого вами трекера (например, Keitaro, Voluum, RedTrack) или CRM. Он передает информацию о действиях пользователя, таких как регистрация, пополнение счета, вывод средств, установка приложения, совершение сделок и т.д.

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

С помощью постбеков можно:

• Анализировать трафик в реальном времени

• Быстро корректировать ваши стратегии для улучшения результатов кампании и увеличения прибыли

• Быстро находить и масштабировать прибыльные источники трафика

Что такое URL постбека?

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

Где найти URL постбека?

URL постбека можно найти в настройках вашего трекера для мониторинга трафика или CRM (Keitaro, Voluum, RedTrack и т.д.) в разделе настройки постбека / S2S отслеживания.

Примеры URL постбека для Топ 3 трекеров

Ниже представлены примеры того, как выглядят постбеки, и как настроить наши параметры.

Keitaro

Пример URL постбека: http://your-keitaro.com/postback?clickid={click_id}&status=approved&payout={sumdep}

Название параметра clickid взято из документации Keitaro
{click_id}, {sumdep} – наши плейсхолдеры

Voluum

Пример URL постбека: https://your-voluum.com/postback?cid={click_id}&payout={sumdep}

Название параметра cid — стандартное ID клика для трекера Voluum
{click_id}, {sumdep} – наши плейсхолдеры

RedTrack

Пример URL постбека:

https://your-redtrack.com/postback?clickid={click_id}&revenue={sumdep}&status=approved

Названия параметров clickid и revenue взяты из документации RedTrack
{click_id}, {sumdep} – наши плейсхолдеры

Важно: Названия параметров (clickid, cid, revenue) должны в точности соответствовать требованиям вашего трекера, в то время как в фигурных скобках ({click_id}, {sumdep}) располагаются наши плейсхолдеры.

Как работает URL постбека и параметры

Каждый параметр состоит из двух частей:

название параметра – то, что ожидает увидеть ваш трекер / CRM (взято из их документации)
наш плейсхолдер в фигурных скобках – подставляется автоматически

Например – visitor_id={click_id}

Где:

visitor_id – название параметра из документации трекера. Отправляется как есть. Это точное название, под которым ваш трекер ожидает получить данные
{click_id} – наш плейсхолдер. При возникновении события заменяется реальным ID клика.

Левая сторона (visitor_id, campaign_id, sub_id) – требования трекера.
Правая сторона ({click_id}, {campaign_id}) – данные AffiliateTop.

Где найти URL постбека и названия параметров

Войдите в ваш инструмент мониторинга (трекер или CRM)
Найдите раздел постбек / S2S-отслеживание
Скопируйте базовый URL постбека и названия параметров из интерфейса или документации трекера
Вставьте URL постбека в наши настройки и добавьте наши плейсхолдеры: visitor_id={click_id}, amount={sumdep} и т.д.

Пример полной структуры URL постбека

Перед событием (с плейсхолдерами) – https://your-tracker.com/postback?visitor_id={click_id}&site_id={site_id}&trader={trader_id}&amount={deposit_amount}&campaign_id={campaign_id}

После события (реальные значения) – https://your-tracker.com/postback?visitor_id=1234567&site_id=4458&trader=902134&amount=23.22&campaign_id=YT_BR_01

Параметры постбека: формат, примеры и цель

1. ID клика

Наш плейсхолдер: {click_id}
В URL трекера: visitor_id={click_id} → visitor_id=1234567
Цель: Связывает конверсию с конкретным кликом. Трекер знает, какой источник трафика конвертировался
Значение: Этот параметр отвечает за передачу уникального значения клика, которое вы получаете от трекера

2. ID веб-сайта

Наш плейсхолдер: {site_id}
В URL: site_id={site_id} → site_id=4458
Цель: Показывает, какой сайт сгенерировал трафик. Помогает оптимизировать закупки трафика
Значение: ID веб-сайта в вашей рекламной сети

3. ID трейдера

Наш плейсхолдер: {trader_id}
В URL: trader={trader_id} → trader=902134
Цель: Собирает единую статистику обо всех действиях пользователя (счета, пополнения, сделки)
Значение: Постоянный идентификатор трейдера, присваиваемый при регистрации

4. ID вашего счета

Наш плейсхолдер: {a}
В URL: account={a} → account=a182haj2nn
Цель: Идентифицирует вашу партнерскую ссылку. Может пригодиться для управления несколькими счетами
Значение: Ваш реферальный код. Обычно у каждого партнера один реферальный код

5. Сумма депозита

Наш плейсхолдер: {sumdep}
В URL: amount={sumdep} → amount=23.22
Цель: Показывает точные суммы пополнения счета (как для первого депозита, так и для последующих). Используется для расчета ROI и анализа LTV
Значение: Сумма депозита в выбранной валюте ($ или ¢). Используется только для событий, связанных с пополнением счета, таких как FTD или повторный депозит

6. ID транзакции

Наш плейсхолдер: {transaction}
В URL: tx_id={transaction} → tx_id=81283192873
Цель: Уникальный идентификатор транзакции. Предотвращает возникновение дубликатов и обеспечивает точную атрибуцию
Значение: Внутренний ID конкретного события (пополнение счета, вывод средст и т.д.)

7. ID рекламной кампании

Наш плейсхолдер: {ac}
В URL: campaign_id={ac} → campaign_id=YT_BR_01
Цель: Разделяет статистику по различным кампаниям (гео, креативы, лендинги)
Значение: Название или ID вашей рекламной кампании из реферальной ссылки

8. ID субсчета постбека

Наш плейсхолдер: {sa}
В URL: sub_id={sa} → sub_id=teaser_01
Цель: Предоставляет дополнительную аналитику (тип трафика, креатив, вебмастер)
Значение: Любое значение из вашей реферальной ссылки (sub1, sub2 и т.д.)

9. Доход

Наш плейсхолдер: {profit}
В URL: profit={profit} → profit=15.75
Цель: Показывает сумму прибыли/убытка от реальных сделок. Важно для отслеживания доходов и анализа производительности
Значение: Чистая прибыль (положительная или отрицательная) от реальной торговой активности пользователя. Доступно для событий реальной торговли

Триггеры постбеков

Affiliate TOP поддерживает постбеки для действий пользователей, перечисленных ниже. 1 постбек = 1 событие. Определите, какое событие вы хотите отслеживать, и добавьте необходимые параметры в ваш URL постбека.

Регистрация – пользователь завершает регистрацию аккаунта
Подтверждение адреса email – пользователь подтверждает адрес электронной почты
Первый депозит (FTD) – первый депозит пользователя
Повторный депозит – любой последующий депозит (повторные депозиты)
Приложение установлено – пользователь устанавливает мобильное приложение
Первая сделка на демо-счете – первая сделка пользователя на демо-счете
Вывод средств – пользователь совершает вывод средств
Реальная сделка – пользователь совершает сделку на реальном счете

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

Как настроить постбек

Нажмите кнопку «Добавить», чтобы начать процесс настройки постбека, и заполните обязательные поля в соответствии с вашими предпочтениями.

Название постбека – придумайте четкое и уникальное название для каждого из ваших постбеков, чтобы избежать путаницы (например, "FTD_YT_BR")
Событие – выберите событие из выпадающего списка (регистрация, первый депозит и т.д.)
URL постбека – вставьте URL из документации вашего трекера (смотрите примеры выше)
Параметры – добавьте необходимые параметры, выбрав их под полем «URL постбека» («ID клика», «Сумма депозита» и т.д.)
Метод – GET (по умолчанию)
Валюта – выберите $ или ¢

7. Фильтры сегментации

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

Для чего нужны фильтры сегментации?

Они позволяют более эффективно управлять движением трафика, в том числе:

оптимизировать настройку различных источников трафика независимо друг от друга – если вы используете несколько инструментов мониторинга, при помощи фильтров сегментации можно настроить один инструмент для базовых событий, а другой – для событий с дополнительными параметрами.
проводить A/B-тесты – фильтры сегментации позволяют определить, какие источники приносят больше конверсий и как работают различные кампании, креативы и лендинги.
безопасно тестировать или переносить инструменты — вы можете отправлять постбеки на новый инструмент мониторинга параллельно со старым и сравнить показатели перед окончательным переходом.

Как система определяет, когда отправлять постбек:

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

(Примечание: после активации отправка постбека происходит в течение 15 секунд при каждом возникновении выбранного события и соблюдении условий.)

8. Решите, хотите ли вы активировать постбек сразу после его настройки, и завершите процесс, нажав кнопку «Добавить»

Статусы постбеков

Жизненный цикл постбека состоит из нескольких статусов. Вот что означает каждый статус и что вызывает изменения статуса:

Проверка (~15 секунд) – этот статус автоматически присваивается всем постбекам, которые вы добавляете, редактируете или копируете
- Если с постбеком все в порядке → он становится Активным.
- Если система обнаружила ошибки → постбеку присваивается статус Неактивен с сообщением об ошибке.
- постбек нельзя редактировать или приостанавливать – только удалять
Активен – ваш постбек работает корректно и собирает необходимые данные
- При редактировании → ваш постбек временно возвращается в статус Проверка.
- При возникновении 10 последовательных HTTP 3xx/4xx ошибок → постбек автоматически деактивируется, возникает сообщение об ошибке, и на электронную почту отправляется уведомление.
Неактивен – система обнаружила ошибки в настройке постбека, вы деактивировали его вручную, либо превышен лимит ошибок. Чтобы перевести постбек обратно в статус Активен, нужно внести необходимые исправления и активировать его

Ключевые действия:

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

Раздел «Логи»

В разделе «Логи» вы можете просмотреть все постбеки, созданные вами за последние 30 дней. Благодаря этому можно сразу определить, что требует исправления.

Список возможных ошибок:

Если с постбеком возникла какая-то проблема, в первую очередь стоит проверить раздел «Логи» и узнать код ошибки.

Error 3xx – Ошибки перенаправления

Сервер говорит: «Перейдите по другому адресу вместо этого»

Значение: Ваш постбек отправляется по какому-то другому адресу.

Основные причины:

- URL постбека автоматически перенаправляет его по другому адресу (HTTP→HTTPS, www/non-www, трекинговые ссылки)

- Сервер или трекер перенаправляет запросы на другой адрес

- Ваш сервер тайно изменяет URL

Как исправить?

1. Скопируйте ваш URL постбека

2. Вставьте его в адресную строку браузера и нажмите Enter

3. Подождите, пока он загрузится (или перестанет перенаправляться)

4. Скопируйте то, что видите в адресной строке сейчас — это и есть ваш URL постбека

Error 4xx – Ошибки на стороне клиента

Сервер говорит: «Что-то не так с вашим запросом»

Значение: Обычно эта ошибка говорит о том, что постбек настроен неверно.

Основные причины:

- 404: URL постбека не существует (опечатка в адресе, домене или параметрах)

- 400/422: Необходимые параметны отсутствуют или недействительны (ID клика, статус, сумма)

- 403/401: Сервер блокирует запрос (фаервол, белый список IP, требуется авторизация)

Как исправить?

Скопируйте ваш полный URL постбека (со всеми параметрами, такими как ID клика)
Убедитесь, что он в точности совпадает с настройками вашего сервера
Попробуйте открыть его в браузере — появляется ли сообщение «страница не найдена»?
Исправьте ошибку (например, неправильно указан домен или часть информации отсутствует) и обновите страницу