---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com.tr/dev/metrika/en/data-import/contacts-data.md
  - https://yandex.com.tr/dev/metrika/ru/data-import/contacts-data.md
  - href: ru/data-import/contacts-data.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/metrika/ru/llms.txt

# Формат данных о клиентах

Обязательные колонки:

- `uniq_id` — идентификатор клиента. Наример, ID клиента в CRM. Произвольная строка.

Необязательные колонки:

Все данные можно изменять.

- `name` — название клиента. Произвольная строка.
- `create_date_time` — дата и время создания контакта в часовом поясе счетчика. [Подробно](https://yandex.com.tr/dev/metrika/ru/data-import/date.md)
- `update_date_time` — дата и время обновления контакта в часовом поясе счетчика. [Подробно](https://yandex.com.tr/dev/metrika/ru/data-import/date.md)
- `client_ids` — список ClientID. Подробно см. в [Подготовка данных для привязки к визитам](https://yandex.com.tr/dev/metrika/ru/data-import/data.md#data).
- `emails` — список адресов электронной почты клиента. Строка латиницей, включающая символ @ и имя домена. Нельзя использовать прописные буквы. Пример: `mail@yandex.ru`.
- `phones` — список телефонных номеров клиента. Числовая строка, содержащая номер мобильного телефона с указанием кода страны. Нельзя использовать пробелы и дополнительные символы. Пример: `79995551111`.
- `emails_md5` — список адресов электронной почты клиента, [хешированных в формате md5](https://yandex.com.tr/dev/metrika/ru/data-import/hashing.md). Для проверки алгоритма, которым вы пользуетесь для хеширования, вы можете использовать почту `mail@yandex.ru`. Хеш от нее должен получиться: `3c56ff8fef0f6c65b36b2d25720fe276`.
- `phones_md5` — список телефонных номеров клиента, [хешированных в формате md5](https://yandex.com.tr/dev/metrika/ru/data-import/hashing.md). Для проверки алгоритма, которым вы пользуетесь для хеширования, вы можете использовать номер телефона `79995551111`. Хеш от него должен получиться: `f09f2c3d48f31e2a802944ade2e5aec5`.

{% note tip %}

Для привязки заказов из CRM c визитами Метрики, передавайте полную информацию о клиентах: ClientID, адрес электронной почты, телефон. Или, как минимум, одну из характеристик клиента.

{% endnote %}

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

1. Создайте атрибут, который будет соответствовать вашему дополнительному параметру — с помощью метода [POST /cdp/api/v1/counter/{counterId}/schema/attributes](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/createAttributes.md).
2. Передайте атрибут вместе с другими данными о клиентах — с помощью метода POST /cdp/api/v1/counter/{counterId}/data/contacts ([CSV](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/uploadContacts.md) или [JSON](https://yandex.com.tr/dev/metrika/ru/management/openapi/schema/uploadContactJson_1.md)). При использовании JSON для удобства можно использовать массив `attribute_values`.

## Узнайте больше

- [Формат данных о заказах](https://yandex.com.tr/dev/metrika/ru/data-import/orders-data.md)
- [Формат даты и времени](https://yandex.com.tr/dev/metrika/ru/data-import/date.md)