Требования к данным

Выберите тип загружаемых данных:

Универсальный сегмент

Расширение

CSV

Максимальный размер

1 ГБ

Кодировка

UTF-8 или Windows-1251

Формат записей

В первой строке должны быть перечислены названия колонок, отделенные друг от друга запятой. Каждая строка файла — отдельная запись о пользователе. Поля записи отделяются друг от друга запятой.

Универсальный сегмент позволяет загрузить файл с разными колонками под каждый тип данных о пользователе. Значения полей могут быть захешированы (SHA-256).

Под одну колонку можно передать несколько идентификаторов — для этого перечислите их через запятую и заключите в кавычки.

Допустимые колонки (распознаваемые системой):

`phone`	Номер телефона. Числовая строка, содержащая номер мобильного телефона с указанием кода страны. Нельзя использовать пробелы и дополнительные символы. `79995551111` `7 (999) 555-11-11`
`email`	Адрес электронной почты. Строка латиницей, включающая символ @ и имя домена. Нельзя использовать прописные буквы. `mail@yandex.ru` `Mail@yandex.ru`
`idfa_gaid`	Идентификаторы устройств (IDFA для iOS, GAID для Android). Строка в формате UUID. `aaaaaaaa-bbbb-cccc-1111-222222222200`
`mac`	MAC-адрес. Строка в hex-формате. Нельзя использовать символы `. , : -`. `AE123456D0A1`
`client_id`	Идентификатор ClientID Яндекс Метрики. Числовая строка.
	Другие колонки. Произвольные колонки с дополнительными данными о пользователе — они сохраняются, но не участвуют в матчинге.

Для захешированных значений добавьте суффикс _SHA256 к названию колонки, например email_SHA256, phone_SHA256.

Пример записей без хеширования

phone,email,client_id
79876543210,mail@yandex.ru,9876543210123456789
79012345678,,1234567890123456789
"79876543210,79012345678",example3@yandex.ru,

Пример передачи SHA-256

phone_SHA256,email_SHA256,client_id
bd93ea95f242f02313eccf0ab0bb7fe5121a052de42d2cb7bd332fb9f537cbfa,,9876543210123456789
8901673b64eeb535bb563cf06b794f2b74dacfb756297cba8bc71e9a09a62e93,bd93ea95f242f02313eccf0ab0bb7fe5121a052de42d2cb7bd332fb9f537cbfa,
"bd93ea95f242f02313eccf0ab0bb7fe5121a052de42d2cb7bd332fb9f537cbfa,8901673b64eeb535bb563cf06b794f2b74dacfb756297cba8bc71e9a09a62e93",8901673b64eeb535bb563cf06b794f2b74dacfb756297cba8bc71e9a09a62e93,9876543210123456789

Минимальное количество записей

100

ID мобильных устройств

Расширение	CSV или TXT
Максимальный размер	1 ГБ
Кодировка	UTF-8 или Windows-1251
Разделитель записей	Запятая `aaaaaaaa-bbbb-cccc-1111-222222222200,aaaaaaaa-bbbb-cccc-1111-222222222201` Перенос строки `aaaaaaaa-bbbb-cccc-1111-222222222200 aaaaaaaa-bbbb-cccc-1111-222222222201` Табуляция `aaaaaaaa-bbbb-cccc-1111-222222222200 aaaaaaaa-bbbb-cccc-1111-222222222201`
Формат записей	В первой строке должны быть перечислены названия колонок, отделенные друг от друга запятой. Android (GAID) Буквенно-числовая строка в нижнем регистре, разделитель — дефис. `aaaaaaaa-bbbb-cccc-1111-222222222200` iOS (IDFA) Буквенно-числовая строка в верхнем регистре, разделитель — дефис. `AAAAAAAAA-BBBB-CCCC-1111-222222220000` `aaaaAAAAABBBBCCCC1111222222220000` Данные в файле могут быть захешированы (SHA-256). При этом каждая запись должна быть захеширована отдельно. С 1 января 2025 года загрузка новых хешей MD5 не поддерживается. Для загрузки данных используйте SHA‑256. Для захешированных значений добавьте суффикс `_SHA256` к названию колонки. Пример передачи SHA-256 `idfa_gaid_SHA256 7f5a79d4db79f26ed3c0561ac2fa6d67dd5d37671a5a49485a0ad1b98250177f e61ac33a64f562fbc02e3c6eaab03ef9fa9c3a142a3492bde07339fe45e9fd7a 91cf462f2f542a7e6f19ef7f0b5d0d046cc566cc4da58d3a62a48c5a6fa24de5`
Минимальное количество записей	100

MAC-адреса

Расширение	CSV или TXT
Максимальный размер	1 ГБ
Кодировка	UTF-8 или Windows-1251
Разделитель записей	Запятая `AE123456D0A1,AE123456D0A0` Перенос строки `AE123456D0A1 AE123456D0A0` Табуляция `AE123456D0A1 AE123456D0A0`
Формат записей	Строка в hex-формате. MAC-адрес может быть захеширован (SHA-256) или не захеширован. Регистр незахешированного MAC-адреса не важен. Регистр MAC-адреса до хеширования на стороне клиента также не важен. Нельзя использовать символы `. , : -`. незахешированный MAC-адрес — `AE123456D0A1`, захешированный MAC-адрес — `f74c5e094cea3ecc6289924b11903e8d9920ec4faf38f7ff82b949c5b1214b6c` `5c:26:0a:6e:b5:bf` Чтобы сформировать захешированный MAC-адрес: преобразуйте hex-строку в byte-строку (два символа в hex — один байт) и возьмите от нее SHA-256-хеш. Контрольная пара для проверки: mac — AE123456D0A1, mac_hash — f74c5e094cea3ecc6289924b11903e8d9920ec4faf38f7ff82b949c5b1214b6c. С 1 января 2025 года загрузка новых хешей MD5 не поддерживается. Для загрузки данных используйте SHA‑256.
Минимальное количество записей	100

Данные из CRM

Расширение

CSV

Максимальный размер

1 ГБ

Кодировка

UTF-8 или Windows-1251

Формат записей

В первой строке должны быть перечислены названия полей, отделенные друг от друга запятой. Каждая строка файла — отдельная запись о клиенте. Поля записи отделяются друг от друга запятой.

Для захешированных значений добавьте суффикс _SHA256 к названию колонки, например email_SHA256, phone_SHA256.

С 1 января 2025 года загрузка новых хешей MD5 не поддерживается. Для загрузки данных используйте SHA‑256.

В записи должно быть хотя бы одно из полей phone или email. Остальные поля — необязательные.

`phone`	Номер телефона. Числовая строка, содержащая номер мобильного телефона с указанием кода страны. Нельзя использовать пробелы и дополнительные символы. `79995551111` `7 (999) 555-11-11`
`email`	Адрес электронной почты. Строка латиницей, включающая символ @ и имя домена. Нельзя использовать прописные буквы. `mail@yandex.ru` `Mail@yandex.ru`
`external_id`	Идентификатор клиента в CRM. Численно-буквенная строка без пробелов и дополнительных символов.
	Другие поля, содержащие информацию о клиенте, например, пол или дату рождения клиента.

Пример записей без хеширования

external_id,phone,email,gender,birthdate
1,79876543210,mail@yandex.ru,M,01.01.1970
2,79012345678,example2@yandex.ru,F,01.01.1980

Пример передачи SHA-256

external_id,phone,email,gender,birthdate
1,8bf7d8ef683ac4d7cf7fc6390f99c06e76e0b2022ec0c857c92e0041a53a3d66,bd93ea95f242f02313eccf0ab0bb7fe5121a052de42d2cb7bd332fb9f537cbfa,M,01.01.1970
2,f1d83756463b8173a2ec0919afcde6dc0c540de09f1c22620dd5d8150da7d9b7,8901673b64eeb535bb563cf06b794f2b74dacfb756297cba8bc71e9a09a62e93,F,01.01.1980

Минимальное количество записей

100

ClientID Яндекс Метрики

Расширение	CSV или TXT
Максимальный размер	1 ГБ
Кодировка	UTF-8 или Windows-1251
Разделитель записей	Перенос строки `1234567890123456789 9876543210987654321` Запятая `1234567890123456789,9876543210987654321` Табуляция `1234567890123456789 9876543210987654321`
Формат записей	Числовая строка — идентификатор ClientID Яндекс Метрики. Каждая запись — отдельный ClientID. `1234567890123456789` Данные не хешируются.
Минимальное количество записей	100

Была ли статья полезна?

Версии API

Описание ошибок