Списки пользователей в VK Рекламе: форматы файлов, типы данных, хеширование
Список пользователей — файл txt или csv с контактами клиентов: не менее 100 уникальных записей, до 128 МБ, UTF-8, одна запись в строке. Принимают телефоны, email, ID ВКонтакте и Одноклассников, GAID, IDFA, DMP; телефоны и email можно грузить открытыми или хешем MD5, SHA-256 — только для телефонов. Разные типы в одном файле возможны только в «едином списке» (csv с заголовками phone, email, ok, vk, vid, gaid, idfa).
Цифры
Требования к файлу
| Параметр | Общий список | Единый список |
|---|---|---|
| Формат | txt или csv | только csv |
| Уникальных записей | не менее 100 | не менее 100 |
| Вес | до 128 МБ | до 128 МБ |
| Кодировка | UTF-8 | UTF-8 |
| Записей в строке | одна | одна |
| Разделитель | перевод строки | перевод строки |
| Типы идентификаторов в файле | один тип | разные типы |
| Заголовок | для csv: первый столбец «id» | первая строка с названиями колонок |
Какие данные и в каком формате
| Данные | Формат | Пример |
|---|---|---|
| ID ВКонтакте | число без префиксов; символьные алиасы не допускаются | 138232696 |
| обычный адрес | example@mail.ru | |
| ID Одноклассников | число без префиксов; символьные алиасы не допускаются | 138232696 |
| Телефон | код страны, код региона, номер, без пробелов и других знаков | 79011234567 |
| Google advertising ID | UUID | 38400000-8cf0-11bd-b23e-10b96e40000d |
| IDFA устройства | UUID | 317F5B7E-E95F-4831-9F60-EC371146CAD3 |
| Платформы управления данными (DMP) | идентификаторы, указанные как пользователь в счётчике | примера нет |
Хеширование
| Данные | Открытый вид | MD5 | SHA-256 |
|---|---|---|---|
| Телефоны | да | да | да, без соли |
| да (рекомендуется) | да, но не рекомендуют | нет |
Заголовки колонок единого списка
| Колонка | Что внутри |
|---|---|
| phone | телефонные номера |
| электронная почта | |
| ok | идентификаторы в Одноклассниках |
| vk | идентификаторы ВКонтакте |
| vid | VID (файл cookie) |
| gaid | идентификатор Google |
| idfa | идентификатор Apple |
Лимиты и сроки
| Параметр | Значение |
|---|---|
| Минимум уникальных записей | 100 |
| Вес файла | до 128 МБ |
| Срок хранения и обновления списка | в справке не нашли |
| Максимум списков в кабинете | в справке не нашли |
Подробности
Два вида загрузки
- Общий файл: данные одного типа, например только телефоны или только ID ВКонтакте.
- Единый список: идентификаторы разных типов в одном файле, удобно, если у клиента несколько идентификаторов или есть дополнительные данные для опознания.
Как создать список
- Открыть «Аудитории», вкладка «Списки пользователей».
- Нажать «Загрузить список».
- Указать название, выбрать тип списка, загрузить файл. Все идентификаторы в файле одного типа (только телефоны или только ID в Одноклассниках); исключение — единый список.
- Нажать «Сохранить».
После обработки показываются два числа: «Найдено» — сколько идентификаторов обнаружено в системе VK Рекламы, «В списке» — сколько загружено.
Как показать рекламу по списку
- Загрузить файл со списком пользователей.
- Создать аудиторию и добавить в неё загруженный список.
- При создании кампании выбрать аудиторию в блоке «Пользовательские аудитории».
Оформление csv
Для общего списка в csv первая строка — заголовок «id», дальше по одному значению в строке.
Если список собран по счётчику или DMP, строка «id» идёт после префикса: сначала строка с dmp или ID счётчика, потом «id», затем значения.
Единый список: в первой строке заголовки колонок, порядок идентификаторов во всех строках одинаковый. Колонку, которой нет у пользователя, пропускают запятой без символов. В одной строке данные только одного пользователя: идентификаторы разных людей не смешивать.
Хеширование
Телефоны и email можно загружать как открытыми, так и в виде хеша: при загрузке VK Реклама сама зашифрует данные и хранит их в зашифрованном виде. Поддержан MD5, SHA-256 — только для телефонов и без соли. Для максимального качества сопоставления рекомендуют загружать email в открытом виде; если данные нужно передавать зашифрованными, лучше использовать телефоны.
Как изменить список
- Добавить строки: «Аудитории», вкладка «Списки пользователей», «Загрузить список», вкладка «Добавить в существующий», выбрать список и загрузить файл с новыми строками.
- Удалить строки: вкладка «Исключить из существующего», выбрать список и загрузить файл со строками, которые нужно убрать.
Важно знать
- Формат телефона: в общих требованиях номер без пробелов и других знаков (79011234567), а в примере единого списка встречается номер со знаком «+» (+79999999999). Как принимает кабинет, проверить пробной загрузкой; безопасно — без «+».
- Набор идентификаторов отличается: в общем списке перечислены ID ВКонтакте и Одноклассников, email, телефон, GAID, IDFA и DMP, а в заголовках единого списка DMP нет, зато есть vid (cookie).
- Для MD5-хеша email справка прямо не рекомендует: сопоставление хуже, чем у открытого адреса.
- В справке не нашли: срок хранения и частоту обновления списка, максимум списков в кабинете, ожидаемую долю совпадений.