--- metadata: - name: generator content: Diplodoc Platform v5.48.2 alternate: - https://yandex.com.tr/dev/metrika/en/data-import/data.md - https://yandex.com.tr/dev/metrika/ru/data-import/data.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/metrika/ru/llms.txt # Настройка отправки подробных данных о клиентах и заказах из CRM ## Шаг 1. Подготовка данных для привязки к визитам {#data} Метрика привязывает данные из CRM к посетителям и их визитам на сайте. Для привязки Метрика использует характеристики клиентов (`phones`, `emails`, `phones_md5`, `emails_md5`), а также специальный идентификатор [ClientId](https://yandex.ru/support/metrica/general/clientid-userid.html?lang=ru). Идентификатор Метрики [ClientId](https://yandex.ru/support/metrica/general/clientid-userid.html?lang=ru) обеспечивает самый высокий уровень привязки заказов к визитам пользователей на сайте — рекомендуем передавать именно его. **Как настроить передачу ClientID?** Передача [ClientId](https://yandex.ru/support/metrica/general/clientid-userid.html?lang=ru) — это процесс включения уникального идентификатора пользователя Метрики в записи о сделках в вашей CRM-системе. Настройте передачу параметра в зависимости от того, как именно происходит контакт с пользователем: - **Формы и заказы на сайте**. Получите `ClientId` с помощью JavaScript-метода [getClientID](https://yandex.ru/support/metrica/objects/get-client-id.html?lang=ru) и запишите его в скрытое поле ваших лид-форм для последующей передачи в CRM. - **Звонки посетителей**. Если в вашей CRM сделки создаются после звонков, то, скорее всего, вы используете сервис коллтрекинга. Проверьте, что ваша система коллтрекинга имеет функцию передачи `ClientId` в сделки внутри CRM. - **Письма от посетителей**. Для сделок, инициированных через e-mail, используйте сервисы e-mail-трекинга, которые позволяют определить `ClientId` отправителя письма благодаря подмене e-mail-адресов на сайте и отправить информацию о новом письме в вашу CRM в виде сделки. - **Чаты в мессенджерах**. При начале общения в мессенджерах инициируйте метод [getClientID](https://yandex.ru/support/metrica/objects/get-client-id.html?lang=ru) на сайте и включите идентификатор `ClientId` в диплинк (Telegram, Viber) или в шаблон сообщения (WhatsApp). При создании сделки указывайте идентификатор в отдельном поле. - **Виджеты на сайте**. Удостоверьтесь, что виджеты, используемые на сайте, могут передавать `ClientId` Метрики в вашу CRM при передаче сделок. {% note info %} Если вы не можете записать идентификатор [ClientId](https://yandex.ru/support/metrica/general/clientid-userid.html?lang=ru) (например, при покупке в офлайн-точке) или настроить его передачу из своей CRM, используйте опцию Дополнительные настройки отслеживания в настройках счетчика для более точной привязки заказов по e-mail и телефонам. {% endnote %} ## Шаг 2. Подготовка данных о клиентах и заказах {#csv} Для отправки нужно подготовить ваши данные из CRM: #### 2.1 Распределите статусы заказов из вашей CRM по типам статусов заказов в Метрике Распределите все статусы, которые есть в вашей CRM, на группы соответствий с типами статусов в Метрике: - `PAID` — оплачен (применяется по умолчанию если вы не передаете статусы заказов), при передаче будут достигнуты цели **CRM: Заказ создан** и **CRM: Заказ оплачен**; - `IN_PROGRESS` — в работе, при передаче будет достигнута цель **CRM: Заказ создан**; - `CANCELLED` — отменен, при передаче будет достигнута цель **CRM: Заказ отменен**; - `SPAM` — спам, при передаче будет достигнута цель **CRM: Спам заказ**; - `OTHER` — заказы в другом статусе, этот тип статуса будет автоматически использован если вы пришлете в качестве статуса заказа идентификатор javascript-цели или укажете его вручную. Без сопоставления вам доступны статусы по умолчанию — в виде статуса можно прислать идентификаторы `PAID`, `IN_PROGRESS`, `CANCELLED`, `SPAM` и идентификаторы javascript-целей вашего счетчика. Сопоставить передаваемые статусы заказов с типами статусов в Метрике можно с помощью метода [POST /cdp/api/v1/counter/{counterId}/schema/order_statuses](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/mapOrderStatuses.md). Например, статусу **Новый** c идентификатором `new` можно назначить тип `IN_PROGRESS` (в работе), статусу **Успешно** c идентификатором `success` — тип `PAID` (оплачен). [Подробнее про сопоставление статусов заказов](https://yandex.com.tr/dev/metrika/ru/data-import/maporderstatuses-about.md) #### 2.2 Подготовьте информацию о клиентах в вашей CRM под формат клиентов в Метрике Информация о клиентах включает в себя идентификатор клиента в вашей CRM (обязательный параметр), название (имя) клиента, дата и время создания контакта в часовом поясе счетчика, дата и время последнего обновления контакта и идентификаторы для сопоставления клиента с визитами в Метрике — `client_ids`, адреса электронной почты и телефоны. [Подробнее про формат данных о клиентах](https://yandex.com.tr/dev/metrika/ru/data-import/contacts-data.md) #### 2.3 Подготовьте информацию о сделках в вашей CRM под формат сделок в Метрике Обязательными параметрами являются идентификатор заказа в вашей CRM, идентификатор клиента в вашей СRM (совершившего заказ), тип клиента, дата создания заказа в часовом поясе счетчика и статус заказа. Кроме этого, можно передать последнюю дату и время обновления заказа, дату и время завершения заказа (его выкупа/отмены), доход, себестоимость и товары (услуги) в заказе. [Подробнее о формате данных о заказах](https://yandex.com.tr/dev/metrika/ru/data-import/orders-data.md) #### 2.4 (Опционально) — передача дополнительной информации о клиентах и заказах в виде дополнительных атрибутов и товаров Определите, какие дополнительные данные о клиентах и заказах вы хотите передавать. С помощью этой информации можно строить сегменты, которые можно отслеживать в отчетах Метрики или использовать в рекламе. **Атрибуты для клиентов и заказов** Например, можно создать атрибут «размер обуви» и сформировать сегмент аудитории с заданным размером. Затем настроить в Директе ретаргетинг на эту аудиторию и показать специальное предложение. Примеры дополнительных данных: тип клиента (VIP, физическое лицо, юридическое лицо), тип услуги, категория товара. Чтобы создать дополнительные атрибуты, используйте метод [POST /cdp/api/v1/counter/{counterId}/schema/attributes](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/createAttributes.md) с path-параметром: - `entity_type=contact` для передачи пользовательских полей клиентов; - `entity_type=order` для передачи пользовательских полей заказов. **Списки товаров** Загрузите списки товаров/услуг для ваших заказов – после этого в Метрике будут доступны данные из этих списков, например, названия товаров. Используйте метод [POST /cdp/api/v1/counter/{counterId}/schema/products](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/createProducts.md). ## Шаг 3. Отправка данных о клиентах и заказах {#upload} Передайте данные о клиентах и заказах в CSV-формате или внутри запроса в формате JSON. Формат CSV можно передавать несколькими способами: - CSV-файл. В файле укажите данные, которые хотите передать в Метрику. - multipart/form-data. В первой строке необходимо передать названия колонок. Загрузите данные из CRM в Метрику: **О клиентах** - в CSV-файле с помощью метода [POST /cdp/api/v1/counter/{counterId}/data/contacts/csv](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/uploadContacts.md); - в теле запроса с помощью метода [POST /cdp/api/v1/counter/{counterId}/data/contacts/json](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/uploadContactJson_1.md). Рекомендуем сделать первую загрузку клиентов как можно раньше — данные о заказах будут привязываться к визитам, которые были совершены после первой удачной загрузки информации о клиентах. **О заказах** - в CSV-файле с помощью метода [POST /cdp/api/v1/counter/{counterId}/data/orders/csv](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/uploadOrders.md); - в теле запроса с помощью метода [POST /cdp/api/v1/counter/{counterId}/data/orders/json](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/uploadOrdersJson_1.md).