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

Большинство проблем видно в двух местах: в логе входящих постбэков (страница «Партнёрские сети», последние 30 записей) и в журнале конверсий (/dashboard/reports/conversions, Pro). Начинайте с лога: он покажет результат каждого постбека и причину.

Конверсия не записалась

Сначала найдите запрос в логе входящих постбэков: это таблица внизу страницы «Партнёрские сети».

Лог входящих постбэков внизу страницы партнёрских сетей

Заголовок лога и кнопка «Обновить».
Колонка «Результат»: по ней сразу видно, что произошло.
Колонка «Параметры»: проверьте значение subid и статус.

Записи нет вообще. Постбек не дошёл до Telegfy.

ПП не отправила запрос. Проверьте в её кабинете, что постбек включён и адрес совпадает с «Наш URL постбэка».
Адрес неверный: домен, http или https, опечатка в пути /postback.
Ответ 429. Запрос отклонён до записи в лог. См. 429.

Запись есть, результат ниже.

`result`	Причина	Что делать
`click_not_found`	Click id пустой, не UUID или не найден. Частый случай: ПП вернула не тот параметр или не тот макрос.	Проверьте, что в URL оффера стоит `{{click_id}}` (или работает автоматическое добавление по «Параметру subid»), и что `subid=` в постбеке — правильный макрос ПП. Смотрите колонку «Параметры» в логе.
`goal_not_found`	Цель с ключом из `goal` не существует, выключена, либо ссылка не входит в коллекцию цели. Без `goal` — в воркспейсе нет активных целей.	Включите цель, поправьте ключ или добавьте ссылку в коллекцию.
`rejected`	Не прошла проверка подписи или IP.	Смотрите защиту постбеков. Сверьте подпись и список IP.
`error`	Внутренняя ошибка. Текст в колонке «Сообщение».	Если повторяется, отправьте в поддержку id записи и время.

Для конверсий с результатом «записано» проверьте журнал конверсий (/dashboard/reports/conversions, Pro).

Журнал конверсий: фильтры и таблица с датой, целью, статусом, суммой и TID

Фильтры: статус, цель, код ссылки, наличие TID.
Таблица: статус, сумма, TID, цель.

Статус не тот

В логе предупреждение unknown status. Статус ПП не распознан, конверсия записана как лид. Добавьте соответствие в карточке ПП. См. словарь статусов.
Продажа записана как лид. ПП прислала лидовый статус (pending, hold и т. п.) или подтверждение не пришло. Посмотрите в логе, какой статус реально пришёл.
Лид не стал продажей. Повторный постбек должен содержать тот же tid, либо тот же клик и статус из словаря. Без tid повтор обновит запись по клику. Если ПП шлёт статус, которого нет в словаре, он записывается как лид. Добавьте соответствие в карточке ПП.
Продажа не понизилась до лида. Так и задумано: поздний лид не понижает продажу.

Дубли и лишние конверсии

Одна продажа записана дважды. Значит, ПП прислала разные tid на одну транзакцию. Проверьте, что при повторе отправки tid тот же.
Ребилл без tid записан одним. Ребиллы и апсейлы без tid склеиваются по клику и статусу. Передавайте tid.
Импорт создал дубли. Дедупликация по паре (цель, tid). Без tid импорт не склеивает строки. Добавьте tid в файл.

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

Выплата не пришла. Для отчёта возьмётся выплата оффера, если модель «Фиксированная». Иначе доход будет 0.
Валюта не переводится. Неверный или неизвестный код валюты. Добавьте курс в Курсы валют.

ROI странный

ROI = (доход − расход) / расход × 100%. Если цифры не сходятся, проверьте по очереди.

Расход не учтён. Расход считается либо по ручным записям, либо по цене клика. Если есть хоть одна ручная запись в периоде, цена клика по остальным ссылкам в итогах не добавляется. Проверьте раздел «Расходы» и модель в «Приёме кликов».
Доход меньше ожидаемого. В доход идут только продажи, ребиллы и апсейлы. Лиды и отклонения — нет. Отклонённая продажа выпадает из дохода.
Смешанные валюты. В отчёте появилось предупреждение. Добавьте курсы, иначе суммы складываются без пересчёта.
Доход в отчёте не совпадает с кабинетом ПП. ПП может считать по другой дате, статусу или без учёта возвратов. Telegfy считает по дате клика или дате конверсии, в зависимости от выбранного «Считать по».
Вкладка «Экономика» и конструктор дают разные цифры. Экономика считает конверсии по дате конверсии, конструктор по умолчанию по дате клика. Выберите одинаковое «Считать по».
Клики есть в счётчике ссылки, но не в отчётах. Превышен лимит кликов в месяц на Free (10 000). Детальные записи не сохраняются до следующего месяца по UTC.
Данные старше 30 дней пропали. Retention на Free — 30 дней, на Pro — 365.

Исходящий постбек не отправлен

Откройте источник и его лог постбэков.

Постбеков нет. Ссылка клика не привязана к источнику, а в воркспейсе больше одного активного источника. Назначьте источник ссылке.
Условия не совпали. Источник ждёт продажу, а пришёл лид. Или выплата ниже минимальной.
Источник неактивен. Включите его.
Постбек уже отправлен. Для пары (конверсия, источник, статус) уходит один постбек. Повтор с тем же статусом не уйдёт.
Состояние «Ошибка». Смотрите код ответа. 4xx — неверный адрес или параметры. 5xx — проблема на стороне источника. Адрес может быть отклонён, если он указывает на приватный IP или не начинается с http или https.
Состояние «В очереди» не меняется. Очередь разбирается раз в минуту. Если состояние висит долго, обратитесь в поддержку.

Оффер выключился сам

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

Три неудачи проверки подряд. Проверка идёт с сервера Telegfy. Если оффер блокирует серверные запросы или открывается только из браузера, он будет помечен как недоступный. Откройте URL оффера с макросами, замененными на тестовые значения, и посмотрите ответ.
Конверсия ниже 1% при 100 кликах. Оффер отключился при следующей конверсии. Порог не настраивается.

Вернуть оффер можно вручную: откройте оффер и поставьте статус «Активен».

Статус «Недоступен» означает, что оффер выпал из ротации после одной неудачной проверки. После успешной проверки он вернётся сам.

Из-за проверки здоровья ПП видит запросы с test в URL. Если это мешает, поставьте оффер на страницу без параметров.

402 UPGRADE_REQUIRED

Функция недоступна на вашем тарифе. Ответ содержит название функции, например «Feature … requires the pro tier».

Типичные случаи:

макросы {{...}} в целевом URL ссылки, передача параметров запроса;
свой домен, отчёты, журнал кликов и конверсий, дашборды;
создание и изменение правил маршрутизации (на Free так же, через API);
передача параметров запроса в ссылке (forwardParams). Сохранение обычной ссылки на Free работает без 402.

Сравните лимиты в разделе Тарифы и оплата.

429 Too Many Requests

Слишком много запросов за минуту. Ответ содержит заголовки Retry-After, X-RateLimit-Limit и X-RateLimit-Remaining.

Что	Лимит
Анонимный доступ к API	10 в минуту на IP и эндпоинт
Free	30 в минуту на IP и эндпоинт
Pro	120 в минуту на IP и эндпоинт
Enterprise	600 в минуту на IP и эндпоинт
Входящий постбек `/postback`	6000 в минуту на IP
Вход в аккаунт	5 в минуту на IP

Для постбеков 429 означает, что ПП отправляет слишком много запросов. Такой запрос не попадает в лог. Если лимит повторяется, попросите ПП уменьшить частоту или присылать пакетами.

Если 429 появился на обычных запросах из интерфейса, подождите минуту. Частые запросы, например автообновление, тоже учитываются.

Что приложить к обращению в поддержку

id записи из лога или id конверсии;
время и часовой пояс;
значение subid и tid, без паролей и секретов;
скриншот лога или ответ API целиком.

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

Входящие постбеки — все параметры и ответы.
Исходящие постбеки — как работает очередь.
Правила и потоки — если клик не попал на нужный оффер.