エンティティ読み取りファイルへのアクセス

エンティティ読み込みファイルは、パートナーのキャンペーン オブジェクトの JSON 表現です。エンティティ読み込みファイルは読み取り専用であるため、Google ディスプレイ &ビデオ 360 への変更の書き戻しには使用できません。エンティティ読み込みファイルの使用について詳しくは、アカウント マネージャーにお問い合わせください。アカウント マネージャーがお客様のニーズについて詳しくご説明します。

エンティティ読み込みファイルは処理日から 60 日間しか利用できないことに注意してください。

エンティティ読み取りファイルの形式は、ファイル形式のリファレンスで確認できます。

エンティティ読み取りファイルは、次の 2 つのグループとして保存されます。

  • 一般公開テーブル。gdbm-public バケットに格納されているブラウザのバージョンや言語に関する情報など、一般的な一般公開データが含まれています。
  • パートナーのキャンペーン、予算、その他の非公開データに関する情報を含む非公開テーブル。非公開テーブルはパートナー固有のバケットに保存されます。たとえば、パートナー ID が 123 の場合、非公開テーブルを含むバケットは gdbm-123 になります。
一般公開テーブルと限定公開テーブルはどちらも、バケット内の entity サブディレクトリにあります。 サブディレクトリの処理の詳細については、Cloud Storage オブジェクトの名前空間をご覧ください。
一般公開テーブルは午前 5 時(UTC)に生成されます。非公開テーブルは、パートナーのタイムゾーンの午前 5 時に生成され(まれに遅れが生じることがあります)、Google Cloud Storage に自動的かつ安全に保存されます。概要ファイルは、公開テーブルと非公開テーブルがすべて生成された後に生成されます。

一般公開テーブル

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
項目説明
processing_dateディスプレイ &ビデオ 360 でデータが処理された日付。ファイルに含まれるイベントとは必ずしも関係ありません。日付の形式は YYYYMMDD です。たとえば、20120320 は 2012 年 3 月 20 日となります。
batch_index バッチのゼロベースのインデックス。たとえば、1 時間ごとに生成される場合、最初のバッチは 0、2 番目のバッチは 1 になります。
entity_typeファイルの種類: SupportedExchangeDataPartnerUniversalSiteGeoLocationLanguageOperatingSystemBrowserIspsummarySiteIdToPlacementId.csv
たとえば、2013 年 1 月 15 日から browser テーブルのエンティティ読み取りファイルを取得するためにファイル名を生成した場合、ファイルのパスは
gdbm-public/entity/20130115.0.Browser.json
のようになります。

プライベート テーブル

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
項目説明
partner_idパートナーの数値 ID。
processing_dateディスプレイ &ビデオ 360 でデータが処理された日付。この日付は、ファイルに含まれるイベントと必ずしも関連しているとは限りません。日付の形式は YYYYMMDD です。たとえば、20120320 は 2012 年 3 月 20 日となります。ファイルはパートナーのタイムゾーンの午前 4 時から午前 6 時の間に生成されます。
batch_indexバッチのゼロベースのインデックス。現在、これは常に 0 です。
entity_typeファイルの種類: PartnerAdvertiserInsertionOrderLineItemCreativePixelInventorySourceUserListUniversalChannelsummary
たとえば、2013 年 4 月 2 日から line_item テーブルにアクセスするパートナー 123 のエンティティ読み取りファイルを取得するためにファイル名を生成した場合、ファイル名は次のようになります。
gdbm-123/entity/20130402.0.LineItem.json