構造化データファイルと API の両方と統合する

構造化データファイル(SDF)ディスプレイ&ビデオ 360 API はどちらも、ディスプレイ&ビデオ 360 リソース構成の一括管理をサポートしています。各ツールには固有の制限があります。このガイドでは、両方のツールを使用して既存の実装を最適化する方法について説明します。

すでに構造化データファイルを使用している場合

Display & Video 360 API を使用すると、ファイルと関連メタデータをプログラマティックに取得して SDF の統合をサポートできます。

API を使用してファイルを生成してダウンロードする

デフォルトでは、ディスプレイ&ビデオ 360 の管理画面を使用して構造化データファイルを手動でダウンロードします。通常、これらのダウンロードは 1 つの広告主様に限定され、特定のリソースページから開始する必要があります。インターフェースから大量の SDF データをダウンロードするのは複雑で時間がかかります。

Display & Video 360 API を使用して構造化データファイルをプログラムで生成してダウンロードすることで、このプロセスを効率化できます。この機能を実装する手順については、こちらのガイドをご覧ください。

API を使用して参照 ID を検索する

構造化データファイルには、ディスプレイ&ビデオ 360 リソースの設定が反映されます。ほとんどの SDF 列では、数値 ID を使用して他のリソースやターゲティング構成を識別します。SDF データを読み取ったり変更したりするときに、これらの ID を理解するための参照が必要になることがよくあります。

Display & Video 360 API を使用して、参照情報を一括取得します。ほとんどの SDF 列で使用可能な ID は、関連するリソースの GET 関数または LIST 関数を使用して取得できます。

参照情報をプログラムで取得してキャッシュに保存し、構造化データファイルの解析と変更時にそのキャッシュに保存された情報を使用します。キャッシュを定期的に更新し、必要に応じて SDF を解析するときに不明な ID をリアルタイムで検索して、新しいリソースに関する情報を取得できます。

使用可能な API サービスとメソッドの一覧については、API リファレンス ドキュメントをご覧ください。

既存の例外

構造化データファイルで使用される参照 ID の一部は、ディスプレイ&ビデオ 360 API を使用して取得できません。

  • アフィニティ カテゴリと購買意向の強いユーザーのターゲティング: これらの列で使用されるオーディエンス ID をディスプレイ&ビデオ 360 の管理画面から取得します。
  • コンバージョンの Floodlight アクティビティ ID: これらの列で使用されている Floodlight アクティビティ ID を、ディスプレイ&ビデオ 360 の管理画面から取得します。
  • 広告枠ソース ターゲティング: これらの列で使用されているエクスチェンジ ID を、公開されている SDF エクスチェンジ リファレンスから取得します。ディスプレイ&ビデオ 360 API を使用して、これらの列で使用される広告枠ソース ID とサブエクスチェンジ ID を取得します。
  • アプリ ターゲティング: これらの列で使用されるアプリ ID を、関連するアプリ プラットフォームから取得します。

Display & Video 360 API をすでに使用している場合

SDF を使用して、YouTube とパートナーのリソースを一括作成および更新し、ディスプレイ&ビデオ 360 API との統合をサポートします。

SDF アップロードを使用して YouTube とパートナーのリソースを更新する

ディスプレイ&ビデオ 360 API を使用して、YouTube とパートナーのリソース(特定のタイプの広告申込情報、広告グループ、広告など)を作成または更新することはできません。これらのリソースの設定と割り当てられたターゲティングは取得できますが、更新はディスプレイ&ビデオ 360 の管理画面で行う必要があります。これにより、一括アクションが制限され、これらのリソースを更新できるレートが制限されます。

構造化データファイルのアップロードを使用して、ディスプレイ&ビデオ 360 の管理画面で YouTube とパートナーのリソースを一括で作成または更新します。構造化データファイルは手動でアップロードする必要がありますが、プロセスの大部分(ファイルの取得と変更)はプログラムで完了できます。

詳しくは、SDF のダウンロードに関する API ガイドSDF のアップロードに関するドキュメントをご覧ください。