Что такое постбэки?
Постбэки — это HTTP-уведомления, которые OnlyTraffic отправляет на ваш сервер или трекинг-платформу при наступлении определённых событий — например, подписка нового фана или совершение транзакции. Они позволяют отслеживать конверсии в реальном времени без ручной проверки дашборда.Уровни настройки
Постбэки можно настроить на двух уровнях:| Уровень | Область действия | Когда использовать |
|---|---|---|
| На уровне аккаунта (по умолчанию) | Действует для всех ваших кампаний | Настройте один раз — работает везде |
| На уровне кампании | Переопределяет настройки по умолчанию для конкретной кампании | Индивидуальный трекинг для кампании |
Доступные события
new_subscriber
Срабатывает, когда новый фан подписывается через вашу кампанию.
new_transaction
Срабатывает, когда фан совершает покупку (донат, платное сообщение, платный пост, подписка, переподписка или стрим).
marketing_stop
Срабатывает, когда кампания или CPL заказ останавливается (завершён, отменён или приостановлен).
Шаблон URL и макросы
Создайте URL постбэка с помощью макросов, которые заменяются реальными значениями при наступлении события.Макрос события
| Макрос | Описание |
|---|---|
{{event}} | Название события: new_subscriber, new_transaction или marketing_stop |
Макросы кампании
| Макрос | Описание |
|---|---|
{{campaign.id}} | ID маркетинговой кампании |
{{campaign.name}} | Название кампании (URL-encoded) |
{{campaign.date_create}} | Дата создания кампании (UNIX timestamp) |
{{campaign.onlyfans_id}} | ID аккаунта модели в OnlyFans |
{{campaign.order_id}} | ID CPL заказа (для события marketing_stop) |
{{campaign.date_finish}} | Дата завершения кампании, UNIX timestamp (для события marketing_stop) |
Макросы подписчика
Доступны для событийnew_subscriber и new_transaction:
| Макрос | Описание |
|---|---|
{{subscriber.id}} | ID подписчика в OnlyFans |
{{subscriber.campaign_id}} | ID маркетинговой кампании |
{{subscriber.onlyfans_id}} | ID аккаунта модели в OnlyFans |
{{subscriber.name}} | Имя подписчика (URL-encoded) |
{{subscriber.revenue}} | Общая комиссия, заработанная с этого подписчика |
{{subscriber.date_subscribe}} | Дата подписки (UNIX timestamp) |
{{subscriber.click_id}} | Ваш click ID (при использовании трекинг-ссылок) |
Макросы транзакции
Доступны для событияnew_transaction:
| Макрос | Описание |
|---|---|
{{transaction.id}} | Уникальный ID транзакции |
{{transaction.campaign_id}} | ID маркетинговой кампании |
{{transaction.subscriber_id}} | ID подписчика в OnlyFans |
{{transaction.onlyfans_id}} | ID аккаунта модели в OnlyFans |
{{transaction.type}} | Тип: tip, message, post, subscription, resubscription, stream, other |
{{transaction.amount}} | Общая сумма транзакции |
{{transaction.revenue}} | Ваша комиссия с этой транзакции |
{{transaction.date}} | Дата транзакции (UNIX timestamp) |
Макросы клика
Доступны при использовании OT Tracking Links или Smart Links:| Макрос | Описание |
|---|---|
{{click.click_id}} | Внутренний ID клика |
{{click.url}} | URL перенаправления на OnlyFans |
{{click.external_click_id}} | Ваш пользовательский click ID (переданный через параметр click_id) |
{{click.expires_ts}} | Дата истечения URL (UNIX timestamp) |
{{click.expires}} | Дата истечения URL (строка ISO 8601) |
HTTP-методы
| Метод | Поведение |
|---|---|
| GET | Макросы размещаются непосредственно в строке запроса URL |
| POST | Макросы можно использовать как в URL, так и в теле запроса |
Пользовательские заголовки
Вы можете добавить пользовательские HTTP-заголовки к постбэк-запросам. Это полезно для:- Токенов аутентификации (например,
Authorization: Bearer your_token) - Указания типа контента (например,
Content-Type: application/json) - Любых заголовков, которые требует ваша трекинг-платформа
Примеры URL постбэков
Тестирование постбэков
Вы можете протестировать конфигурацию постбэка перед запуском:Нажмите Send Test
Используйте кнопку Send Test в форме настройки постбэка. Система отправит тестовый запрос с примерными данными на ваш URL.
Постбэки лучше всего работают с OT Tracking Links, которые поддерживают параметр
click_id. Это позволяет сопоставить каждую конверсию с конкретным кликом в вашем внешнем трекере.