Отчеты по передаче данных в Менеджере рекламы

Получайте данные на уровне событий, относящиеся к вашей сети Менеджера рекламы

В файлах отчетов по передаче данных представлены неагрегированные данные кампаний на уровне события. Такая информация представляет собой необработанный контент из журналов серверов объявлений Google Платформы для маркетинга. Для каждого типа событий создается отдельный файл со сведениями с точностью до секунды. Вы также можете включить в эти файлы и другие данные, имеющие отношение к событию, например информацию об устройстве, местоположении и т. д.

Доступно только в Google Менеджере рекламы 360.

Начало работы

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

Для работы с функцией передачей данных требуются особые технические навыки
Если ваша организация не может выполнять извлечение, преобразование и загрузку данных (ETL), работать с большими файлами и текстовыми документами, проектировать и администрировать базы данных среднего размера, а также создавать и внедрять скрипты, обратитесь к одному из одобренных партнеров Google Платформы для маркетинга.

Доступные файлы отчетов по передаче данных

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

Если есть соответствующий файл Backfill, то файл Network не будет содержать данные о показах, выполненных с помощью динамического размещения в Ad Exchange или AdSense. Статистика таких показов будет представлена в файле Backfill.

В Менеджере рекламы теперь подсчитываются скачанные показы.
С 2 октября 2017 г. в файлы со статистикой по объявлениям включаются только скачанные показы. Новые файлы доступны для запросов и передач кода. Подробнее о новом порядке подсчета показов
Тип файла Содержание Образец    
NetworkRequests
NetworkBackfillRequests
Все запросы объявлений, полученные Менеджером рекламы, независимо от того, была ли по ним показана реклама. Download
NetworkCodeServes
NetworkBackfillCodeServes
Все ответы от Менеджера рекламы вне зависимости от того, были ли они скачаны. Download

NetworkImpressions
NetworkBackfillImpressions

Данные по скачанным показам. Download
NetworkClicks
NetworkBackfillClicks
Данные по кликам.  
NetworkActiveViews
NetworkBackfillActiveViews
Данные по показам Менеджера рекламы, доступным для Active View.  
NetworkBackfillBids Данные по назначению ставок на аукционах. Подробнее…  
NetworkVideoConversions
NetworkBackfillVideoConversions
Данные по событиям видео, в том числе действия (воспроизведение, приостановка и т. д.), идентификаторы Content ID, позиция в пакете и многое другое. Ознакомиться с перечнем всех событий в видеообъявлениях  
NetworkRichMediaConversions
NetworkBackfillRichMediaConversions
Данные по событиям Креативной студии, в том числе стандартные и специальные действия (воспроизведение, приостановка и т. д.), продолжительность действия и многое другое.  
NetworkActivities Если взаимодействие пользователя с кампанией на сайте издателя приводит к активации пикселя отслеживания (устаревшее название – "пиксель Spotlight") на сайте рекламодателя, то такое взаимодействие регистрируется в отдельной записи журнала.  

Как отправляются файлы

Файлы передачи данных отправляются в сегменты хранилища каждый час. Рекомендуется проверять обновления с определенной периодичностью. Значительная часть отправленных данных будет доступна через 5–15 ч., однако при задержке событий эта процедура может занять до 14 дней. Google Платформа для маркетинга не предоставляет сторонним серверам информацию о передаче данных.

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

Имена файлов

В именах файлов передачи данных используется следующий формат: [Тип]_[Идентификатор сети]_[YYYYMMDD]_[HH].gz

  • YYYYMMDD – это год, месяц и число.
  • HH – час начала в 24-часовом формате.

    Час, указанный в каждом имени файла (01, 02, 03), относится к тихоокеанскому времени, а собранная информация соответствует часовому поясу сети, который определяется по временным меткам в файле передачи данных. Не забывайте об этих различиях.

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

О чем следует помнить при работе с файлами передачи данных

  • Запаздывание данных
    Задержка может составлять несколько часов. На обработку файлов данных иногда уходит больше времени, чем обычно. Если данные получены с опозданием, они включаются в пакетный файл следующего часа, но их метка времени при этом остается неизменной. Например, в файле могут быть записаны преимущественно события, происходившие с 8:00 до 9:00, и несколько событий, зарегистрированных ранее, если их обработка не была выполнена вовремя. Данные нельзя получить заранее, поэтому обратных ситуаций не бывает.
  • Часы, в которые не зафиксировано никаких действий
    Если в определенный час не зафиксировано никаких действий, файл передачи данных не создается. Если для того или иного часа файлы передачи данных отсутствуют, посмотрите в отчетах Менеджера рекламы, были ли зарегистрированы в этот период какие-либо события. При этом учитывайте границы дат и дней, описанные ниже. Если в отчетах Менеджера рекламы не указано событий, имевших место в нужное вам время, обращаться в службу поддержки не нужно.
  • Границы дат и суток
    В файле за первый час обычно указаны события, зарегистрированные между полуночью и 1:00 по тихоокеанскому времени. При этом их временные метки будут соответствовать часовому поясу сети издателя. Так, если в его аккаунте установлено московское время, то в первом почасовом файле он увидит события, произошедшие либо с 10:00 до 11:00 (летом), либо с 11:00 до 12:00 (зимой). События, зарегистрированные до этого времени, будут отражены в файле за предыдущие сутки. Таким образом, даты в метках времени и в именах файлов могут различаться. Всегда руководствуйтесь временными метками событий в файле, а не временем отправки или именем файла.
  • Передача данных по главному и сопутствующим объявлениям
    В файлах передачи данных отражаются показы как главного, так и сопутствующих объявлений. В поле IsCompanion показам сопутствующих объявлений будет соответствовать значение TRUE. Поле CreativeId содержит идентификаторы отдельных главных и сопутствующих объявлений, а не наборов объявлений. Идентификаторы наборов, позволяющие связать главные и сопутствующие объявления, в файлах передачи данных не указываются.
  • Расхождения с данными отчетов Инструмента запросов в Менеджере рекламы
    Файлы, созданные с помощью Инструмента запросов и API, регулярно проверяются на наличие информации о недействительном трафике (спаме), а после ее удаления размещаются заново. Поскольку эта процедура проводится в разное время, в файлах, связанных с API, может быть указано чуть большее количество показов, кликов и т. д. Обычно расхождения не превышают 1%.

    Значение в файлах передачи данных CodeServes может выше, чем показатель "Количество передач кода" в Инструменте запросов. Это связано с тем, что в отчетах по передаче данных передача кода регистрируется для каждого выполненного показа, а в Инструменте запросов – лишь для каждого запроса. Креативы некоторых форматов, например текстовые объявления Google Рекламы, могут предусматривать несколько показов по одному запросу. Чтобы определить подходящие уникальные показы для сравнения, сгруппируйте файлы передачи данных по значениям полей TimeUsec2 и KeyPart.

Работа с файлами отчетов по передаче данных

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

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

Файлы передачи данных представляют собой неформатированный текст, который можно конвертировать с помощью редактора электронных таблиц. Вот несколько примеров типичного применения данных файлов передачи данных:

  • систематизация данных о событиях и действиях, которая основана на различных параметрах (например, настройках объявлений);
  • расчет уникальных конверсий за несколько дней;
  • сопоставление пользователей с базой данных клиентов;
  • отчеты о географическом положении и демографических данных пользователей.

Таблицы соответствия позволяют выполнять поиск идентификаторов по названиям и сопоставлять информацию о показе объявления из файлов передачи данных (например, о рекламном блоке или позиции) с предварительно заданными значениями из базы данных.

Локальное хранение файлов 

Обычно каждое событие занимает от 25 до 35 байтов в сжатом файле. Таким образом, для 10 млн показов в сжатом файле потребуется около 300 МБ дискового пространства. Помните, что это приблизительная цифра. Действительный размер файла может быть несколько больше. Также следует учитывать, что вам понадобится дополнительное пространство для распаковки и использования этих файлов.

Файлы передачи данных, созданные более 60 дней назад, удаляются из Менеджера рекламы. Если вы хотите хранить их более продолжительное время, переместите их на свой компьютер или в облачное хранилище, связанное с другим вашим аккаунтом Google Cloud Storage.

Как упростить обработку файлов передачи данных

Разработчики Google Code выпустили набор инструментов с открытым исходным кодом под названием CRUSH (Custom Reporting Utilities for SHell), который позволяет обрабатывать текстовые файлы с разделителями при помощи командной строки и скриптов shell. Инструменты CRUSH прошли все необходимые этапы разработки и тестирования. Наиболее эффективно они работают в операционных системах Linux и Unix. Поддержка CRUSH осуществляется сообществом разработчиков ПО с открытым исходным кодом.

Также можно использовать приложение DMX, разработанное компанией Syncsort.

Эта информация оказалась полезной?
Как можно улучшить эту статью?