Настройка упрощенной отправки данных о клиентах и заказах

Шаг 1. Подготовка данных для привязки к визитам

Метрика привязывает данные из CRM к посетителям и их визитам на сайте. Для привязки Метрика использует характеристики клиентов (phones, emails, phones_md5, emails_md5), а также специальный идентификатор ClientId. Идентификатор Метрики ClientId обеспечивает самый высокий уровень привязки заказов к визитам пользователей на сайте — рекомендуем передавать именно его.

Как настроить передачу ClientID?

Передача ClientId — это процесс включения уникального идентификатора пользователя Метрики в записи о сделках в вашей CRM-системе. Настройте передачу параметра в зависимости от того, как именно происходит контакт с пользователем:

• Формы и заказы на сайте. Получите ClientId с помощью JavaScript-метода getClientID и запишите его в скрытое поле ваших лид-форм для последующей передачи в CRM.

• Звонки посетителей. Если в вашей CRM сделки создаются после звонков, то, скорее всего, вы используете сервис коллтрекинга. Проверьте, что ваша система коллтрекинга имеет функцию передачи ClientId в сделки внутри CRM.

• Письма от посетителей. Для сделок, инициированных через e-mail, используйте сервисы e-mail-трекинга, которые позволяют определить ClientId отправителя письма благодаря подмене e-mail-адресов на сайте и отправить информацию о новом письме в вашу CRM в виде сделки.

• Чаты в мессенджерах. При начале общения в мессенджерах инициируйте метод getClientID на сайте и включите идентификатор ClientId в диплинк (Telegram, Viber) или в шаблон сообщения (WhatsApp). При создании сделки указывайте идентификатор в отдельном поле.

• Виджеты на сайте. Удостоверьтесь, что виджеты, используемые на сайте, могут передавать ClientId Метрики в вашу CRM при передаче сделок.

Шаг 2. Формирование сsv-файла специального формата

Сформируйте файл в формате упрощенных данных о заказах и клиентах, указав обязательные данные — дату заказа, хотя бы один из идентификаторов (client_ids, emails, phones, emails_md5, phones_md5) и id заказа в вашей CRM, если в будущем вы планируете обновлять этот заказ.

Дополнительно можно отправить идентификатор клиента в CRM, статус заказа (вместе со статусом заказа будут выполняться соответствующие цели) и доход/себестоимость заказа.

Подробнее про формат упрощенных данных о заказах и клиентах

Шаг 3. Загрузка данных в Метрику

Передайте данные в Метрику с помощью метода POST /cdp/api/v1/counter/{counterId}/data/simple_orders.

Упрощенный метод помогает отправлять в Метрику информацию о заказах и клиентах в CSV-файле без дополнительных настроек (сопоставления статусов заказов, загрузки отдельных списков клиентов и заказов, загрузки списка товаров и дополнительных атрибутов). Для сбора статистики достаточно передавать дату и время создания заказа в часовом поясе счетчика (create_date_time) и один из параметров клиентов (ClientID, номер телефона или адрес электронной почты, хеши телефона или почты). Вы можете передавать заказы в разных статусах с данными о выручке и себестоимости.

Отправленная информация учитывается в отчетах Сквозной аналитики. Кроме этого, вы можете использовать данные для ретаргетинга и оптимизации конверсий в Директе.

Подробно о формате передаваемых данных

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

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

POST https://api-metrika.yandex.net/cdp/api/v1/counter/2215573/data/simple_orders?merge_mode=SAVE&delimiter_type=COMMA
Content-Disposition: form-data; name="file"; filename="data.csv"
Content-Type: multipart/form-data; boundary=------------------------7zDUQOAIAE9hEWoV
Context-Length: TBD

--------------------------7zDUQOAIAE9hEWoV
Content-Disposition: form-data; name="file"; filename="data.csv"
Content-Type: text/csv

id,create_date_time,client_uniq_id,client_ids,emails,phones,order_status,revenue,cost,goals,currency
s_ord1,10.01.2024 11:56,s_user1,,"mail@example.com,mail2@example.com",,PAID,200,150,"oplata_cash:200,filial_1",
s_ord2,20.01.2024 11:59,,12345,mail3@example.com,,,200,150,,EUR
,12.02.2024,,34456,,79876543210,SPAM,,,plohoy_lead,
--------------------------7zDUQOAIAE9hEWoV--