Центр конверсий в Яндекс Директе
Центр конверсий (меню «Конверсии») загружает в Метрику офлайн-конверсии и конверсии по звонкам из CSV по FTP, SFTP, ссылке HTTP/HTTPS или из Google Sheets. Файл — CSV с разделителем «;», UTF-8, до 300 Мбайт, конверсии не старше 113 дней. Конверсия привязывается к визиту в окне 21 день, править её можно ещё 90 дней. Файл обновляют в реальном времени или не реже раза в сутки.
Цифры
Ограничения и сроки
| Параметр | Значение |
|---|---|
| Где находится | меню → «Конверсии» |
| Способы загрузки | FTP, SFTP, ссылка HTTP/HTTPS, Google Sheets |
| Формат | CSV, разделитель «;», кодировка UTF-8 |
| Размер файла | до 300 Мбайт |
| Возраст конверсии | не старше 113 дней |
| Обновление файла | в реальном времени или не реже 1 раза в день |
| Актуальность в файле | конверсии за последние 3 дня |
| Окно привязки конверсии к визиту | 21 день |
| Правка конверсии после окна | ещё 90 дней |
| Время при указании только даты | 23:59:59 |
| Максимум revenue и cost | 9223372036854 |
| Листов в Google Sheets | 1 |
| Проверка целей после первой выгрузки | в течение 24 часов |
Поля файла
| Поле | Обязательность | Что передавать |
|---|---|---|
| create_date_time | обязательное | дата и время создания заказа в часовом поясе счётчика; значение нельзя менять |
| client_ids | хотя бы одно из полей-идентификаторов | список ClientID |
| emails | то же | адреса латиницей, строчными буквами; несколько значений — в кавычках через запятую без пробелов |
| phones | то же | числовая строка с кодом страны без пробелов, например 79995551111 |
| emails_md5 | то же | md5-хеши почт (почта до хеширования в формате emails) |
| phones_md5 | то же | md5-хеши телефонов (до хеширования в формате phones) |
| id | необязательное | идентификатор заказа в CRM, произвольный |
| client_uniq_id | необязательное | идентификатор клиента в CRM |
| order_status | необязательное | статус заказа, значение большими буквами |
| revenue | необязательное | суммарная стоимость заказа, десятичная дробь с точкой, например 1508.50 |
| cost | необязательное | себестоимость, десятичная дробь |
Статусы заказа
| Статус | Значение | В какие цели попадает |
|---|---|---|
| PAID | оплачен; ставится по умолчанию, если статус пуст | «CRM: Заказ оплачен»; если отправлять только PAID, то и в «CRM: Заказ создан» |
| IN_PROGRESS | заказ создан, но не оплачен | «CRM: Заказ создан» |
| CANCELLED | отменён | в справке не нашли |
| SPAM | спам | в справке не нашли |
| идентификатор JavaScript-цели | конверсия попадает в цель с этим идентификатором | в выбранную цель |
Подробности
Для чего нужен Центр конверсий
Это единое окно для конверсий из офлайна, по звонкам и из онлайна. В нём загружают офлайн-конверсии и звонки альтернативными способами (это дополняет данные Метрики) и следят за статистикой по конверсиям, загруженным альтернативными способами, по API или через коннекторы. Все данные Метрики по конверсиям можно выгрузить в Директ. Из Центра данные попадают в Метрику, там формируются конверсии и цели. Статистика и оптимизация на цели доступны всем логинам Директа, у которых есть доступ к счётчику Метрики с загруженными данными.
Как загрузить: три этапа
- Сформировать CSV по установленному формату.
- Положить файл в источник (FTP, SFTP, ссылка или таблица Google).
- В Директе на странице «Конверсии» нажать «Добавить источник конверсий» и указать источник.
Если в CRM не хранится время конверсии, отправляют только дату: время автоматически станет 23:59:59, и все конверсии этого дня смогут привязаться к визитам. Если ClientID собирается онлайн, его стоит передавать: тогда онлайн-конверсии привязываются к визитам точнее.
Поле id позволяет обновить статус заказа (например, из IN_PROGRESS в PAID через месяц) и перепривязать заказ от одного клиента к другому. Если в двух выгрузках не передан ни id, ни client_uniq_id, в системе окажутся два клиента и два заказа. Если передан client_uniq_id, останется один клиент и один заказ. Если передан только id, клиентов будет два, а заказ один и перепривяжется к последнему клиенту. client_uniq_id склеивает будущие заказы с прошлыми, если у клиента добавился или сменился идентификатор.
Выручка (revenue) нужна для отчётов сквозной аналитики и метрики «Выручка», себестоимость (cost) — для прибыли: Выручка − Себестоимость.
Что указать при добавлении источника
- Файл по ссылке: название источника, ссылка на файл, счётчик Метрики и ценность конверсий.
- FTP и SFTP: название, логин и пароль (чтобы робот Метрики забирал данные), порт и хост, путь к файлу (начинается с «/», например /название_файла.csv или /папка/файл.csv), счётчик, отметка о защищённом протоколе (для FTP), ценность конверсий. Правильность пути проверяют скачиванием файла FTP- или SFTP-клиентом.
- Google Sheets: название, ссылка, счётчик, ценность. Таблице нужен доступ «Просмотр» для аккаунта import@yandex-direct-conversions.iam.gserviceaccount.com, данные должны лежать на первой вкладке.
Ценность можно задать вручную. Если в файле указан доход, выбирают ценность «Из файла». У логина Директа (а при добавлении с логина Представителя — и у логина Главного представителя) должен быть доступ на редактирование выбранного счётчика Метрики. Источник достаточно добавить на одном логине: цели появятся в Метрике и будут доступны на всех логинах с доступом к счётчику.
JavaScript-цель как статус заказа
Вместо фиксированных статусов в order_status можно указать идентификатор JavaScript-цели из Метрики. Для этого создают отдельную цель: «Метрика → Цели → Добавить цель», тип условия — JavaScript-событие, идентификатор «совпадает» и задаётся таким, чтобы действия на сайте его не вызывали. Поле «Доход» лучше оставить пустым. В файле используют тот же идентификатор в том же регистре: для цели paid_from_site значение PAID_FROM_SITE не привяжется к визиту.
Как проверить, что всё работает
- Если передаются и онлайн-, и офлайн-заказы, проверить на нескольких заказах (онлайн, офлайн, звонки), что они с правильными контактами попали в файл. Проблема в выгрузке, если у всех заказов стоит ClientID (офлайн не попал) или ни у одного его нет (онлайн-атрибуция будет заметно хуже).
- Убедиться, что файл обновляется раз в сутки или чаще: Центр конверсий ориентируется на время обновления и скачивает файл, если он изменился.
- При фиксированных статусах через 24 часа после первой выгрузки в Метрике в «Конверсиях» должны появиться цели «CRM: Заказ создан» и «CRM: Заказ оплачен». Это значит, что файл прошёл проверку. В «CRM: Заказ создан» попадают заказы со статусами IN_PROGRESS и PAID (если раньше по ним не отправляли IN_PROGRESS), в «CRM: Заказ оплачен» — PAID.
- При статусе-идентификаторе цели через 24 часа в Метрике должна появиться статистика по этой цели.
Заказы со статусами SPAM и CANCELLED позволяют собирать сегменты, на их основе строить Look-alike и использовать сегмент в корректировках.
Ошибки при загрузке
Красная плашка в Центре конверсий означает, что файл не загрузился: ошибка в файле или в настройках источника.
| Сообщение (смысл) | Что проверить |
|---|---|
| Ошибка соединения с сервером | порт, хост, путь к файлу |
| Нет доступа на запись в счётчик Метрики | у логина, добавляющего источник, нужен доступ на редактирование счётчика; для Представителя — у Главного представителя |
| Ошибка при скачивании файла | настройки источника; скачать файл самостоятельно по ссылке или с FTP |
| Неверные данные для авторизации | логин и пароль к серверу |
| Неправильный разделитель | в CSV колонки делят точкой с запятой, несколько значений в одной колонке — в кавычках через запятую без пробелов |
| В файле нет валидных данных | названия колонок, формат даты, телефонов и почт |
| Недостаточно прав для скачивания | доступ «Просмотр» аккаунту import@yandex-direct-conversions.iam.gserviceaccount.com |
| Размер файла больше 300 Мбайт | загрузить файл меньше; при первой загрузке достаточно конверсий за вчера |
| Неверная кодировка | поддерживается только UTF-8 |
| В таблице больше одного листа | оставить один лист |
| Внутренняя или неизвестная ошибка | обратиться в поддержку или к персональному менеджеру |
Ошибки в строках файла
Если часть данных невалидна, появляется файл с ошибками.
| Сообщение | Причина |
|---|---|
| Invalid date format | неверный формат даты и времени в create_date_time |
| Empty 'create_date_time' value | поле даты пустое, оно обязательное |
| 'create_date_time' is older than 113 days | конверсия старше 113 дней, такие строки надо убрать |
| 'create_date_time' is from the future | дата в будущем, данные загрузятся только завтра |
| Invalid identifier | некорректный идентификатор пользователя; ClientID должен быть полным положительным числом |
| All columns with identifiers are empty | нужна хотя бы одна колонка: client_ids, emails, phones, emails_md5, phones_md5 |
| Invalid revenue/cost value | значение не число, отрицательное или слишком большое (граница 9223372036854) |
| Invalid 'order_status' value | статус вне списка PAID, IN_PROGRESS, CANCELLED, SPAM; для идентификатора цели важны существование цели и тот же регистр |
Статистика по конверсиям из Метрики
Если продвижение идёт на нескольких логинах, источник конверсий добавляют на одном, а на остальных выбирают источник «Яндекс Метрика»: указывают счётчик, на который грузили данные, и цели. Если у цели не настроена передача дохода, ценность задают вручную. Получится отчёт с двумя показателями: «Конверсии» (целевые визиты по цели из всех источников) и «Конверсии из Директа» (количество и доля конверсий после перехода по кампаниям Директа).
Важно знать
- Окно привязки конверсии к визиту — 21 день: конверсия, совершённая позже 21 дня после последнего визита на сайт, визит не дополнит.
- Ошибка «старше 113 дней» и окно 21 день названы на странице отдельно. Как они соотносятся (что с заказом, который старше окна, но моложе 113 дней), справка не поясняет.
- Для максимума revenue и cost в таблице ошибок сказано «меньше 9223372036854», а в английском тексте сообщения — «must not exceed». Точная граница (включительно или нет) не ясна.
- Конверсии по звонкам названы в начале страницы, но отдельных полей для звонка в формате файла нет. Как именно передавать звонки, страница не уточняет: отсылает к отдельной странице справки про загрузку офлайн-конверсий и звонков.