Импорт конверсий

Импорт нужен, когда конверсия не пришла постбеком: ПП не настроила его, постбек не дошёл, или нужно загрузить историю. Конверсии берутся из кабинета ПП и загружаются файлом или вручную.

Откройте «Импорт конверсий» (/dashboard/conversions/import). Есть две вкладки: «Импорт CSV» и «Ручной ввод».

1. Вкладки: «Импорт CSV» и «Ручной ввод».
2. Область загрузки файла на вкладке CSV.

Файл CSV

Первая строка обязательна: это заголовки. Порядок колонок не важен. Неизвестные колонки игнорируются. Имена колонок не чувствительны к регистру и знакам.

Что	Допустимые заголовки	Обязательно
Click id	subid, sub_id, click_id, clickid, click_token, «Click ID»	Да
Статус	status — lead, sale, rejected, rebill или upsell	Нет (по умолчанию лид)
Выплата	payout, revenue, amount	Нет
Валюта	currency, payout_currency	Нет
ID транзакции	tid, external_id, conversion_id	Рекомендуется
Дата	date, converted_at, event_date	Нет

Пример:

subid,status,payout,currency,tid,date
3f6c2a10-8e1b-4d2f-9a51-0b7c2e9d4f11,sale,25.5,USD,ORD-1001,2026-10-10 14:32
7a1d9e44-2c0b-4f8e-b3a6-5e2d1c9f0a22,rejected,0,USD,ORD-1002,2026-10-10 15:05

Строка со статусом вне списка отклоняется. В отчёте импорта будет причина.

Что происходит с каждой строкой

Результат для каждой строки выводится в отчёте:

Результат	Значение
accepted	Конверсия записана.
updated	Найдена конверсия с тем же tid и обновлён статус или выплата.
duplicate	Точный повтор, ничего не изменилось.
rejected	Строка не прошла проверку, например неизвестный статус или click id не UUID.

Дедупликация такая же, как у постбека: ключ — пара (цель, tid). Конверсия попадает в цель по умолчанию, если в импорте не указана другая. Импортировать можно только клики своего воркспейса.

Ручной ввод

На вкладке «Ручной ввод» заполните одну конверсию: click id, статус (по умолчанию лид), выплату, валюту, ID транзакции, дату и цель. Поле «Цель» по умолчанию выбирает первую активную цель.

Кнопка «Записать конверсию» сохраняет строку. Кнопка «Импортировать CSV» загружает весь файл.

Ограничения

• Тело запроса около 100 КБ. Для большого файла разбейте его на части.
• Импорт идёт через ту же логику, что и постбек. Значит, исходящие постбеки в источники и CAPI тоже отправятся.

Осторожно

Импорт задним числом может отправить в CAPI события старше 7 дней. Meta их отклонит, и весь пакет тоже. Сначала проверьте даты в файле.

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

• Click id не UUID. Telegfy принимает только свой click id. ID из кабинета ПП не подойдёт, если он не совпадает с нашим subid.
• Разделитель в сумме. Подойдут и точка, и запятая: 10,5 и 10.5 — это 10.5. Если в сумме есть и точка, и запятая (1,000.50), запятая считается разделителем тысяч.
• Неизвестный статус. Допустимы только пять наших статусов. Переведите статусы ПП заранее, например approved в sale.

Автоматизация

Тот же импорт доступен через API (POST /api/v1/conversions/import) с правом conversions:write. Для регулярной загрузки используйте API, а не ручной файл.

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

• Входящие постбеки — основной способ получать конверсии.
• Цели — в какую цель попадут импортированные конверсии.