Data requirements

Select the type of data to be uploaded:

Mobile device IDs

Expansion	CSV or TXT
Maximum size	1 GB
Encoding	UTF-8 or Windows-1251
Entry separator	Comma `aaaaaaaa-bbbb-cccc-1111-222222222200,aaaaaaaa-bbbb-cccc-1111-222222222201` Line break `aaaaaaaa-bbbb-cccc-1111-222222222200 aaaaaaaa-bbbb-cccc-1111-222222222201` Tab `aaaaaaaa-bbbb-cccc-1111-222222222200 aaaaaaaa-bbbb-cccc-1111-222222222201`
Entry format	Android (GAID) Lowercase alphanumeric string separated by hyphens. `aaaaaaaa-bbbb-cccc-1111-222222222200` iOS (IDFA) Uppercase alphanumeric string separated by hyphens. `AAAAAAAAA-BBBB-CCCC-1111-222222220000` `aaaaAAAAABBBBCCCC1111222222220000` Data in your file can be hashed (SHA-256). In this case, each entry must be hashed separately. Starting January 2025, uploading new MD5 hashes is no longer supported. To upload new data, use SHA‑256. Example of sending data with SHA-256 hashing `7f5a79d4db79f26ed3c0561ac2fa6d67dd5d37671a5a49485a0ad1b98250177f e61ac33a64f562fbc02e3c6eaab03ef9fa9c3a142a3492bde07339fe45e9fd7a 91cf462f2f542a7e6f19ef7f0b5d0d046cc566cc4da58d3a62a48c5a6fa24de5`
Minimum number of entries	100

MAC addresses

Expansion	CSV or TXT
Maximum size	1 GB
Encoding	UTF-8 or Windows-1251
Entry separator	Comma `AE123456D0A1,AE123456D0A0` Line break `AE123456D0A1 AE123456D0A0` Tab `AE123456D0A1 AE123456D0A0`
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. Unhashed MAC address — `AE123456D0A1`, hashed MAC address — `f74c5e094cea3ecc6289924b11903e8d9920ec4faf38f7ff82b949c5b1214b6c` `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. Starting January 2025, uploading new MD5 hashes is no longer supported. To upload new data, use SHA‑256.
Minimum number of entries	100

Data from the 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.

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

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. `79995551111` `7 (999) 555-11-11`
`email`	Email address. String of Latin characters, including the @ symbol and domain name. You can't use uppercase letters. `mail@yandex.ru` `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.

Example of an unhashed entry

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

Example of sending data with SHA-256 hashing

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

Minimum number of entries

100

Was the article helpful?

API versions

Error descriptions