Поддержка Авито Рекламы не сможет за вас захешировать файл с данными, вам нужно сделать это самостоятельно, следуя инструкциям ниже

Если у вас есть уже своя база с информацией об аудитории, вы можете её загрузить в рекламный кабинет.

Технические требования к файлу с готовыми аудиториям:

— Загрузить можно только файлы, данные в которых в виде hash SHA-256.
— Максимальный вес не более 1 GB в формате CSV.

Обратите внимание — пример захешированного файла

В нём показано, как должен выглядеть документ с аудиторией, подходящий для загрузки.

Как хешировать данные:

Тип файла: CSV, максимальный размер — 1 GB.
Хеширование: SHA-256.

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

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

phone

Номер телефона — строка, которая содержит номер мобильного, с указанием кода страны. Использовать пробелы и дополнительные символы нельзя:

✅79991112223
❌+7(999)555-11-11

Как будет выглядеть строчка «phone» с номером 79991112223 в виде хешей: e640586542f78f00455559fe84f6350db28efffa6e2b4390d836dfd39d6ed8ed

email

Адрес электронной почты — строка, в которой указан email, включающая символ @ и имя домена. Нельзя использовать прописные буквы.

✅avito@avito.ru
❌Avito@avito.ru

Как будет выглядеть строчка «email» с почтой avito@avito.ru в виде хешей: c1daf8e49916fe94571010573bf103e95db4bc6b074f1e3e1056e54405d92742

Используйте пример выше, чтобы проверить, верно ли у вас получается захешировать данные.

Далее аудитория загрузится в конструктор и начнёт собираться. Это займёт до 12 часов. После этого изучить загруженную аудиторию можно с помощью визуализации

Если загруженная база пустая и там нет строк, то в объеме будет указан прочерк (нулевая база):

Если вы загружаете хешированную аудиторию, укажите, использовалась ли соль при хешировании. Это нужно, чтобы мы могли корректно обработать данные и сопоставить аудиторию.

Это необязательная функция, файл с хешированием можно загрузить и без неё.

Что такое соль

Соль — это дополнительная строка символов, которая добавляется к данным клиента перед хешированием.

Например, перед хешированием к номеру телефона добавляют строку abc123.

После этого итоговая строка хешируется алгоритмом SHA-256.

Соль используют, чтобы:

• повысить безопасность и приватность данных клиентов;
• сделать хеши более устойчивыми к подбору;
• снизить вероятность сопоставления хешей с данными из других систем.

Как работает соль

Соль добавляется к исходному значению до хеширования в SHA-256.

Возможны два варианта:

salt + phone → SHA-256
или
phone + salt → SHA-256

Важно указать не только саму соль, но и способ её добавления: в начало или в конец исходной строки.

Если хеши были сформированы с использованием соли, но вы не передали нам эту информацию, мы не сможем корректно обработать или сопоставить данные. Из-за этого аудитория может не загрузиться либо загрузиться с низким match rate.

Нужно ли добавлять соль в базу

Нет, добавлять соль в файл или базу отдельным столбцом не нужно.

Если вы уже использовали соль при хешировании данных, укажите её в форме загрузки аудитории:

• что соль использовалась;
• значение соли;
• куда она добавлялась — в начало или в конец строки;
• размер соли — до 128 бит.

Эта информация нужна только для корректной обработки и сопоставления CRM-данных.

Если ваши данные были захешированы без соли, не добавляйте соль после хеширования. В этом случае выберите вариант без соли.

Требования к соли

Соль должна добавляться до хеширования в SHA-256.

Допустимые символы:

• латинские буквы: a-z, A-Z;
• цифры: 0-9;
• ASCII-спецсимволы:
• ! @ # $ % ^ & * ( ) _ - + = . , : ; / \ ? | ~

Не допускаются:

• кириллица;
• unicode-символы;
• emoji;
• невидимые unicode-символы;
• переносы строк;
• лишние пробелы в начале или конце строки.

Перед отправкой проверьте, что соль скопировалась полностью и без лишних символов.

Если появилась ошибка при вводе соли

Ошибка может появиться, если:

• в соли есть недопустимые символы;
• использована кириллица, emoji или unicode-символы;
• в значение попал перенос строки;
• соль превышает допустимый размер;
• не выбран способ добавления соли: в начало или в конец строки.

Исправьте значение соли и попробуйте загрузить аудиторию ещё раз.