---
metadata:
  - name: generator
    content: Diplodoc Platform v5.19.4
alternate:
  - https://yandex.ru/dev/audience/en/intro/data-requirements.md
  - https://yandex.ru/dev/audience/ru/intro/data-requirements.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/audience/ru/llms.txt

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

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

- [ID мобильных устройств](#device-id)
- [MAC-адреса](#mac)
- [Данные CRM](#crm)

## 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)**

 
:   {% include notitle [def-1](../_includes/def-1-a76d420e0011.md) %}

**iOS (IDFA)**

 
:   {% include notitle [def-2](../_includes/def-2-573285d4a241.md) %}

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

{% note alert "" %}

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

{% endnote %}

{% cut "Пример передачи SHA-256" %}

```translate=no
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-адрес может быть захеширован (SHA256) или не захеширован. Регистр незахешированного MAC-адреса не важен. Регистр MAC-адреса до хеширования на стороне клиента также не важен.

Нельзя использовать символы `. , : -`.

![](../../_images/button-ok.png) незахешированный MAC-адрес — `AE123456D0A1`, захешированный MAC-адрес — `f74c5e094cea3ecc6289924b11903e8d9920ec4faf38f7ff82b949c5b1214b6c`

![](../../_images/button-cancel.png)`5c:26:0a:6e:b5:bf`

Чтобы сформировать захешированный MAC-адрес: преобразуйте hex-строку в byte-строку (два символа в hex — один байт) и возьмите от нее SHA256-хеш. Контрольная пара для проверки: mac — AE123456D0A1, mac_hash — f74c5e094cea3ecc6289924b11903e8d9920ec4faf38f7ff82b949c5b1214b6c.

{% note alert "" %}

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

{% endnote %}
||
||
**Минимальное количество записей**
|
100
||

|#

## Данные из CRM {#crm}

#|
||
**Расширение**
|
CSV
||
||
**Максимальный размер**
|
1 ГБ
||
||
**Кодировка**
|
UTF-8 или Windows-1251
||
||
**Формат записей**
|
В первой строке должны быть перечислены названия полей, отделенные друг от друга запятой. Каждая строка файла — отдельная запись о клиенте. Поля записи отделяются друг от друга запятой.

Значения полей могут быть захешированы (SHA-256). Чтобы значения обрабатывались корректно, при создании сегмента включите опцию **Хешированные данные** и выберите использованный алгоритм хеширования.

{% 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
||

|#