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

# Постбэки

> Настройка постбэк-уведомлений для CPL кампаний на OnlyTraffic. События, макросы URL и интеграция с внешними трекерами.

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

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

<CodeGroup>
  ```text Простой GET theme={null}
  https://your-tracker.com/postback?event={{event}}&sub_id={{subscriber.id}}&revenue={{subscriber.revenue}}&click_id={{click.external_click_id}}
  ```

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

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

  ```text Keitaro theme={null}
  https://your-keitaro-domain.com/postback?subid={{click.external_click_id}}&sum={{subscriber.revenue}}&status={{event}}
  ```
</CodeGroup>

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

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

<Steps>
  <Step title="Настройте URL постбэка">
    Введите URL постбэка с нужными макросами.
  </Step>

  <Step title="Нажмите Send Test">
    Используйте кнопку **Send Test** в форме настройки постбэка. Система отправит тестовый запрос с примерными данными на ваш URL.
  </Step>

  <Step title="Проверьте получение">
    Убедитесь, что ваш сервер или трекинг-платформа получили тестовый постбэк и правильно распарсили параметры.
  </Step>
</Steps>

<Tip>
  Используйте сервис [webhook.site](https://webhook.site) для инспекции постбэк-запросов во время настройки. Это поможет проверить точные данные, которые отправляются, до подключения к вашему рабочему трекеру.
</Tip>

<Info>
  Постбэки лучше всего работают с [OT Tracking Links](/ru/partners/tracking-links), которые поддерживают параметр `click_id`. Это позволяет сопоставить каждую конверсию с конкретным кликом в вашем внешнем трекере.
</Info>