ПП и офферы

Партнёрская сеть (ПП) — компания, которая платит за конверсии. Оффер — конкретное предложение этой ПП: ссылка, страны, выплата. Сначала заводим ПП, потом офферы в её составе.

Партнёрская сеть

Откройте «Партнёрские сети» (/dashboard/offers/networks) и нажмите «Новая партнёрка».

Поле	Что вписать
Название	Как в кабинете ПП
Параметр subid	Имя параметра, в котором ПП принимает и возвращает click id. По умолчанию `subid`.
Шаблон постбэка	Справочная заметка. Telegfy её не использует.
Активна	Неактивная ПП скрыта при создании офферов.

После сохранения в диалоге редактирования появится блок «Наш URL постбэка». Его вставляете в ПП. Как собрать этот URL для нестандартной ПП, см. Любая ПП по S2S.

Диалог редактирования партнёрской сети с параметром subid и URL постбэка

Параметр subid. Совпадает с именем, которое ПП возвращает в постбеке.
Наш URL постбэка. Вставьте в настройки ПП.

Статусы конверсий

ПП присылает свои статусы: approved, pending, declined и т. д. Telegfy переводит их в свои пять статусов: лид, продажа, отклонена, ребилл, апсейл.

Словарь по умолчанию

Регистр не важен. Статусы, которых нет в словаре, записываются как лид и помечаются в логе.

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

Свой словарь для ПП

Если ПП использует свои названия или цифры, добавьте соответствие в её диалоге: блок «Соответствие статусов». Слева пишете статус ПП, справа — наш.

Примеры:

approved_by_advertiser → Продажа
on_hold → Лид
1 → Продажа, 0 → Отклонена, если ПП шлёт цифры

Своё соответствие имеет приоритет над словарём по умолчанию. Оно действует для конкретной ПП. Telegfy определяет ПП по параметру network_id в URL постбэка. Если его нет, ПП определяется по офферу клика.

Правила понижения

Лид не понижает продажу: поздний лид после продажи ничего не меняет.
Статус можно сменить на более поздний, например продажа → отклонена при возврате. Конверсия обновится. Выручка в отчётах считается только по продажам, ребиллам и апсейлам, поэтому отклонённая продажа из дохода выпадет.

Офферы

Откройте «Офферы» (/dashboard/offers) и нажмите «Новый оффер».

Поле	Что вписать
Название	Для вас, например «Keto Slim — DE»
Партнёрка	ПП из списка. Без ПП тоже можно, но тогда click id добавляется параметром `_la_ct`, который ПП, скорее всего, не вернёт. Привязывайте оффер к ПП.
URL оффера	Ссылка из кабинета ПП с макросами
Страны	Для вас и отчётов. Правило не проверяет страну.
Выплата и валюта	Сумма и валюта выплаты, если ПП не присылает их в постбеке
Модель выплаты	«Фиксированная» или «Из постбэка»
Дневной и общий кап	Лимиты конверсий (см. ниже)
Группа, заметки	Для вас
Статус	«Активен», «На паузе», «В архиве». Служебный «Авто-отключён» ставит система.

Макросы в URL оффера

Макросы пишутся в двойных фигурных скобках. Они подставляются при переходе на оффер.

Макрос	Что подставится
`{{click_id}}`	Click id клика
`{{country}}`, `{{city}}`	Страна и город по IP
`{{device}}`, `{{browser}}`, `{{os}}`, `{{language}}`	Тип устройства, браузер, ОС, язык
`{{ip_hash}}`, `{{visitor_id}}`	Хэш IP и ID посетителя
`{{timestamp}}`, `{{random}}`	Unix-время клика и случайное значение
`{{postback_sign}}`	Подпись для защиты постбеков, см. защиту постбеков
`{{sub_id_1}}`, `{{utm_source}}`	Значение query-параметра входящей ссылки с таким же именем

Что важно:

Неизвестный макрос удаляется и превращается в пустую строку.
Значения подставляются без URL-кодирования. Если значение содержит & или пробел, кодируйте его сами.
Вставляйте {{click_id}} явно туда, где ПП ждёт click id. Надёжнее, чем полагаться на автоматическое добавление параметра.

Диалог нового оффера: название, партнёрка, URL оффера с подсказкой макросов, выплата

Партнёрка: от неё зависит параметр click id.
URL оффера с макросами.
Выплата и валюта.

Если click id не вставлен, Telegfy добавляет его сам. Имя параметра берётся из «Параметр subid» ПП. Для оффера без ПП используется _la_ct. Поэтому ПП должна возвращать тот же параметр в постбеке.

Выплата и доход

Выплата конверсии берётся из постбека ПП.
Если постбек без выплаты, а оффер с фиксированной моделью, в отчёте используется текущая выплата оффера. Поэтому, если поменять выплату в оффере, доход пустых конверсий в отчётах пересчитается.
Модель «Из постбэка» не делает подстановки: без выплаты в постбеке дохода не будет.
В доход попадают продажи, ребиллы и апсейлы. Лиды и отклонения в доход не входят.
В полях сумм запятая допустима: 10,5 сохранится как 10.5. В постбеке от ПП тоже.

Капы

Дневной и общий капы считаются по конверсиям, а не по кликам. Дневной сбрасывается в полночь по UTC.

Когда кап достигнут, оффер выпадает из ротации. Правило берёт следующий оффер. Если офферов в правиле не осталось, клик уходит к следующему правилу или на URL ссылки.

Здоровье офферов

Каждые 10 минут Telegfy проверяет URL активных офферов и лендингов запросом. В URL макросы заменяются на test. Проверочный запрос видит ПП, поэтому не ставьте оффер на страницу, где проверочный запрос создаёт реальные действия.

Событие	Что происходит
Первая неудача	Оффер получает «Недоступен» и выпадает из ротации.
Три неудачи подряд	Статус «Авто-отключён». Проверки прекращаются.
Успешная проверка	Здоровье «Работает». Авто-отключение не снимается.

Оффер «Авто-отключён» включаете вручную: откройте оффер и поставьте статус «Активен».

Отключение по CR

Если у оффера не меньше 100 кликов и конверсии меньше 1%, оффер отключается при следующей конверсии. Порог не настраивается. Оффер без конверсий по этому правилу не отключается.

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

Лендинги — прокладки перед офферами.
Правила и потоки — как выбирается оффер.
Решение проблем — если оффер отключился.