Обзор постбеков
Постбеки позволяют партнерам получать уведомления в режиме реального времени сервер-сервер при наступлении определённых событий конверсии, таких как регистрации или покупки.
Интегрируя постбеки с вашей системой отслеживания, вы можете автоматически получать данные о конверсиях и сопоставлять их с исходным кликом. Это обеспечивает точное распределение и согласованную отчетность как в вашей системе, так и в нашей.
Когда пользователь кликает по вашей партнерской ссылке, мы записываем передаваемые вами параметры (например, click_id). Полный список поддерживаемых макросов параметров вы можете посмотреть в таблице здесь: [Ссылка].
Когда происходит конверсия, мы отправляем сервер-сервер запрос на настроенный вами URL постбека, что позволяет вашей системе сопоставить конверсию с исходным кликом.
Виды постбеков
В настоящее время мы поддерживаем два типа постбеков:
Динамические постбеки (рекомендуется)
- Поддержка динамических параметров в URL постбека
- Совместимость с основными платформами отслеживания (например, Voluum)
- Возможность использовать отдельные URL для каждого типа конверсии (регистрации и покупки)
- Обеспечивает большую гибкость и детализированную отчетность
Статические постбеки (устаревшие)
- Не поддерживают динамические параметры в URL постбека
- Возвращают ограниченный набор предопределённых данных
Обе опции полностью поддерживаются. Планов по отмене поддержки статических постбеков нет.
Как настроить динамические постбеки
- Перейдите по адресу:
https://chaturbate.com/affiliates/devkit/dynamic_postback/ - Выберите «Добавить новый URL» во вкладке Динамические постбеки.
- Введите ваш URL постбека и добавьте поддерживаемые макросы для получения нужных данных. Например:
https://example.com/postback?click_id={click_id}&payout={payout}&country={country} - Выберите тип транзакции (Регистрация или Покупка), если хотите разделять события.
- (Опционально) Если ваша платформа отслеживания поддерживает проверку контрольной суммы, введите Validation Salt для проверки подлинности постбека.
- Выберите метод передачи: GET (наиболее распространённый) или POST.
Как работают динамические постбеки
- Пользователь кликает по вашей партнерской ссылке.
-
Мы записываем ваш
click_idи любые дополнительные параметры URL, которые вы передали. - Когда пользователь завершает регистрацию, мы отправляем сервер-сервер постбек на указанный вами URL, включая определённые вами макросы.
- Если пользователь совершает покупку в будущем, мы отправляем постбек о покупке с использованием тех же параметров, сохранённых при регистрации, что обеспечивает точное распределение.
Список макросов и определения
Эти макросы можно использовать в динамических постбеках в партнерской программе.
Некоторые макросы генерируются системой в момент конверсии (например, {payout} или {currency}), в то время как другие — это параметры, передаваемые партнером, которые исходят из вашей партнерской ссылки (например, {click_id} или {track_id}).
Параметры динамического постбека
| Категория | Макрос | Описание | Как заполняется |
| Конверсия | {click_id} |
Уникальный идентификатор каждого клика по рекламе, используемый для отслеживания конкретного взаимодействия пользователя, приведшего к конверсии. Ограничение по символам: 1024 |
Параметр, переданный партнером |
| Конверсия | {source} |
Источник трафика, указанный в партнерской ссылке Ограничение по символам: 255 |
Параметр, переданный партнером |
| Отслеживание | {track} |
Используется для группировки трафика по нескольким источникам с вашей стороны, например, "websiteA", "websiteB" Ограничение по символам: 255 |
Параметр, переданный партнером |
| Идентификация транзакции | {transaction_id} | Уникальный идентификатор события конверсии (регистрация, покупка) | Генерируется системой |
| Идентификация кампании | {campaign_id} | Уникальный идентификатор кампании | Генерируется системой |
| Идентификация оффера | {program_id} | Уникальный идентификатор программы/оффера | Генерируется системой |
| Идентификация оффера | {program_name} | Название программы/оффера (например, $1.00 за регистрацию + $50.00 за каждого ведущего + 5% дохода от привлечённых партнёров и т.д.) | Генерируется системой |
| Идентификация пользователя | {user_id} | Уникальный идентификатор привлечённого пользователя | Генерируется системой |
| Конверсия | {type} |
Тип произошедшей конверсии. Возможные значения: tokens_signup-referral, tokens_broadcaster-referral, ppr_signup-referral, ppr_broadcaster-referral, revshare_signup-referral, revshare_broadcaster-referral, revshare_purchase, revshare_webmaster-commission, и revshare_payout-adjustment |
Генерируется системой |
| Конверсия | {payout} | Сумма денег, начисленная партнеру за эту конверсию (отрицательная при возвратах) | Генерируется системой |
| Конверсия | {currency} | Валюта, в которой производится выплата | Генерируется системой |
| Конверсия | {amount} | Сумма, потраченная пользователем | Генерируется системой |
| Конверсия | {token} | Количество токенов, начисленных партнеру за эту конверсию | Генерируется системой |
| Действие пользователя | {timestamp} | Временная метка, когда была выполнена конверсия | Генерируется системой |
| Действие пользователя | {date} | Дата выполнения конверсии | Генерируется системой |
| Действие пользователя | {time} | Время выполнения конверсии | Генерируется системой |
| Геолокация | {country} | Страна пользователя | Генерируется системой |
| Устройство и браузер | {device} | Устройство, используемое пользователем (мобильное, десктоп) | Генерируется системой |
| Устройство и браузер | {language} | Языковые настройки браузера пользователя | Генерируется системой |
| Реферальная ссылка | {referral} | URL реферера | Генерируется системой |
| Повторы | {attempt} | Количество попыток отправки запроса до получения корректного ответа (до 6 попыток) | Генерируется системой |
| Геолокация | {region} | Регион или штат пользователя | Генерируется системой |