Перейти к основному содержанию
Callbacks (постбэки) позволяют получать уведомления о событиях в реальном времени: новые подписчики, транзакции и клики по Smart Links. Данные отправляются на ваш URL с заполненными макросами.

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

СобытиеКогда срабатывает
new_subscriberНовый фанат подписался через вашу ссылку
new_transactionФанат совершил покупку (PPV, чаевые, подписка и др.)
smartlink_clickКлик по Smart Link (только для Smart Links)
marketing_stopКампания остановлена

​
Настройка

Callbacks настраиваются на трёх уровнях:
  1. По умолчанию — в настройках аккаунта. Применяется ко всем новым кампаниям.
  2. На кампанию — индивидуальная настройка для конкретной кампании.
  3. На Smart Link — настройка при создании Smart Link.
Для каждого события можно настроить отдельно:
  • URL с макросами
  • HTTP метод — GET или POST
  • Тело запроса (для POST) с макросами
  • Заголовки — произвольные HTTP-заголовки

​
Макросы

​
Подписчик (new_subscriber)

МакросОписание
{{event}}new_subscriber
{{campaign.id}}ID кампании
{{campaign.name}}Название кампании
{{subscriber.id}}ID подписчика на OnlyFans
{{subscriber.name}}Имя подписчика
{{subscriber.revenue}}Ваш общий доход от этого подписчика
{{subscriber.date_subscribe}}Дата подписки (UNIX)
{{subscriber.click_id}}Внешний click_id (Smart Links)

​
Транзакция (new_transaction)

МакросОписание
{{event}}new_transaction
{{transaction.id}}ID транзакции
{{transaction.type}}Тип: tip, message, post, subscription, resubscription, stream
{{transaction.amount}}Сумма транзакции
{{transaction.revenue}}Ваша доля
{{transaction.date}}Дата транзакции (UNIX)
{{subscriber.click_id}}Внешний click_id (Smart Links)
МакросОписание
{{event}}smartlink_click
{{click.click_id}}Внутренний ID клика
{{click.external_click_id}}Ваш click_id из URL
{{click.url}}URL перенаправления
{{click.expires_ts}}Время истечения (UNIX)
{{click_params.*}}Любые параметры из params[key] в URL

​
Остановка кампании (marketing_stop)

МакросОписание
{{event}}marketing_stop
{{campaign.id}}ID кампании
{{campaign.name}}Название кампании
{{campaign.date_create}}Дата создания (UNIX)
{{campaign.date_finish}}Дата остановки (UNIX)

​
Примеры

GET-запрос для трекера: 
https://tracker.example.com/postback?event={{event}}&click_id={{subscriber.click_id}}&revenue={{transaction.revenue}}&type={{transaction.type}}
POST-запрос с JSON: URL: https://api.example.com/webhook Тело: 
{
  "event": "{{event}}",
  "click_id": "{{subscriber.click_id}}",
  "revenue": "{{transaction.revenue}}",
  "subscriber": "{{subscriber.name}}"
}

​
Тестирование

В интерфейсе настройки callbacks есть кнопка Test — она отправляет тестовый запрос с заполненными макросами, чтобы вы могли проверить интеграцию перед запуском.

​
Обработка запросов

  • Запросы отправляются с User-Agent: OnlyTraffic-postback
  • Таймаут: 20 секунд
  • При ошибках соединения (таймаут, отказ, SSL) — до 3 повторных попыток
  • Лог всех отправленных callbacks доступен в разделе Postbacks