Массовая загрузка идентификаторов в сегменты аудитории

Вы можете создать файл с идентификаторами и загрузить его в Google Менеджер рекламы с помощью Google Cloud. В файле допустимы следующие идентификаторы: файлы cookie, мобильные рекламные идентификаторы (AdID и IDFA) и PPID. Если нужно добавить много идентификаторов, массовая загрузка через Google Cloud поможет вам сэкономить время.

Темы этой статьи:

• Требования
• Создание файла для загрузки
• Массовое удаление идентификаторов
• Загрузка файла
• Срок действия загруженных идентификаторов
• Рекомендации по массовой загрузке

Требования

Перед загрузкой идентификаторов выполните следующие действия вместе с техническим менеджером аккаунта:

• Найдите и передайте свой код сети. Чтобы найти код сети в Менеджере рекламы, выберите Администрирование > Глобальные настройки > Код сети.
• Убедитесь, что вы создали собственный сегмент аудитории, с которым нужно связать идентификаторы. Если вы не хотите, чтобы сегмент собирал информацию, используя ваш собственный инвентарь, в качестве метода заполнения выберите "Управляется издателем".
  Примечание. Для выполнения массовой загрузки придется подождать до 24 часов после создания сегмента.
  Внимание! В названиях файлов при массовой загрузке могут быть только символы ASCII. Результаты по файлам, в названиях которых есть тройной символ подчеркивания (___), в отчетах будут представлены некорректно.

  Дополнительные сведения об ограничениях для названий файлов можно найти в рекомендациях по именованию объектов Cloud Storage.
• Создайте группу Google, содержащую все аккаунты Google, которые смогут загружать и просматривать файлы.

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

Создание файла для загрузки

Обязательный тег согласия

Все издатели должны изменить настройки так, чтобы была возможна передача данных о согласии пользователей в Менеджер рекламы.

Чтобы подтвердить наличие согласия, добавьте в заголовок каждого загруженного файла тег process_consent. Для соблюдения стандартов формата CSV необходимо, чтобы в строках были значения для столбца заголовка, но это не повлияет на обработку. Мы рекомендуем использовать пустую строку. Если у какого-либо файла не будет такого тега, система будет считать, что для файла не предоставлено согласие, и не сможет обработать его.

Для кого обязательно это обновление

• Для всех пользователей из любых стран (таково техническое требование).
• Для пользователей из ЕС/ЕЭЗ (это необходимо, чтобы соблюдать правила в отношении согласия пользователей из ЕС и по-прежнему создавать сегменты аудитории для пользователей из Европейской экономической зоны).

Идентификаторы

При массовой загрузке поддерживаются несколько типов идентификаторов. Поэтому при загрузке идентификаторов в сегменты нужно использовать файлы совместимых форматов. Идентификаторы делятся на две категории:

• Зашифрованные – любые идентификаторы, полученные из систем Google.
• Незашифрованные – идентификаторы из внешних систем и источников.

Зашифрованные идентификаторы загружаются в формате файла cookie_encrypted, а незашифрованные – в собственных форматах.

Зашифрованные идентификаторы и идентификаторы PPID используются только в собственной сети. Поэтому их нельзя загружать в другие сети при помощи инструмента массовой загрузки. Например, идентификаторы пользователей из отчета по передаче данных в сети А нельзя массово загрузить в сеть Б. На идентификаторы устройств это ограничение не распространяется.

В таблице ниже перечислены типы идентификаторов и форматы файлов загрузки.

С помощью текстового редактора создайте обычный текстовый файл и присвойте ему название. Расширение имени файла может быть любым или вообще отсутствовать.

Требования к содержимому файла

• Убедитесь, что содержимое файла разделено запятыми.
• Первая строка должна выглядеть так:
  • В зашифрованных файлах cookie и идентификаторах, полученных из отчетов по передаче данных (только в Google Менеджере рекламы 360): cookie_encrypted,list_id,process_consent
  • В незашифрованных идентификаторах Apple IDFA: cookie_idfa,list_id,process_consent
  • В незашифрованных идентификаторах Android AdID: cookie_adid,list_id,process_consent
  • В незашифрованных идентификаторах PPID: ppid,list_id,process_consent
  • В незашифрованных идентификаторах Roku ID: cookie_rida,list_id,process_consent
  • В незашифрованных идентификаторах tvOS ID: cookie_tvos,list_id,process_consent
• Каждая последующая строка должна содержать идентификатор, запятую и идентификатор сегмента аудитории.
• Каждая строка должна заканчиваться символом перевода строки Unix (LF), а НЕ возврата каретки (CR). Этот символ зависит от текстового редактора или программы, где был создан загружаемый файл.
• Издатели могут получить зашифрованные идентификаторы в отчетах по передаче данных (только для Google Менеджера рекламы 360). Чтобы получить идентификатор сегмента аудитории, войдите в Google Менеджер рекламы и выберите Инвентарь > Аудитория.
• Столбец process_consent должен находиться на последнем месте в файле для загрузки.
• Ячейки в столбце process_consent заполнять не обязательно, но важно включить в качестве заголовка столбец, в котором значение process_consent указано.
• Размер файлов массовой загрузки не должен превышать 1 ГБ, иначе их не удастся обработать.

Пример файла с зашифрованными идентификаторами cookie:

cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,

Пример файла с AdID:

cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,

Массовое удаление идентификаторов

Файл загрузки можно использовать и для массового удаления идентификаторов. Для этого добавьте в файл столбец delete и в нем напротив идентификатора, который нужно удалить из сегмента, укажите 1, а напротив идентификатора, который нужно оставить, – 0.

В приведенном ниже примере первый файл cookie должен сохраниться в сегменте с идентификатором 3153490, а второй должен быть удален.

cookie_encrypted,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,0,
w2gsrUcwxF-OiJTRmQswQA,3153490,1,

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

cookie_idfa,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,1,
w2gsrUcwxF-OiJTRmQswQA,3153490,0,

Каждая строка должна содержать столько разделенных запятыми полей, сколько их указано в заголовке. Обратите внимание, что идентификаторы не содержат запятые или другие символы, не совместимые с форматом CSV.

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

Загрузка файла

Созданный файл необходимо загрузить в один из сегментов Google Storage (можно использовать вложенные папки). Есть три варианта доступа к сегментам облачного хранилища Менеджера рекламы. Они перечислены ниже в порядке возрастания сложности.

• С помощью веб-интерфейса. Перейдите на страницу https://console.developers.google.com/storage/gdfp_cookieupload_[код сети в Менеджере рекламы]/
• С помощью инструмента gsutil. Это инструмент командной строки, написанный на языке Python. Он позволяет управлять данными в хранилище с помощью команд, аналогичных используемым в Unix. Аутентификация сегмента выполняется абстрактным методом и обрабатывается автоматически.
• API Google Cloud Storage. Полнофункциональный API для работы с данными хранилища, доступный через веб-интерфейсы JSON и XML RESTful. Существует множество клиентских библиотек API, написанных на популярных языках программирования, в том числе Java, JavaScript, Python и Objective-C. Этот способ удобен, если вам нужно программно интегрировать сегменты хранилища с приложением Google App Engine или веб-приложением Java.

В течение суток в вашем аккаунте Google Storage будет создан файл журнала. Его название будет таким же, как у загруженного файла, но к нему будет добавлено слово success, если все идентификаторы обработаны успешно, или fail, если возникли проблемы.

Например, журнал для файла 1234_20130115_1 будет называться 1234_20130115_1.success или 1234_20130115_1.fail. В нем будут указаны подробные сообщения об ошибках и количество успешно обработанных идентификаторов. Файл журнала можно скачать на компьютер.

Файл появится в следующей папке вашего аккаунта Google Storage:

https://console.developers.google.com/storage/gdfp_cookieupload_result_[код сети в Менеджере рекламы]/

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

Имена файлов с суффиксами .fail или .success указывают, был ли файл .dat обработан успешно, и не относятся к информации об изменении размера списка. Суффикс .success добавляется, только если удалось загрузить все идентификаторы. Однако при загрузке часто случается хотя бы одна ошибка, и к имени файла практически всегда добавляется суффикс .fail.

Срок действия загруженных идентификаторов

Срок действия идентификаторов, добавленных с помощью инструмента массовой загрузки, определяется настройками сегментов аудитории в интерфейсе Менеджера рекламы.

Если для сегмента аудитории установлен срок действия X дней и в течение X дней с момента загрузки идентификатор не удовлетворяет критериям включения в этот сегмент, то по истечении срока идентификатор будет исключен из этого сегмента аудитории. После каждой загрузки идентификаторов их сроки включения в сегмент обнуляются.

Рекомендации по массовой загрузке

Файловая структура

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

Ограничения по загрузке

При загрузке файлов соблюдайте следующие ограничения:

• Не загружайте более 500 файлов в сутки.
• Не используйте файлы, размер которых превышает 1 ГБ.
• Не загружайте более 5 ГБ в сутки.

Частичная и полная загрузка

• Чтобы сократить время обработки, используйте инкрементную загрузку (дельта-загрузку) идентификаторов: добавляйте или удаляйте только те из них, которые были добавлены или удалены после последней загрузки. Не загружайте повторно весь список идентификаторов сегментов.
• Изредка, не чаще одного раза в неделю, можно загружать идентификаторы сегментов полностью (соблюдая ограничения, описанные выше). После полной загрузки обнуляются сроки включения в сегмент для идентификаторов, исключенных из-за превышения этих сроков.
  • Для отслеживания сроков включения в сегмент используйте другие системы. Из полной загрузки следует исключать идентификаторы, которые не будут использоваться в дальнейшем.

Время обработки

Изменения должны вступить в силу в течение 24 часов после массовой загрузки. Поэтому загружайте файлы заблаговременно.

Возможно, придется подождать до 48 часов после массовой загрузки, пока изменения не отобразятся в пользовательском интерфейсе Менеджера рекламы.