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

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

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

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

a31259d185ad013e0a663437c60b5d0
78ee6d68f49d2c90397d9fbffc3814d1
702e8494aeb560dff987e623e71bccf8

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

100

MAC-адреса

Расширение

CSV или TXT

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

1 ГБ

Кодировка

UTF-8 или Windows-1251

Разделитель записей
Запятая
AE123456D0A1,AE123456D0A0
Перенос строки
AE123456D0A1
AE123456D0A0
Табуляция
AE123456D0A1    AE123456D0A0

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

Строка в hex-формате. MAC-адрес может быть захеширован или не захеширован. Регистр незахешированного MAC-адреса не важен. Регистр MAC-адреса до хеширования на стороне клиента также не важен.

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

незахешированный MAC-адрес — AE123456D0A1, захешированный MAC-адрес — C5C32C30C07ABBB7580A0925D995FEE4

5c:26:0a:6e:b5:bf

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

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

100

Данные из CRM

Расширение

CSV

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

1 ГБ

Кодировка

UTF-8 или Windows-1251

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

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

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

Важно

Начиная с января 2025 года загрузка новых хешей MD5 перестанет поддерживаться. Пожалуйста, используйте SHA256 для загрузки данных.

В записи должно быть хотя бы одно из полей 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
Пример передачи MD5
external_id,phone,email,gender,birthdate
1,a31259d185ad013e0a663437c605d056,78ee6d68f49d2c90397d9ff77fc3814d1,M,01.01.1970
2,702e8494aeb560dff987eh623e71ccf8,f5ge43thaeb67df89875777e71bccf88i,F,01.01.1980
Пример передачи SHA-256
external_id,phone,email,gender,birthdate
1,90f42df8309cc6c1dfd430a3f4ea7d6bfaa19f1853c6d16ec5ca30b40006476a,b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9,M,01.01.1970
2,d5579c46dfcc7f18207013e65b44e4cb4e2c2298f4ac457ba8f82743f31e930b,d3920c46dfcc7f18207013e65b44e4cb4e2c2298f4ac457ba8f23482f31e327b,F,01.01.1980

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

100

Хеширование (MD5 + SHA-256)

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

Правильный формат:

  • MD5 — a31259d185ad013e0a663437c60b5d0, 78ee6d68f49d2c90397d9fbffc3814d1, 702e8494aeb560dff987e623e71bccf8;

  • SHA256 — 90f42df8309cc6c1dfd430a3f4ea7d6bfaa19f1853c6d16ec5ca30b40006476a, b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9, d5579c46dfcc7f18207013e65b44e4cb4e2c2298f4ac457ba8f82743f31e930b.

Предыдущая
Версии API
Следующая
Описание ошибок