Справка

Списки пользователей — это специальные файлы со списками контактов ваших клиентов, которые можно использовать для таргетирования рекламы. Для создания списков можно использовать, например, электронные адреса и номера телефонов, которые клиенты оставляли при совершении покупок, а также идентификаторы пользователей, которые вы собирали в процессе работы с ними.

В файле могут быть данные одного типа (например, только телефоны, только ID ВКонтакте и т. п.) или сразу нескольких типов — для таких файлов используется «Единый список».

Единый список позволяет загружать идентификаторы разных типов в одном файле: например, и телефоны, и почту, и ID соцсетей. Такие файлы удобно использовать, если у вас есть более одного идентификатора клиента или дополнительная информация, которая также может помочь в идентификации пользователя.

Какие данные можно использовать

  • ID ВКонтакте — в формате числа без префиксов: 138232696. Символьные алиасы к загрузке не допускаются
  • Email — в формате: example@mail.ru
  • ID Одноклассники — в формате числа без префиксов: 138232696 Символьные алиасы к загрузке не допускаются
  • Телефонные номера — в формате [код страны][код региона][номер] без пробелов и прочих знаков: 79011234567
  • Google advertising ID — в формате: 38400000-8cf0-11bd-b23e-10b96e40000d
  • IDFA устройства — в формате: 317F5B7E-E95F-4831-9F60-EC371146CAD3
  • Платформы управления данными (DMP) — идентификаторы, указанные в качестве пользователя в счетчике

Телефонные номера и email можно загружать и в уже зашифрованном виде, и в открытом: при загрузке VK Реклама зашифрует данные автоматически и будет хранить в зашифрованном виде. Например:

  • example@mail.ru → af0f2257cdaaaf1236dd3ce027ec7cfe
  • 79011234567 → d9802251af2e53a7d2e1b1af3792940a
  • 0123456789AB → 1eda070069dde1844b46582fd0606cfe

Доступно шифрование через хеш-функцию MD5. Шифрование через SHA-256 не поддержано.

Как создать список

  1. Откройте раздел «Аудитории» → вкладка «Списки пользователей».
  2. Нажмите «Загрузить список». 
  3. Укажите название, выберите тип списка и загрузите файл. 

    Файл должен соответствовать требованиям, все идентификаторы в списке должны быть одинаковые: например, только телефоны или только ID в «Одноклассниках».
    Исключение — единый список.
  4. Нажмите «Сохранить».

Чтобы показывать рекламу пользователям из списка:

  1. Загрузите файл со списком пользователей.
  2. Создайте аудиторию и добавьте в неё загруженный список.
  3. Во время создания кампании выберите эту аудиторию в блоке «Пользовательские аудитории».

Общие требования к файлам

  • Формат файла: txt или csv.
  • Размер списка: не менее 100 уникальных записей.
  • Одна запись в строке.
  • Разделитель: перевод строки.
  • Кодировка: UTF-8.
  • Вес файла: до 128 Мб.

Дополнительные требования для csv-файлов: Для csv-файлов в заголовке 1 столбца должно быть указано "id". Например: 

id
79000011223
79000045678
79000123456

Пример оформления файла списка пользователей (номера телефонов)

Если вы загружаете список, составленный на основе счетчика или dmp, то строка id должна идти после префикса dmp или id счетчика. Например: 

2930776 
id 
1
2
3

Требования к файлам Единого списка

  • Формат файла: csv.
  • Размер списка: не менее 100 уникальных записей.
  • Одна запись в строке.
  • Разделитель: перевод строки.
  • Кодировка: UTF-8.
  • Вес файла: до 128 Мб.

В первой строке файла необходимо указать заголовки колонок, которые соответствуют идентификаторам:

  • телефонные номера — phone;
  • электронная почта — email;
  • идентификаторы в «Одноклассниках» — ok;
  • идентификаторы «ВКонтакте» — vk;
  • VID (файл cookie) — vid;
  • GAID (идентификатор Google) — gaid;
  • IDFA (идентификатор Apple) — idfa.

Идентификаторы в разных строках должны следовать в одинаковом порядке. Если необходимо пропустить колонку, поставьте запятую, не вставляя никаких символов (например: +79999999999,example@mail.ru,,38400000-8cf0-11bd-b23e-10b96e40000d)

phone,email,ok,vk,vid,gaid,idfa
,example2@mail.ru,38437281250,423103,89981188876,9647dbd1-a7b0-425d-a436-617c573629de,73bd9d1c-f158-11ec-8ea0-0242ac120002
79417881591,example3@mail.ru,33844571821,170486,,3865d459-c76d-4c4b-b8b8-306cda5edb5c,
79992984703,example4@mail.ru,2214937214,96541,31290449279,,90e035d0-f158-11ec-8ea0-0242ac120002
,,,,17559274122,0a1225c5-cad7-4c5e-882e-2e1b32dcdcb7,
79797137258,example6@mail.ru,62115396854,,,5bb8b116-21a3-4573-818b-7d7963cc2a8b,

Пример оформления файла с единым списком

В одной строке должна содержаться информация только об одном пользователе. Не смешивайте идентификаторы разных пользователей в одной строке.

Как отредактировать список

Чтобы добавить новые строки в список, в разделе «Аудитории» на вкладке «Списки пользователей» нажмите «Загрузить список». Перейдите на вкладку «Добавить в существующий», выберите нужный список и загрузите файл с новыми строками.

Для удаления строк из списка перейдите на вкладку «Исключить из существующего», выберите нужный список и загрузите файл со строками, которые нужно удалить.