構造化データファイル（SDF）とディスプレイ＆ビデオ 360 API の両方で、ディスプレイ＆ビデオ 360 リソース構成の一括管理がサポートされています。各ツールには固有の制限があります。このガイドでは、両方のツールを使用して既存の実装を最適化する方法について説明します。
構造化データファイルをすでに使用している場合
Display & Video 360 API を使用して、ファイルのプログラマティック取得と関連するメタデータを通じて SDF 統合をサポートします。
API を使用してファイルを生成してダウンロードする
デフォルトでは、ディスプレイ＆ビデオ 360 の管理画面を使用して構造化データファイルを手動でダウンロードします。通常、これらのダウンロードは 1 つの広告主に制限され、特定のリソースページから開始する必要があります。インターフェースから大量の SDF データをダウンロードするのは、複雑で時間がかかることがあります。
Display & Video 360 API を使用して構造化データファイルをプログラムで生成してダウンロードすることで、このプロセスを効率化できます。この機能を実装する手順については、こちらのガイドをご覧ください。
API を使用して参照 ID を検索する
構造化データファイルには、ディスプレイ＆ビデオ 360 リソースの構成が反映されます。ほとんどの SDF 列では、数値 ID を使用して他のリソースやターゲティング構成を識別します。SDF データの読み取りや変更を行う際には、これらの ID を理解するために参照が必要になることがよくあります。
ディスプレイ＆ビデオ 360 API を使用して、参照情報を一括で取得します。ほとんどの SDF 列で使用される利用可能な ID は、関連するリソースの GET 関数または LIST 関数を使用して取得できます。
参照情報をプログラムで取得してキャッシュに保存し、構造化データファイルの解析と変更時にそのキャッシュに保存された情報を使用します。キャッシュを定期的に更新し、必要に応じて SDF の解析時に不明な ID をリアルタイムで検索して、新しいリソースに関する情報を取得できます。
使用可能な API サービスとメソッドの一覧については、API リファレンス ドキュメントをご覧ください。
既存の例外
構造化データファイルで使用される参照 ID の一部は、ディスプレイ＆ビデオ 360 API を使用して取得できません。
- アフィニティ カテゴリと購買意向の強いユーザーのターゲティング: これらの列で使用されているオーディエンス ID をディスプレイ＆ビデオ 360 のインターフェースから取得します。
- コンバージョン Floodlight アクティビティ ID: これらの列で使用されている Floodlight アクティビティ ID をディスプレイ＆ビデオ 360 のインターフェースから取得します。
- 広告枠ソース ターゲティング: これらの列で使用されているエクスチェンジ ID を、公開済みの SDF エクスチェンジ参照から取得します。これらの列で使用されているインベントリ ソース ID とサブエクスチェンジ ID を、Display & Video 360 API を使用して取得します。
- アプリ ターゲティング: これらの列で使用されているアプリ ID を関連するアプリ プラットフォームから取得します。
Display & Video 360 API をすでに使用している場合
SDF を使用して、YouTube とパートナーのリソースの一括作成と更新を行い、ディスプレイ＆ビデオ 360 API の統合をサポートします。
SDF アップロードを使用して YouTube とパートナーのリソースを更新する
ディスプレイ＆ビデオ 360 API を使用して、特定のタイプの広告申込情報、広告グループ、広告などの YouTube とパートナーのリソースを作成または更新することはできません。これらのリソースの構成と割り当てられたターゲティングを取得できますが、更新はディスプレイ＆ビデオ 360 インターフェースで行う必要があります。これにより、一括アクションが制限され、これらのリソースを更新できるレートが制限されます。
構造化データファイルのアップロードを使用して、ディスプレイ＆ビデオ 360 のインターフェースから YouTube とパートナーのリソースを一括で作成または更新します。構造化データファイルは手動でアップロードする必要がありますが、ファイルの取得や変更など、プロセスの大部分はプログラムで実行できます。
詳しくは、SDF のダウンロードに関する API ガイドと SDF のアップロードに関するドキュメントをご覧ください。