--- metadata: - name: generator content: Diplodoc Platform v5.61.1 alternate: - https://yandex.com/dev/audience/en/intro/data-requirements.md - https://yandex.com/dev/audience/ru/intro/data-requirements.md - href: https://yandex.com/dev/audience/ru/intro/data-requirements.md type: text/markdown title: Markdown version - href: https://yandex.com/dev/audience/ru/llms.txt?revision=r21347131 rel: describedby --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/audience/ru/llms.txt?revision=r21347131 # Требования к данным Выберите тип загружаемых данных: - [Универсальный сегмент](#unified) - [ID мобильных устройств](#device-id) - [MAC-адреса](#mac) - [Данные CRM](#crm) - [ClientID Яндекс Метрики](#client-id) ## Универсальный сегмент {#unified} #| || **Расширение** | CSV || || **Максимальный размер** | 1 ГБ || || **Кодировка** | UTF-8 или Windows-1251 || || **Формат записей** | В первой строке должны быть перечислены названия колонок, отделенные друг от друга запятой. Каждая строка файла — отдельная запись о пользователе. Поля записи отделяются друг от друга запятой. Универсальный сегмент позволяет загрузить файл с разными колонками под каждый тип данных о пользователе. Значения полей могут быть захешированы (SHA-256). Под одну колонку можно передать несколько идентификаторов — для этого перечислите их через запятую и заключите в кавычки. Допустимые колонки (распознаваемые системой): #| || `phone` | Номер телефона. Числовая строка, содержащая номер мобильного телефона с указанием кода страны. Нельзя использовать пробелы и дополнительные символы. ![](../../_images/button-ok.png)`79995551111` ![](../../_images/button-cancel.png)`7 (999) 555-11-11` || || `email` | Адрес электронной почты. Строка латиницей, включающая символ @ и имя домена. Нельзя использовать прописные буквы. ![](../../_images/button-ok.png)`mail@yandex.ru` ![](../../_images/button-cancel.png)`Mail@yandex.ru` || || `idfa_gaid` | Идентификаторы устройств (IDFA для iOS, GAID для Android). Строка в формате UUID. ![](../../_images/button-ok.png)`aaaaaaaa-bbbb-cccc-1111-222222222200` || || `mac` | MAC-адрес. Строка в hex-формате. Нельзя использовать символы `. , : -`. ![](../../_images/button-ok.png)`AE123456D0A1` || || `client_id` | Идентификатор ClientID Яндекс Метрики. Числовая строка. || || | Другие колонки. Произвольные колонки с дополнительными данными о пользователе — они сохраняются, но не участвуют в матчинге. || |# Для захешированных значений добавьте суффикс `_SHA256` к названию колонки, например `email_SHA256`, `phone_SHA256`. {% cut "Пример записей без хеширования" %} ```no-highlight translate=no phone,email,client_id 79876543210,mail@yandex.ru,9876543210123456789 79012345678,,1234567890123456789 "79876543210,79012345678",example3@yandex.ru, ``` {% endcut %} {% cut "Пример передачи SHA-256" %} ```no-highlight translate=no phone_SHA256,email_SHA256,client_id bd93ea95f242f02313eccf0ab0bb7fe5121a052de42d2cb7bd332fb9f537cbfa,,9876543210123456789 8901673b64eeb535bb563cf06b794f2b74dacfb756297cba8bc71e9a09a62e93,bd93ea95f242f02313eccf0ab0bb7fe5121a052de42d2cb7bd332fb9f537cbfa, "bd93ea95f242f02313eccf0ab0bb7fe5121a052de42d2cb7bd332fb9f537cbfa,8901673b64eeb535bb563cf06b794f2b74dacfb756297cba8bc71e9a09a62e93",8901673b64eeb535bb563cf06b794f2b74dacfb756297cba8bc71e9a09a62e93,9876543210123456789 ``` {% endcut %} || || **Минимальное количество записей** | 100 || |# ## ID мобильных устройств {#device-id} #| || **Расширение** | CSV или TXT || || **Максимальный размер** | 1 ГБ || || **Кодировка** | UTF-8 или Windows-1251 || || **Разделитель записей** | {% cut "Запятая" %} ```translate=no aaaaaaaa-bbbb-cccc-1111-222222222200,aaaaaaaa-bbbb-cccc-1111-222222222201 ``` {% endcut %} {% cut "Перенос строки" %} ```translate=no aaaaaaaa-bbbb-cccc-1111-222222222200 aaaaaaaa-bbbb-cccc-1111-222222222201 ``` {% endcut %} {% cut "Табуляция" %} ```translate=no aaaaaaaa-bbbb-cccc-1111-222222222200 aaaaaaaa-bbbb-cccc-1111-222222222201 ``` {% endcut %} || || **Формат записей** | В первой строке должны быть перечислены названия колонок, отделенные друг от друга запятой. **Android (GAID)**   : Буквенно-числовая строка в нижнем регистре, разделитель — дефис. ![](../../_images/button-ok.png) `aaaaaaaa-bbbb-cccc-1111-222222222200` **iOS (IDFA)**   : Буквенно-числовая строка в верхнем регистре, разделитель — дефис. ![](../../_images/button-ok.png)`AAAAAAAAA-BBBB-CCCC-1111-222222220000` ![](../../_images/button-cancel.png)`aaaaAAAAABBBBCCCC1111222222220000` Данные в файле могут быть захешированы (SHA-256). При этом каждая запись должна быть захеширована отдельно. {% note alert "" %} С 1 января 2025 года загрузка новых хешей MD5 не поддерживается. Для загрузки данных используйте SHA‑256. {% endnote %} Для захешированных значений добавьте суффикс `_SHA256` к названию колонки. {% cut "Пример передачи SHA-256" %} ```translate=no idfa_gaid_SHA256 7f5a79d4db79f26ed3c0561ac2fa6d67dd5d37671a5a49485a0ad1b98250177f e61ac33a64f562fbc02e3c6eaab03ef9fa9c3a142a3492bde07339fe45e9fd7a 91cf462f2f542a7e6f19ef7f0b5d0d046cc566cc4da58d3a62a48c5a6fa24de5 ``` {% endcut %} || || **Минимальное количество записей** | 100 || |# ## MAC-адреса {#mac} #| || **Расширение** | CSV или TXT || || **Максимальный размер** | 1 ГБ || || **Кодировка** | UTF-8 или Windows-1251 || || **Разделитель записей** | {% cut "Запятая" %} ```translate=no AE123456D0A1,AE123456D0A0 ``` {% endcut %} {% cut "Перенос строки" %} ```translate=no AE123456D0A1 AE123456D0A0 ``` {% endcut %} {% cut "Табуляция" %} ```translate=no AE123456D0A1 AE123456D0A0 ``` {% endcut %} || || **Формат записей** | Строка в hex-формате. MAC-адрес может быть захеширован (SHA-256) или не захеширован. Регистр незахешированного MAC-адреса не важен. Регистр MAC-адреса до хеширования на стороне клиента также не важен. Нельзя использовать символы `. , : -`. ![](../../_images/button-ok.png) незахешированный MAC-адрес — `AE123456D0A1`, захешированный MAC-адрес — `f74c5e094cea3ecc6289924b11903e8d9920ec4faf38f7ff82b949c5b1214b6c` ![](../../_images/button-cancel.png)`5c:26:0a:6e:b5:bf` Чтобы сформировать захешированный MAC-адрес: преобразуйте hex-строку в byte-строку (два символа в hex — один байт) и возьмите от нее SHA-256-хеш. Контрольная пара для проверки: mac — AE123456D0A1, mac_hash — f74c5e094cea3ecc6289924b11903e8d9920ec4faf38f7ff82b949c5b1214b6c. {% note alert "" %} С 1 января 2025 года загрузка новых хешей MD5 не поддерживается. Для загрузки данных используйте SHA‑256. {% endnote %} || || **Минимальное количество записей** | 100 || |# ## Данные из CRM {#crm} #| || **Расширение** | CSV || || **Максимальный размер** | 1 ГБ || || **Кодировка** | UTF-8 или Windows-1251 || || **Формат записей** | В первой строке должны быть перечислены названия полей, отделенные друг от друга запятой. Каждая строка файла — отдельная запись о клиенте. Поля записи отделяются друг от друга запятой. Для захешированных значений добавьте суффикс `_SHA256` к названию колонки, например `email_SHA256`, `phone_SHA256`. {% note alert "" %} С 1 января 2025 года загрузка новых хешей MD5 не поддерживается. Для загрузки данных используйте SHA‑256. {% endnote %} В записи должно быть хотя бы одно из полей `phone` или `email`. Остальные поля — необязательные. #| || `phone` | Номер телефона. Числовая строка, содержащая номер мобильного телефона с указанием кода страны. Нельзя использовать пробелы и дополнительные символы. ![](../../_images/button-ok.png)`79995551111` ![](../../_images/button-cancel.png)`7 (999) 555-11-11` || || `email` | Адрес электронной почты. Строка латиницей, включающая символ @ и имя домена. Нельзя использовать прописные буквы. ![](../../_images/button-ok.png)`mail@yandex.ru` ![](../../_images/button-cancel.png)`Mail@yandex.ru` || || `external_id` | Идентификатор клиента в CRM. Численно-буквенная строка без пробелов и дополнительных символов. || || | Другие поля, содержащие информацию о клиенте, например, пол или дату рождения клиента. || |# {% cut "Пример записей без хеширования" %} ```no-highlight translate=no external_id,phone,email,gender,birthdate 1,79876543210,mail@yandex.ru,M,01.01.1970 2,79012345678,example2@yandex.ru,F,01.01.1980 ``` {% endcut %} {% cut "Пример передачи SHA-256" %} ```no-highlight translate=no external_id,phone,email,gender,birthdate 1,8bf7d8ef683ac4d7cf7fc6390f99c06e76e0b2022ec0c857c92e0041a53a3d66,bd93ea95f242f02313eccf0ab0bb7fe5121a052de42d2cb7bd332fb9f537cbfa,M,01.01.1970 2,f1d83756463b8173a2ec0919afcde6dc0c540de09f1c22620dd5d8150da7d9b7,8901673b64eeb535bb563cf06b794f2b74dacfb756297cba8bc71e9a09a62e93,F,01.01.1980 ``` {% endcut %} || || **Минимальное количество записей** | 100 || |# ## ClientID Яндекс Метрики {#client-id} #| || **Расширение** | CSV или TXT || || **Максимальный размер** | 1 ГБ || || **Кодировка** | UTF-8 или Windows-1251 || || **Разделитель записей** | {% cut "Перенос строки" %} ```translate=no 1234567890123456789 9876543210987654321 ``` {% endcut %} {% cut "Запятая" %} ```translate=no 1234567890123456789,9876543210987654321 ``` {% endcut %} {% cut "Табуляция" %} ```translate=no 1234567890123456789 9876543210987654321 ``` {% endcut %} || || **Формат записей** | Числовая строка — идентификатор ClientID Яндекс Метрики. Каждая запись — отдельный ClientID. ![](../../_images/button-ok.png)`1234567890123456789` Данные не хешируются. || || **Минимальное количество записей** | 100 || |#