Как загружать клиентов и заказы в Яндекс Метрику одним файлом

Недавно в Яндекс.Метрике упростили загрузку данных о заказах по email, телефону и ClientID. Теперь, благодаря нововведению, можно загрузить данные одним CSV-файлом. Подробнее о том, как упростили, читайте далее в статье.

Как упростили загрузку данных в Метрику?

Как мы и упомянули выше, Яндекс Метрика упростила загрузку данных о заказах по email, телефону и ClientID. Теперь все эти данные можно загрузить одним CSV-файлом.

Передавать можно заказы с любыми статусами и для каждого указывать выручку и себестоимость. Загружаемые данные о заказах могут быть полезны для анализа конверсий на всех этапах воронки и будут помогать вам в дальнейшей оптимизации рекламы, а также при создании сегментов для более точной настройки кампаний.

Как сделать загрузку данных в Метрику?

Внимание! Данный способ доступен только для передачи по API.

Для сбора статистики достаточно передавать дату и время создания заказа в часовом поясе счетчика (create_date_time) и один из параметров клиентов (ClientID, номер телефона или адрес электронной почты).

Сначала поговорим о формате передаваемых данных.

Формат передаваемых данных

Подробнее о формате передаваемых данных можно прочитать тут.

Есть «Обязательные колонки» и «Необязательные колонки».

В обязательные колонки входит:

• id — идентификатор заказа в вашей CRM.
• client_uniq_id — идентификатор клиента в CRM, связанного с заказом.
• client_type — тип клиента с client_uniq_id. Допустимое значение: CONTACT.
• create_date_time — дата и время создания заказа в часовом поясе счетчика.
• order_status — идентификатор статуса заказа.

В необязательные колонки входит:

• update_date_time — дата и время обновления заказа в часовом поясе счетчика.
• finish_date_time — дата и время завершения заказа в часовом поясе счетчика.
• revenue — доход.
• cost — себестоимость.
• products — товары в заказе.

Заберите также базу на 300+ кейсов и статей по SMM и таргету по ссылке.

Синтаксис запроса:

counterId — это идентификатор(номер) счетчика, для которого вы хотите загрузить заказы.

https://api-metrika.yandex.net/cdp/api/v1/counter/{counterId}/data/simple_orders
 ? [merge_mode=<update_type>]
 & [delimiter_type=<delimiter_type>]

merge_mode— это режим сохранения данных. При любом из значений передавайте все обязательные поля — даже те, которые не меняются.

Допустимые значения:

SAVE — вся ранее переданная информация полностью заменяется новой.

UPDATE — обновляется только та информация, которую вы загружаете в данный момент.

APPEND — новая информация добавляется к ранее загруженной.

Совет! При отправке данных о заказах в параметре передавайте значение, соответствующее состоянию загружаемых заказов. Если при повторной отправке данных вы не уверены, какой именно статус нужно передавать, укажите значение «SAVE».

merge_mode

delimiter_type-это вид разделителя столбцов в файле.

Значением по умолчанию является: comma

В теле запроса

Пример запроса

POST https://api-metrika.yandex.net/cdp/api/v1/counter/{counterId}/data/simple_orders?merge_mode=APPEND

Формат ответа

Примеры итогового загружаемого файла

1. Загрузка данных по ClientID.

Внимание! Команда Яндекс.Метрики рекомендует использовать этот тип идентификатора, так как он обеспечивает более точную привязку загруженных данных с информацией о посетителях сайта в Метрике.

2. Загрузка данных по адресам электронной почты.

3. Загрузка данных по номерам телефонов.

4. Загрузка в одном файле разных идентификаторов.

Автор: Юлия Твердохлеб