---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.3
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/en/intro/data-requirements.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/dev/audience/en/llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/audience/en/llms.txt

# Data requirements

Select the type of data to be uploaded:

- [Mobile device IDs](#device-id)
- [MAC addresses](#mac)
- [Data from the CRM](#crm)

## Mobile device IDs {#device-id}

#|
||
**Expansion**
|
CSV or TXT
||
||
**Maximum size**
|
1 GB
||
||
**Encoding**
|
UTF-8 or Windows-1251
||
||
**Entry separator**
|
{% cut "Comma" %}

```translate=no
aaaaaaaa-bbbb-cccc-1111-222222222200,aaaaaaaa-bbbb-cccc-1111-222222222201
```

{% endcut %}

{% cut "Line break" %}

```translate=no
aaaaaaaa-bbbb-cccc-1111-222222222200
aaaaaaaa-bbbb-cccc-1111-222222222201
```

{% endcut %}

{% cut "Tab" %}

```translate=no
aaaaaaaa-bbbb-cccc-1111-222222222200    aaaaaaaa-bbbb-cccc-1111-222222222201
```

{% endcut %}
||
||
**Entry format**
|
**Android (GAID)**

 
:   <!-- source: en/_includes/def-1.md -->
    Lowercase alphanumeric string separated by hyphens.
        
    ![](../../_images/button-ok.png) `aaaaaaaa-bbbb-cccc-1111-222222222200`
    <!-- endsource: en/_includes/def-1.md -->

**iOS (IDFA)**

 
:   <!-- source: en/_includes/def-2.md -->
    Uppercase alphanumeric string separated by hyphens.
        
    ![](../../_images/button-ok.png)`AAAAAAAAA-BBBB-CCCC-1111-222222220000`
        
    ![](../../_images/button-cancel.png)`aaaaAAAAABBBBCCCC1111222222220000`
    <!-- endsource: en/_includes/def-2.md -->

Data in your file can be hashed (SHA-256). In this case, each entry must be hashed separately.

{% note alert "" %}

Starting January 2025, uploading new MD5 hashes is no longer supported. To upload new data, use SHA‑256.

{% endnote %}

{% cut "Example of sending data with SHA-256 hashing" %}

```translate=no
7f5a79d4db79f26ed3c0561ac2fa6d67dd5d37671a5a49485a0ad1b98250177f
e61ac33a64f562fbc02e3c6eaab03ef9fa9c3a142a3492bde07339fe45e9fd7a
91cf462f2f542a7e6f19ef7f0b5d0d046cc566cc4da58d3a62a48c5a6fa24de5
```

{% endcut %}

||
||
**Minimum number of entries**
|
100
||

|#

## MAC addresses {#mac}

#|
||
**Expansion**
|
CSV or TXT
||
||
**Maximum size**
|
1 GB
||
||
**Encoding**
|
UTF-8 or Windows-1251
||
||
**Entry separator**
|
{% cut "Comma" %}

```translate=no
AE123456D0A1,AE123456D0A0
```

{% endcut %}

{% cut "Line break" %}

```translate=no
AE123456D0A1
AE123456D0A0
```

{% endcut %}

{% cut "Tab" %}

```translate=no
AE123456D0A1    AE123456D0A0
```

{% endcut %}
||
||
**Entry format**
|
A string in hex format. The MAC address can be hashed (SHA256) or unhashed. An unhashed MAC address is not case-sensitive. The MAC address is also not case-sensitive before hashing on the client side.

The characters `. , : -` are not allowed.

![](../../_images/button-ok.png)Unhashed MAC address — `AE123456D0A1`, hashed MAC address — `f74c5e094cea3ecc6289924b11903e8d9920ec4faf38f7ff82b949c5b1214b6c`

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

To hash a MAC address: convert the hex string to a byte string (two characters in hex is one byte) and extract the SHA256 hash from it. Control pair for verification: mac — AE123456D0A1, mac_hash — f74c5e094cea3ecc6289924b11903e8d9920ec4faf38f7ff82b949c5b1214b6c.

{% note alert "" %}

Starting January 2025, uploading new MD5 hashes is no longer supported. To upload new data, use SHA‑256.

{% endnote %}
||
||
**Minimum number of entries**
|
100
||

|#

## Data from the CRM {#crm}

#|
||
**Expansion**
|
CSV
||
||
**Maximum size**
|
1 GB
||
||
**Encoding**
|
UTF-8 or Windows-1251
||
||
**Entry format**
|
The first data string should list the field names, separated by commas. Each data string is a separate entry about a client. Entry fields are separated by commas.

Field values can be hashed (SHA-256). To make sure that values are processed correctly, when creating a segment, enable the **Hashed data** option and select the appropriate hashing algorithm.

{% note alert "" %}

Starting January 2025, uploading new MD5 hashes is no longer supported. To upload new data, use SHA‑256.

{% endnote %}

The entry must contain at least one of these fields: `phone`, `email`. Other fields are optional.

#|
||
`phone`
|
Phone number.

String of numbers that contains the mobile phone number and country code. You can't use spaces or supplementary characters.

![](../../_images/button-ok.png)`79995551111`

![](../../_images/button-cancel.png)`7 (999) 555-11-11`
||
||
`email`
|
Email address.

String of Latin characters, including the @ symbol and domain name. You can't use uppercase letters.

![](../../_images/button-ok.png)`mail@yandex.ru`

![](../../_images/button-cancel.png)`Mail@yandex.ru`
||
||
`external_id`
|
Client ID in the CRM.

Alphanumeric string without spaces or supplementary characters.
||
||

|
There are other fields containing information about the client, for example, gender or date of birth.
||

|#

{% cut "Example of an unhashed entry" %}

```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 "Example of sending data with SHA-256 hashing" %}

```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 %}
||
||
**Minimum number of entries**
|
100
||

|#