> ## 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.

# Постбэки и лог доставки

> Отправка конверсий трекинг-ссылок в ваш трекер через макросы и просмотр каждой доставки, запроса и ответа в логе.

Помимо [пикселей](/ru/tracking-links-pixels), каждая трекинг-ссылка может дергать ваш собственный URL на каждой конверсии. Так подключаются Keitaro, Binom, Voluum, endpoint таблицы или любой свой бэкенд.

## Postback URL

URL задается в блоке **Destinations** у ссылки. Он вызывается на каждом событии конверсии этой ссылки: новые подписчики, транзакции и диалоги в чате. Различайте их на своей стороне через макрос `{{event}}`.

```
https://your-tracker.com/postback?event={{event}}&click_id={{subscriber.click_id}}&amount={{transaction.amount}}
```

Макросы заполняются на каждое событие и автоматически URL-кодируются. Поля, не относящиеся к текущему событию, подставляются пустой строкой: например, `{{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 ссылки                                          |

<Tip>
  Пикер макросов под полем URL в Студии вставляет любой из них одним кликом, вручную набирать не нужно.
</Tip>

## Правила доставки

* Событие ставится в очередь в момент обнаружения конверсии и обычно уходит в течение минуты.
* Ваш endpoint должен быть доступен публично по HTTP или HTTPS. HTTPS-сертификаты проверяются.
* Любой HTTP-ответ завершает доставку; код и тело ответа сохраняются в логе.
* Если запрос не удался (таймаут, отказ соединения), повторяем до 3 попыток с интервалом 10 минут.
* Остановленная ссылка события конверсий больше не шлет. Исключение: `marketing_stop`, чтобы трекер мог закрыть кампанию.

## Лог доставки

**Tracking Links > Logs** показывает каждую доставку по всем вашим ссылкам: пиксели и кастомные постбэки в одном месте. Фильтруйте по ссылке, событию, платформе и статусу, раскрывайте строку и смотрите точный запрос и точный ответ.

| Статус    | Значение                                                                                        |
| --------- | ----------------------------------------------------------------------------------------------- |
| Доставлен | Endpoint или рекламная платформа приняли событие                                                |
| Ошибка    | Запрос не прошел, вернулся код вне 2xx, либо платформа отклонила событие. Причина в теле ответа |
| В очереди | Ожидает отправки или следующей попытки                                                          |
| Пропущен  | Не отправлен намеренно: ссылка остановлена или пиксель заархивирован до доставки                |

Лог обновляется каждые 10 секунд, держите его открытым во время теста: кликните свою ссылку с тестовым `click_id`, оформите подписку и наблюдайте, как событие появляется и доставляется.

Access-токены и другие секреты в записях запросов замаскированы.

<Info>
  Тестовые события пикселей с кнопки **Test** уходят напрямую в Test Events платформы и в этом логе не появляются. Лог показывает реальный конверсионный трафик.
</Info>

## Решение проблем

<AccordionGroup>
  <Accordion title="В логе нет строк">
    Конверсий еще не было. Сами по себе клики доставок не создают: события возникают, когда фанат подписывается, платит или переписывается. Сначала проверьте фанатов в статистике ссылки.
  </Accordion>

  <Accordion title="Доставки со статусом «Ошибка»">
    Раскройте строку. Код и тело ответа: это ответ самого endpoint. 404 значит неправильный путь URL, 401/403 значит трекер ждет другие креденшалы, ошибка Meta или TikTok называет конкретное отклоненное поле.
  </Accordion>

  <Accordion title="Трекер видит конверсию без клик-идентификатора">
    Посетитель пришел без параметра `click_id`, и идентификатор рекламной платформы не был захвачен. Проверьте, что реклама ведет на URL трекинг-ссылки с `&click_id={макрос_трекера}`, заполняемым трекером.
  </Accordion>

  <Accordion title="Доставки прекратились после остановки ссылки">
    Так задумано: остановка окончательна, события конверсий больше не отправляются, включая фанатов, привлеченных раньше.
  </Accordion>
</AccordionGroup>