Postback URL
URL задается в блоке Destinations у ссылки. Он вызывается на каждом событии конверсии этой ссылки: новые подписчики, транзакции и диалоги в чате. Различайте их на своей стороне через макрос{{event}}.
{{transaction.amount}} пуст в событии подписки.
Макросы
Клик
| Макрос | Значение |
|---|---|
{{subscriber.click_id}} | Клик-идентификатор: ваш параметр click_id, если передавали, иначе захваченный идентификатор рекламной платформы |
{{click.external_click_id}} | Тот же идентификатор, из записи клика |
{{click.ip}} | IP посетителя в момент клика |
{{click.user_agent}} | User agent посетителя в момент клика |
{{click.country}} | Код страны посетителя |
{{click_params.*}} | Любые params[key]=value, добавленные вами к URL ссылки |
Подписчик
| Макрос | Значение |
|---|---|
{{subscriber.id}} | OnlyFans ID фаната |
{{subscriber.username}} | Маскированный username фаната |
{{subscriber.name}} | Отображаемое имя фаната |
{{subscriber.revenue}} | Доход с этого фаната на текущий момент |
{{subscriber.date_subscribe_iso}} | Время подписки, ISO 8601 |
Транзакция (только транзакционные события)
| Макрос | Значение |
|---|---|
{{transaction.id}} | ID транзакции |
{{transaction.type}} | subscription, resubscription, tip, message, post, stream |
{{transaction.amount}} | Сумма в USD за вычетом комиссии OnlyFans |
{{transaction.revenue}} | Для собственных ссылок совпадает с amount |
{{transaction.date_iso}} | Время транзакции, ISO 8601 |
Кампания
| Макрос | Значение |
|---|---|
{{event}} | new_subscriber, new_transaction или new_dialog |
{{campaign.id}} | ID кампании за ссылкой |
{{campaign.name}} | Название ссылки |
{{onlyfans.username}} | Username вашего аккаунта OnlyFans |
{{smartlink.hash}} | Hash ссылки |
Правила доставки
- Событие ставится в очередь в момент обнаружения конверсии и обычно уходит в течение минуты.
- Ваш endpoint должен быть доступен публично по HTTP или HTTPS. HTTPS-сертификаты проверяются.
- Любой HTTP-ответ завершает доставку; код и тело ответа сохраняются в логе.
- Если запрос не удался (таймаут, отказ соединения), повторяем до 3 попыток с интервалом 10 минут.
- Остановленная ссылка события конверсий больше не шлет. Исключение:
marketing_stop, чтобы трекер мог закрыть кампанию.
Лог доставки
Tracking Links > Logs показывает каждую доставку по всем вашим ссылкам: пиксели и кастомные постбэки в одном месте. Фильтруйте по ссылке, событию, платформе и статусу, раскрывайте строку и смотрите точный запрос и точный ответ.| Статус | Значение |
|---|---|
| Доставлен | Endpoint или рекламная платформа приняли событие |
| Ошибка | Запрос не прошел, вернулся код вне 2xx, либо платформа отклонила событие. Причина в теле ответа |
| В очереди | Ожидает отправки или следующей попытки |
| Пропущен | Не отправлен намеренно: ссылка остановлена или пиксель заархивирован до доставки |
click_id, оформите подписку и наблюдайте, как событие появляется и доставляется.
Access-токены и другие секреты в записях запросов замаскированы.
Тестовые события пикселей с кнопки Test уходят напрямую в Test Events платформы и в этом логе не появляются. Лог показывает реальный конверсионный трафик.
Решение проблем
В логе нет строк
В логе нет строк
Конверсий еще не было. Сами по себе клики доставок не создают: события возникают, когда фанат подписывается, платит или переписывается. Сначала проверьте фанатов в статистике ссылки.
Доставки со статусом «Ошибка»
Доставки со статусом «Ошибка»
Раскройте строку. Код и тело ответа: это ответ самого endpoint. 404 значит неправильный путь URL, 401/403 значит трекер ждет другие креденшалы, ошибка Meta или TikTok называет конкретное отклоненное поле.
Трекер видит конверсию без клик-идентификатора
Трекер видит конверсию без клик-идентификатора
Посетитель пришел без параметра
click_id, и идентификатор рекламной платформы не был захвачен. Проверьте, что реклама ведет на URL трекинг-ссылки с &click_id={макрос_трекера}, заполняемым трекером.Доставки прекратились после остановки ссылки
Доставки прекратились после остановки ссылки
Так задумано: остановка окончательна, события конверсий больше не отправляются, включая фанатов, привлеченных раньше.