Любая ПП по S2S

Эта схема подходит для любой ПП, даже если её нет в гайдах. Суть одна: ПП получает наш click id в ссылке на оффер, возвращает его в постбеке, а мы по нему находим клик. Всё остальное — статус, выплата, ID транзакции — приходит в том же запросе.

Что найти в кабинете ПП

Перед настройкой откройте кабинет ПП и найдите:

Что нужно	Как ПП это называет	Что мы с этим делаем
Поле для S2S-постбека	Postback URL, S2S postback, Постбэк, Callback	Вставляем наш URL
Макрос click id	`{subid}`, `{clickid}`, `{sub1}`, `{click_id}`	Ставим в `subid=`
Макрос статуса	`{status}`, `{state}`, `{action}`	Ставим в `status=`
Макрос выплаты	`{payout}`, `{sum}`, `{revenue}`	Ставим в `payout=`
Макрос валюты	`{currency}`	Ставим в `currency=` (необязательно)
ID транзакции	`{transaction_id}`, `{order_id}`, `{lead_id}`	Ставим в `tid=`
Список статусов	Approved, Pending, Declined, Hold, Trash и т. д.	Сверяем со словарём
Параметр в ссылке на оффер	Поле для subid или click id в настройках оффера	Пишем в URL оффера

Если ПП не умеет вернуть click id в постбеке, конверсию не к чему привязать: без click id Telegfy её не запишет, даже через импорт. Такую ПП можно использовать только с отдельной схемой отслеживания, например через пиксель или API.

Схема

Завели ПП в Telegfy.

«Партнёрские сети» → «Новая партнёрка». В поле «Параметр subid» укажите имя, которое ПП принимает в ссылке на оффер и возвращает в постбеке. Например, clickid, если ПП так называет параметр. По умолчанию subid.
1. Параметр subid.
2. URL постбэка для вставки в ПП.
Настроили оффер.

В URL оффера вставьте {{click_id}} там, где ПП ждёт click id:
```
https://offer.example.com/?aff=42&clickid={{click_id}}
```
Если в ПП параметр называется clickid, Telegfy добавит его сам по полю «Параметр subid». Явный макрос надёжнее: вы видите, куда уходит значение.
Собрали URL постбэка.

Скопируйте «Наш URL постбэка» из карточки ПП. Он выглядит так:
```
https://<домен>/postback?subid={subid}&status={status}&payout={payout}&currency={currency}&tid={transaction_id}&network_id=<id ПП>
```
Теперь замените макросы в фигурных скобках на те, что у ПП. Левую часть не трогайте.
1. Параметр subid совпадает с макросом click id.
2. URL постбэка: вставьте в ПП.
Настроили статусы.

Посмотрите список статусов в кабинете ПП и сверьте их со словарём по умолчанию (таблица ниже). Незнакомые добавьте в «Соответствие статусов» карточки ПП.
Проверили тестовым запросом.
Окно терминала
```
curl "https://<домен>/postback?subid=<click_id>&status=sale&payout=10&currency=USD&tid=test-1"
```
Ответ с "result":"accepted" — всё в порядке. Затем проверьте лог на странице «Партнёрские сети».

Строим URL: что менять, что нет

Часть URL	Можно менять	Пример замены
Имя параметра слева от `=`	Нет: `subid`, `status`, `payout`, `currency`, `tid`, `goal`, `network_id` — наши имена	—
Значение в фигурных скобках справа	Да: это макрос ПП	`status={state}`, `payout={sum}`
Значение `network_id=`	Нет: подставляется автоматически	—
Параметр `goal=`	Да, если нужна отдельная цель	`goal=upsell`, см. Цели

Словарь статусов

Telegfy знает распространённые статусы без настройки. Регистр не важен.

Наш статус	Что приходит из ПП по умолчанию
Продажа	`approved`, `approve`, `confirmed`, `sale`, `paid`, `success`
Лид	`pending`, `hold`, `lead`, `new`, `processing`
Отклонена	`rejected`, `declined`, `reject`, `trash`, `fraud`, `cancelled`
Ребилл	`rebill`
Апсейл	`upsell`

Если в ПП статусы другие, добавьте соответствие в карточке ПП. Пример:

Статус ПП	Наш статус
`approved_by_advertiser`	Продажа
`on_hold`	Лид
`1`	Продажа
`0`	Отклонена

Соответствие действует только для этой ПП. Telegfy определяет ПП по network_id в URL постбэка, а если его нет, по офферу клика. Поэтому network_id из блока «Наш URL постбэка» должен быть в URL.

Выплата и валюта

Сумма может приходить с точкой или запятой: 10,5 будет прочитана как 10.5.
Если выплата не пришла, в отчёте возьмётся выплата оффера, но только при фиксированной модели выплаты.
Валюта приводится к верхнему регистру и обрезается до трёх символов. Неверный код не переводится в базовую валюту, см. Курсы валют.

Частые ошибки

Неверный макрос click id. Статус и выплата доходят, но click_not_found. Проверьте, что subid= использует то же имя, что ПП возвращает.
Нет network_id. Соответствие статусов не применяется. Скопируйте URL из блока «Наш URL постбэка» целиком.
Больше 6000 постбеков в минуту с одного IP. Такой лимит превышают редко, но тогда будет 429. Смотрите Решение проблем.

Что читать дальше

Входящие постбеки — все параметры и ответы.
Защита постбеков — подпись и IP, если ПП это поддерживает.
Решение проблем — если конверсия не записалась.