構造化データファイルをアップロードするには、v9 以降を使用する必要がある場合があります。詳しくは、非推奨のページをご覧ください。手順については、v9 移行ガイドをご覧ください。

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

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

最終更新日: 2025 年 8 月 21 日

このガイドでは、次のプロセスについて説明します。

ディスプレイ＆ビデオ 360 の UI または API を使用して、選択した構造化データファイルのバージョンを v9 に更新します。
非推奨の構造化データファイルバージョン（v7、v7.1、v8、v8.1）から v9 に統合を移行します。現在のバージョンと v9 の変更点について詳しく説明しているページへのリンクが記載されています。これらの変更点は、統合に影響する可能性があります。場合によっては、2025 年 9 月 8 日以降、SDF のアップロードに v9 を使用する必要があります。

バージョンと v9 の違いの完全なリストについては、各バージョンに固有の移行ページをご覧ください。

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

v9 を使用するには、構造化データファイルのダウンロードとアップロード時に v9 を使用するように、リソースと SDF 生成アクションを更新する必要があります。

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

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

パートナーレベルの場合:

広告主レベルの場合:

目的の広告主に移動します。
左側のナビゲーションで、[広告主の設定] メニューの [基本情報] ページに移動します。
[構造化データファイル] セクションの [SDF バージョン] 構成を v9 に更新します。デフォルトバージョンがパートナーレベルで設定されている場合、この設定は編集できないことがあります。

パートナーレベル: API のパートナーレベルでデフォルトの SDF バージョンを設定することはできません。

広告主レベル: advertisers.patch リクエストを行い、dataAccessConfig.sdfConfig.sdfConfig.version を SDF_VERSION_9 に更新します。必要に応じて、dataAccessConfig.sdfConfig.overridePartnerSdfConfig を True に更新します。

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

次のページでは、現在のバージョンから v9 に移行する際に統合に必要な更新について説明し、バージョン間のすべての変更の一覧を示します。