Google では、集約されたパブリッシャーの設定リストをアカウント固有の Google Cloud Storage バケット(Google が所有するプロジェクトの下)にアップロードすることで利用できるようにしています。これらをダウンロードして、入札時に実行できないターゲティングに使用できます。アカウントでこの機能を有効にする場合は、テクニカル アカウント マネージャーにお問い合わせください。
パブリッシャーの設定を含むファイルは、Cloud Storage API を使用してプログラムでダウンロードするか、Google Developer Console の UI から手動でダウンロードするか、gsutil コマンドライン ツールを使用してダウンロードできます。Google Cloud Storage に保存されているデータへのアクセスについて詳しくは、Google Cloud Storage のドキュメントをご覧ください。
ファイルは RFC 1952 に従って gzip 圧縮されます。コマンドラインからファイルを抽出するには、gzip -d <filename>
を実行します。プログラムでファイルを抽出するには、zlib や、gzip 形式をサポートする同様の圧縮ライブラリを使用できます。その結果は、BidRequest
内の POST リクエストのペイロードと同様のシリアル化されたプロトコル バッファになります。これは、次のスニペットで解析できます。
string compressed = /* the payload from the GET request */; string uncompressed = gunzip(compressed); PublisherSettingsList publisher_settings; if (publisher_settings.ParseFromString(uncompressed)) { // Process the publisher settings. }
PublisherSettingsList
のプロトコル バッファ定義は、参照データページからダウンロードできます。アカウント担当者から圧縮された publisher-settings.pb.gz
ファイルをリクエストすることもできます。これには、プロトコル バッファの定義とパブリッシャーの構成ファイルの例が含まれています。
PublisherSettingsList
の順序はいつでも変更できます。特定の順序や並べ替えは保証されません。パブリッシャー設定リストの各エントリには、識別子と、その識別子でタグ付けされた BidRequests
に適用されるいくつかの設定が含まれています。入札システムに機能を追加して、新しいパブリッシャー設定リストを定期的にチェックできます。Google は、リアルタイム ビッダー対応のインプレッションを受け取ると、パブリッシャーの設定リストのエントリに対応する識別子を入札リクエストに含めます。入札システムでは、パブリッシャーの設定を使用して、インプレッションに対する広告候補をフィルタできます。候補の広告が配信候補となるには、リクエストで識別子が送信されたすべてのパブリッシャー設定に準拠している必要があります。
ファイルに記載されているパブリッシャーの設定がないのは、識別子がブロックされている URL が関連付けられていないためです。
パブリッシャーの設定ファイルは複数の小さなファイルに分割され、1 回のトランザクションでダウンロードする必要のあるデータ量が削減されます。ファイルは約 5 MB のチャンクと名前に分割され、それぞれ publisher-settings.0.pb.gz
~publisher-settings.n.pb.gz
(n はファイル数から 1 を引いた数)になります。これらのファイルを取得するには、アカウント担当者にお問い合わせください。