構造化データファイル v8 に移行する

最終更新日: 2024-11-12

このガイドでは、構造化データ ファイル v7.1 から v8 への移行プロセスについて説明します。また、統合に影響する可能性のある 2 つのバージョンの変更点についても説明します。

v7.1 と v8 の違いの一覧については、リリースノートをご覧ください。

構造化データファイルのバージョンを移行する

以前のバージョンから構造化データファイル（SDF）v8 に移行するには:

  1. v8 を使用するようにリソースと SDF 生成アクションを更新します。
  2. 広告リソースのロジックを更新し、作成時にタイプを識別できるようにしました。
  3. デマンド ジェネレーション リソースの読み取り、作成、更新のための新しいロジックを追加。

構造化データファイルのバージョンを更新する

新しい構造化データファイル バージョンを使用するには、親のパートナー リソースと広告主リソースで割り当てられたバージョンを更新し、ディスプレイ＆ビデオ 360 API で個々のダウンロード タスクを作成するときに新しいバージョンを使用します。

親リソースの設定を更新する

デフォルトの構造化データファイルのバージョンは、パートナーと広告主のリソースレベルで設定されます。このバージョンは、インターフェースまたは API から構造化データファイルをダウンロードするときにデフォルトとして使用されます。

管理画面で設定する

パートナー レベル

  1. 目的のパートナーに移動します。
  2. 左側のナビゲーション メニューで [パートナーの設定] メニューを開き、[基本情報] ページに移動します。
  3. [構造化データファイル] セクションの SDF バージョンの設定を v8 に更新します。

広告主レベル

  1. 目的の広告主に移動します。
  2. 左側のナビゲーション メニューで [広告主の設定] メニューを開き、[基本情報] ページに移動します。
  3. [構造化データファイル] セクションの SDF バージョンの設定を v8 に更新します。デフォルト バージョンがパートナー レベルで設定されている場合、この設定は編集できないことがあります。
API で設定する
パートナー レベル
API でパートナー レベルのデフォルトの SDF バージョンを設定することはできません。
広告主レベル
advertisers.patch リクエストを実行して、dataAccessConfig.sdfConfig.sdfConfig.version を SDF_VERSION_8 に更新し、必要に応じて dataAccessConfig.sdfConfig.overridePartnerSdfConfig を True に更新します。

API の sdfdownloadtasks.create リクエストを更新

Display & Video 360 API を使用して sdfdownloadtasks.create リクエストを行う場合は、リクエスト本文の version フィールドを SDF_VERSION_8 に設定します。

広告リソースでタイプを指定する

v8 では、Ad ファイルに Ad Type 列が追加され、各行で表される広告の種類が表示されます。この新しい列は必須で、v8 広告ファイルをダウンロードするときに既存のリソースに入力されます。

既存の広告を更新する場合、この列の値は変更しないでください。

新しい広告を作成する場合は、この列に列の説明に記載されている値のいずれかを入力する必要があります。

デマンド ジェネレーション リソースの更新ロジック

v8 では、広告申込情報、広告グループ、広告ファイルを使用して、デマンド ジェネレーション キャンペーンの作成、取得、更新がサポートされています。デマンド ジェネレーション リソースは、タイムスタンプの検証に異なるロジックを使用し、追加の列の入力が必要であり、3 つのファイル形式にわたる新しい制限によって制限されます。

タイムスタンプの確認

デマンド ジェネレーション以外のすべての広告申込情報の場合、広告申込情報ファイルの Timestamp 列には、ダウンロード時に広告申込情報の最終更新日時が入力されます。この値は、SDF を使用して広告申込情報を更新する際に、元のファイルがダウンロードされてから広告申込情報が更新されていないことを確認するために使用されます。その場合、更新は失敗します。

デマンド ジェネレーション広告申込情報の場合、Timestamp 列とそれに付随する検証は異なります。デマンド ジェネレーション広告申込情報のエントリの場合、この列にはダウンロード時の現在の時刻が入力されます。アップロード時に、指定されたタイムスタンプから 24 時間以上経過しているかどうかがディスプレイ＆ビデオ 360 で確認されます。24 時間を超えると、元のファイル エントリは古いと見なされ、更新は失敗します。この場合は、ファイルを再度ダウンロードし、新しいバージョンに基づいて更新します。この新しい確認方法では、過去 24 時間以内に行われた変更が上書きされることはありません。誤って上書きしないように、アップロードするファイルには更新するデマンド ジェネレーション広告申込情報のみを含めてください。

必須の列

次のファイル形式では、そのファイル形式のすべてのエンティティに必要な列に加えて、特定のデマンド ジェネレーション リソースに必要な列が追加されました。

広告申込情報
次の 項目アイテム の Type 列の値に必要な列
デマンド ジェネレーション
Pacing Amount
TrueView Bid Strategy Type
TrueView Bid Strategy Value
次の 広告 の Ad Type 列の値に必要な列
デマンド ジェネレーション カルーセル
Business Name
Call to Action
Demand Gen Cards
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
デマンド ジェネレーション画像
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Marketing Image Asset Id
デマンド ジェネレーション プロダクト
Business Name
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
デマンド ジェネレーション動画
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Id

制限の更新

特定のデマンド ジェネレーション広告申込情報と広告に新たに必須となった列に加えて、広告申込情報、広告グループ、広告のファイル形式の複数の列に、デマンド ジェネレーション リソースに適用される新しい使用制限が設けられました。

これらの制限は多数あり、該当する列に固有のものであるため、このガイドでは制限の一覧をすべて記載していません。SDF アップロードを使用してデマンド ジェネレーション リソースを作成または更新する前に、広告申込情報、広告グループ、広告のファイル形式に関する v8 リファレンス ドキュメントをよくお読みになることをおすすめします。