Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://onlytraffic.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

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

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

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

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

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

Нажмите Send Test

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

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

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