このページは Cloud Translation API によって翻訳されました。

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

最終更新日: 2024-11-12

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

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

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

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

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

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

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

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

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

管理画面で設定

パートナーレベル

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

広告主レベル

目的の広告主に移動します。
左側のナビゲーションメニューで [広告主の設定] メニューを開き、[基本情報] ページに移動します。
[構造化データファイル] セクションの 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

制限の更新

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

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