Доступ к файлам чтения объектов

Файлы чтения сущностей представляют собой JSON-представления объектов кампании партнера. Файлы чтения Entity Read доступны только для чтения и не могут использоваться для обратной записи изменений в Google Display & Video 360. Чтобы узнать больше об использовании файлов чтения Entity Read, обратитесь к менеджеру своего аккаунта, который сможет более подробно обсудить ваши потребности.

Обратите внимание, что файлы чтения объектов доступны только в течение 60 дней с даты их обработки.

Формат файлов чтения сущностей можно посмотреть в справочнике по форматам файлов .

Файлы чтения объектов хранятся в виде двух групп:

  • Общедоступные таблицы, содержащие общие общедоступные данные, такие как информация о версиях браузера или языках, которые хранятся в сегменте gdbm-public .
  • Приватные таблицы, содержащие информацию о кампаниях партнера, бюджетах и ​​другие приватные данные. Частные таблицы хранятся в сегментах, специфичных для партнеров; например, если идентификатор вашего партнера – 123, сегмент, содержащий ваши частные таблицы, будет иметь вид gdbm-123 .
Как общедоступные, так и частные таблицы находятся в подкаталоге entity внутри сегмента. Дополнительные сведения об обработке подкаталогов см. в разделе Пространство имен объектов Cloud Storage .
Публичные таблицы создаются в 5 утра по всемирному координированному времени. Приватные таблицы создаются в 5 утра по часовому поясу вашего партнера (хотя в редких случаях могут быть задержки) и автоматически и безопасно сохраняются в Google Cloud Storage . Файл сводки создается после создания всех общедоступных и частных таблиц.

Общественные столы

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
Поле Описание
processing_date Дата, когда Дисплей и Видео 360 обработал данные и не обязательно связана с событиями, содержащимися в файле. Формат даты — YYYYMMDD , например 20120320 будет 20 марта 2012 года.
batch_index Индекс пакета, отсчитываемый от нуля. Например, если генерируется ежечасно, первый пакет будет иметь 0 , второй пакет — 1 и т. д.
entity_type Тип файла: SupportedExchange , DataPartner , UniversalSite , GeoLocation , Language , OperatingSystem , Browser , Isp , summary и SiteIdToPlacementId.csv .
Например, если вы создавали имя файла для получения файла чтения объекта для таблицы browser от 15 января 2013 г., путь к файлу будет выглядеть так:
gdbm-public/entity/20130115.0.Browser.json

Частные столы

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
Поле Описание
partner_id Числовой идентификатор вашего Партнера.
processing_date Дата, когда Дисплей и Видео 360 обработал данные. Эта дата не обязательно связана с событиями, содержащимися в файле. Формат даты — YYYYMMDD , например 20120320 будет 20 марта 2012 года. Файлы будут созданы между 4:00 и 6:00 по часовому поясу партнера.
batch_index Индекс пакета, отсчитываемый от нуля. В настоящее время это всегда 0.
entity_type Тип файла: Partner , Advertiser , InsertionOrder , LineItem , Creative , Pixel , InventorySource , UserList , UniversalChannel и summary .
Например, если вы создавали имя файла для получения файла чтения объекта для партнера 123, обращающегося к таблице line_item со 2 апреля 2013 г., ваше имя файла будет выглядеть примерно так:
gdbm-123/entity/20130402.0.LineItem.json