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

Для этого можно использовать как и не хешированный файлы с данными email и номеров телефонов, так и хешированный (в том числе с солью — дополнительной строкой в хешировании).

Важно: если вы прислали не хешированный файл, Авито Реклама автоматически захеширует данные по стандарту SHA-256 (это занимает не более 1 дня) для безопасной работы. Исходные данные не хранятся в открытом виде.

У меня не хешированный файл

Загрузите файл в формате CSV до 1 ГБ и 1 000 строк.

В файле должно быть хотя бы одно из полей: email или phone

phone

Номер телефона — строка, которая содержит номер мобильного, с указанием кода страны. Использовать пробелы и дополнительные символы нельзя:
✅79991112223
❌+7(999)555-11-11


email

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

После того, как вы проверили свой файл:
  1. Нажмите на кнопку «Загрузить».
  2. Прикрепите файл с телефонами или email.







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







У меня хешированные данные

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







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

Тип файла: 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.

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

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

При загрузке поставьте галочку в нужном окне и укажите, куда добавляли соль.
Внутри контейнера отступы:
  1. справа 24рх
  2. слева 24рх
  3. сверху 24рх
  4. снизу 28 рх

изображение всегда в центре серой области

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Это полезная статья?