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

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

エンティティ読み取りファイルは、処理日から 60 日間のみ使用できます。

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

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

  • 公開テーブル: gdbm-public バケットに保存されているブラウザのバージョンや言語に関する一般公開データなど、一般公開データが含まれます。
  • 非公開テーブル: パートナーのキャンペーン、予算、その他の非公開データに関する情報が含まれます。非公開テーブルはパートナー固有のバケットに保存されます。たとえば、パートナー ID が 123 の場合、非公開テーブルを含むバケットは gdbm-123 になります。
パブリック テーブルとプライベート テーブルの両方が、バケット内の entity サブディレクトリにあります。サブディレクトリの処理の詳細については、Cloud Storage オブジェクトの名前空間をご覧ください。
公開テーブルは UTC 午前 5 時に生成されます。限定公開テーブルはパートナーのタイムゾーンの午前 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