Постбэки

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

Постбэки — это 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 постбэков

https://your-tracker.com/postback?event={{event}}&sub_id={{subscriber.id}}&revenue={{subscriber.revenue}}&click_id={{click.external_click_id}}

https://your-voluum-domain.com/postback?cid={{click.external_click_id}}&payout={{subscriber.revenue}}

https://your-binom-domain.com/click/pb?cnv_id={{click.external_click_id}}&payout={{subscriber.revenue}}&event={{event}}

https://your-keitaro-domain.com/postback?subid={{click.external_click_id}}&sum={{subscriber.revenue}}&status={{event}}

Тестирование постбэков

Вы можете протестировать конфигурацию постбэка перед запуском:

Настройте URL постбэка

Введите URL постбэка с нужными макросами.

Нажмите Send Test

Используйте кнопку Send Test в форме настройки постбэка. Система отправит тестовый запрос с примерными данными на ваш URL.

Проверьте получение

Убедитесь, что ваш сервер или трекинг-платформа получили тестовый постбэк и правильно распарсили параметры.

Используйте сервис webhook.site для инспекции постбэк-запросов во время настройки. Это поможет проверить точные данные, которые отправляются, до подключения к вашему рабочему трекеру.

Постбэки лучше всего работают с OT Tracking Links, которые поддерживают параметр click_id. Это позволяет сопоставить каждую конверсию с конкретным кликом в вашем внешнем трекере.

Обзор

Платформы

Форматы работы

Выплаты и безопасность

API

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

Уровни настройки

Доступные события

`new_subscriber`

`new_transaction`

`marketing_stop`

Шаблон URL и макросы

Макрос события

Макросы кампании

Макросы подписчика

Макросы транзакции

Макросы клика

HTTP-методы

Пользовательские заголовки

Примеры URL постбэков

Тестирование постбэков

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

​Уровни настройки

​Доступные события

​new_subscriber

​new_transaction

​marketing_stop

​Шаблон URL и макросы

​Макрос события

​Макросы кампании

​Макросы подписчика

​Макросы транзакции

​Макросы клика

​HTTP-методы

​Пользовательские заголовки

​Примеры URL постбэков

​Тестирование постбэков

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

Уровни настройки

Доступные события

`new_subscriber`

`new_transaction`

`marketing_stop`

Шаблон URL и макросы

Макрос события

Макросы кампании

Макросы подписчика

Макросы транзакции

Макросы клика

HTTP-методы

Пользовательские заголовки

Примеры URL постбэков

Тестирование постбэков