Импорт конверсий из CSV
Как загрузить конверсии файлом: формат CSV, проверка строк, подтверждение импорта и отправка уведомлений.
Импорт записывает конверсии из CSV так же, как входящий постбек, только без запроса от партнёрской сети. Он находится во вкладке Настройки → Импорт конверсий, вкладку видят владелец и администратор. Сначала трекер проверяет все строки, затем вы подтверждаете импорт; пока в файле есть хотя бы одна ошибка, ничего не записывается.
Формат файла
Первая строка — заголовок: ровно четыре колонки в этом порядке, строчными буквами. Разделитель — запятая.
sub_id,payout,tid,status
1a2b3c4d5e6f,25.5,order-1001,sale
7g8h9i0j1k2l,0,,lead
3m4n5o6p7q8r,40,order-1002,rejected| Колонка | Что указать | Правила |
|---|---|---|
sub_id | ID клика в трекере — значение макроса {subid} | От 1 до 64 символов: латинские буквы, цифры, _ и -. Клик должен быть в вашем рабочем пространстве |
payout | Сумма выплаты | Число не меньше нуля, дробная часть через точку: 25.5. Пустое значение не принимается, для конверсии без выплаты укажите 0 |
tid | ID транзакции | До 64 символов. Можно оставить пустым — тогда трекер подставит import: и значение sub_id. Незаменённый макрос вида {txid} не принимается |
status | Статус конверсии | Обязателен, до 64 символов, регистр не важен |
В колонке status подходят lead, sale, rejected, hold и значения, которые сопоставлены с ними во вкладке Настройки → Конверсии, см. Типы конверсий.
Пределы одного импорта: 200 строк с данными и 256 КБ. Даты в файле нет: временем конверсии становится момент импорта.
Для нескольких продаж по одному клику укажите в строках разные tid. Две строки с одинаковыми sub_id и tid в одном файле проверку не пройдут.
Валюта и уведомления
Под полем с текстом CSV два параметра. Они действуют на весь файл.
- Валюта — код из трёх латинских букв, по умолчанию
USD. В ней указаны все суммы файла. Сумма пересчитывается в USD по курсу на день импорта, см. Валюты и курсы. Конверсии в разных валютах загружайте отдельными файлами. - Отправлять исходящие S2S и CAPI — по умолчанию выключен: конверсии записываются в трекер, а S2S-постбеки источника и кампании и события Facebook Conversions API не отправляются. Включите флажок, если получатели должны узнать об этих конверсиях.
Сумма записывается по тем же правилам, что и для постбека. Если у оффера выключен флажок Выплата из параметра постбэка и указана выплата больше нуля, записывается выплата оффера, а не значение из колонки payout; для статусов lead и rejected — 0. Подробнее — в разделе Выплата и валюта.
Шаг 1: проверьте файл
- Откройте Настройки → Импорт конверсий.
- Выберите файл
.csvили вставьте текст в поле под кнопкой выбора файла. В поле уже стоит строка заголовка. Выбранный файл заменяет весь текст в поле. - Укажите код в поле Валюта.
- Отметьте Отправлять исходящие S2S и CAPI, если нужны уведомления.
- Нажмите Проверить CSV.
Под кнопками появится таблица с колонками Строка, Sub ID, TID, Статус, Выплата, Результат. В колонке Строка — порядковый номер строки: заголовок первый, данные начинаются со второй, пустые строки не считаются.
- У всех строк «Проверено», над таблицей «Проверка пройдена. Подтверждение действительно 15 минут.» — переходите к шагу 2.
- У части строк ошибка, над таблицей «Исправьте ошибки и повторите проверку. Ничего не импортировано.» — исправьте строки в поле и нажмите Проверить CSV ещё раз.
Шаг 2: импортируйте
- Нажмите Импортировать проверенные строки. Пока идёт запись, на кнопке написано «Обработка…».
- Дождитесь сообщения «Обработка завершена. Ошибочные строки можно повторить с тем же tid.»
У принятых строк в колонке Результат стоит «Принято (точный повтор не создаёт дубль)».
Подтверждение действует 15 минут. Любая правка текста, валюты или флажка сбрасывает проверку: кнопка импорта неактивна, пока вы не нажмёте Проверить CSV снова.
Повторы и обновление конверсий
Трекер находит уже записанную конверсию по паре sub_id и tid:
- Такой пары ещё нет — создаётся новая конверсия.
- Тот же статус и та же выплата — строка пропускается, дубль не создаётся.
- Тот же статус, другая выплата — выплата исправляется. Уведомления не отправляются даже при включённом флажке.
- Другой статус — конверсия обновляется. Исключение:
leadилиholdпослеsaleпропускается, продажа остаётся.
Поэтому файл можно загружать повторно целиком. У пропущенных строк в колонке Результат тоже стоит «Принято».
Чтобы обновить конверсию, которая пришла постбеком, укажите в tid тот же ID транзакции, что был в постбеке. Конверсию, принятую без ID транзакции, импорт не находит: строка создаст по этому клику ещё одну конверсию. Полные правила — на странице ID транзакции, дубли и корректировки конверсий.
Проверка
Откройте лог конверсий кампании. У каждой принятой строки там запись: sub_id в колонке Subid, tid в колонке Txid, выплата в USD. Если был включён флажок уведомлений, отправки видны в журнале доставки событий.
Если не получилось
Сообщения о файле целиком показываются красным над кнопками, сообщения о строках — в колонке Результат.
| Сообщение | Что сделать |
|---|---|
| «Максимум 256 КБ», «Файл больше 256 КБ», «Не больше 200 строк за импорт» | Разделите файл на части: до 200 строк с данными и до 256 КБ в каждой |
| «Нужен CSV с заголовком sub_id,payout,tid,status», «Нужны ровно 4 колонки: sub_id,payout,tid,status», «Заголовок: sub_id,payout,tid,status» | Сделайте первой строкой sub_id,payout,tid,status. Колонки разделяйте запятыми |
| «В CSV нет данных» | Добавьте под заголовком хотя бы одну строку |
| «Некорректная валюта» | Укажите в поле Валюта код из трёх латинских букв |
| «Некорректная CSV-строка: нужны 4 колонки» | Проверьте число запятых в строке. Пустой tid — это две запятые подряд |
| «Некорректный sub_id», «Выплата должна быть конечным неотрицательным числом», «tid: до 64 символов, без макросов», «Укажите статус» | Исправьте значение в строке по правилам из раздела Формат файла. Сумму пишите цифрами через точку, без знака валюты |
| «Повтор sub_id + tid внутри файла» | Удалите повторную строку или задайте строкам разные tid. Две строки одного клика с пустым tid тоже считаются повтором |
| «Клик не найден в этом workspace или хранилище недоступно» | Найдите sub_id через поиск кликов. Если клик на месте, повторите проверку позже |
| «Неизвестный статус: настройте тип конверсии» | Добавьте это значение в тип конверсии или замените его в файле на lead, sale, rejected или hold |
| «Нет курса валюты или сумма слишком велика» | Добавьте курс этой валюты во вкладке Настройки → Валюты и проверьте сумму |
| «Не удалось проверить тип конверсии» | Повторите проверку позже |
| «Данные изменились или проверка устарела. Повторите проверку.» | Прошло больше 15 минут. Нажмите Проверить CSV и импортируйте заново |
Не принято: HTTP 503. Проверьте журнал postback; строку можно повторить с тем же tid.
Строка прошла проверку, но при записи трекер её не принял. Число в сообщении — код ответа, 503 означает временный сбой. Остальные строки записываются независимо от неё.
- Откройте Логи → Postbacks.
- Введите
sub_idстроки в поле Поиск — записи разобраны на странице Системный лог, постбэки и журнал трафика. - Вернитесь в Настройки → Импорт конверсий, выберите тот же файл и нажмите Проверить CSV.
- Нажмите Импортировать проверенные строки. Уже принятые строки второй раз не запишутся.