最終更新日: 2023 年 10 月 18 日
このガイドでは、以前のバージョンから構造化データファイル（SDF）v7 に移行する手順と、統合をさらに最適化するために実施できる必須および推奨の変更について説明します。
v6 と v7 の違いの一覧については、リリースノートをご覧ください。
構造化データファイルのバージョンを移行する
以前のバージョンから構造化データファイル v7 に移行するには、新しいバージョンを指定し、既存の列のサブセットの ID 空間を更新して、新しい列との統合を追加する必要があります。
構造化データファイルのバージョンを更新する
構造化データファイルの新しいバージョンに更新するには、親のパートナーや広告主のリソースと、ディスプレイ &ビデオ 360 API で個々のダウンロード タスクに割り当てたバージョンを更新する必要があります。
親リソースの設定を更新する
構造化データファイルのデフォルトのバージョンは、パートナーと広告主のリソースレベルで設定されます。このバージョンは、インターフェースまたは API を使用して構造化データファイルをダウンロードするときにデフォルトとして使用されます。
インターフェースで設定
- パートナー レベル
- 目的のパートナーに移動します。左側のナビゲーションの [パートナーの設定] メニューから [基本情報] ページに移動します。[構造化データファイル] セクションの [SDF バージョン] 設定を v7 に更新します。
- 広告主レベル
- 目的の広告主に移動します。左側のナビゲーションの [広告主の設定] メニューから [基本情報] ページに移動します。[構造化データファイル] セクションの [SDF バージョン] 設定を v7 に更新します。デフォルト バージョンがパートナー レベルで設定されている場合、この設定は編集できません。
API で設定
- 広告主レベル
advertisers.patchリクエストを作成して、dataAccessConfig.sdfConfig.sdfConfig.versionをSDF_VERSION_7に更新し、必要に応じてdataAccessConfig.sdfConfig.overridePartnerSdfConfigをTrueに更新します。
API で sdfdownloadtasks.create リクエストを更新する
ディスプレイ &ビデオ 360 API を使用して sdfdownloadtasks.create リクエストを作成する場合は、リクエスト本文の version フィールドを SDF_VERSION_7 に設定します。
必要な列の ID を更新する
v7 では、列のサブセットで使用される ID 空間が更新され、構造化データファイルが非推奨のエンティティ読み込みファイル プロダクトから切り離され、ディスプレイ &ビデオ 360 API などのサポートされているツールとの調和が強化されています。
このセクションでは、v6 とは異なる ID を使用するすべての列と、新しい値の参照情報を取得する手順について説明します。
広告掲載オーダー
| 列の v7 移行手順 | |
|---|---|
|
アプリ ターゲティング - 除外 アプリ ターゲティング - 含める |
これらの列は、「 アプリ プラットフォームは文字列値で識別されます。アプリ ID は、Android の Play ストアのバンドル ID や Apple の App Store のアプリ ID など、関連するプラットフォームから提供される ID です。 |
|
ブラウザ ターゲティング - 除外 ブラウザ ターゲティング - 含める |
この列は、ターゲティング タイプ
|
|
携帯電話会社のターゲット設定 - 除外 携帯電話会社のターゲット設定 - 含める |
この列は、ターゲティング タイプ
|
|
チャンネル ターゲティング - 除外 チャンネル ターゲティング - 含める |
この列は、ディスプレイ &ビデオ 360 API の
|
|
デバイス ターゲティング - 除外 デバイス ターゲティング - 含める |
この列は、次のターゲティング タイプのディスプレイ &ビデオ 360 API の
|
| DAR チャンネルを測定 |
この列は、ディスプレイ &ビデオ 360 API の
|
サイト ターゲティング - 除外 サイト ターゲティング - 含める |
この列は、URL 文字列でサイトを識別できるように更新されました。 |
広告申込情報
| 列の v7 移行手順 | |
|---|---|
|
アプリ ターゲティング - 除外 アプリ ターゲティング - 含める |
これらの列は、「 アプリ プラットフォームは文字列値で識別されます。アプリ ID は、Android の Play ストアのバンドル ID や Apple の App Store のアプリ ID など、関連するプラットフォームから提供される ID です。 |
| 単価調整比 |
この列は、行タイプ app と site に新しい条件 ID を使用するように更新されました。 app 行タイプが更新され、アプリ プラットフォームとアプリ プラットフォーム ID をコロンで区切った連結された文字列値が条件 ID に使用されるようになりました。アプリ プラットフォームは文字列値で識別されます。アプリ ID は、Android の Play ストアのバンドル ID や Apple の App Store のアプリ ID など、関連するプラットフォームから提供される ID です。 site 行タイプは、条件 ID として URL 文字列を使用するように更新されました。 |
|
ブラウザ ターゲティング - 除外 ブラウザ ターゲティング - 含める |
この列は、ターゲティング タイプ
|
|
携帯電話会社のターゲット設定 - 除外 携帯電話会社のターゲット設定 - 含める |
この列は、ターゲティング タイプ
|
|
チャンネル ターゲティング - 除外 チャンネル ターゲティング - 含める |
この列は、ディスプレイ &ビデオ 360 API の
|
|
デバイス ターゲティング - 除外 デバイス ターゲティング - 含める |
この列は、次のターゲティング タイプのディスプレイ &ビデオ 360 API の
|
サイト ターゲティング - 除外 サイト ターゲティング - 含める |
この列は、URL 文字列でサイトを識別できるように更新されました。 |
メディア製品
| 列の v7 移行手順 | |
|---|---|
|
チャンネル ターゲティング - 除外 チャンネル ターゲティング - 含める |
この列は、ディスプレイ &ビデオ 360 API の
|
| デバイス ターゲティング - 含める |
この列は、次のターゲティング タイプのディスプレイ &ビデオ 360 API の
|
v6 以降に追加された列との統合を追加する
v6 から v7 に移行する場合は、関連するファイルに次の列を追加する必要があります。
| ファイル形式 | 列 |
|---|---|
| 広告申込情報 | TrueView フリークエンシー目標設定数 |
| 広告申込情報 | TrueView フリークエンシー目標設定の期間 |
| YouTube 広告グループ | 最適化されたターゲティング |
以前のバージョンの構造化データファイルから移行する場合は、構造化データファイルのリリースノートで、現在のバージョンと SDF v6 の間に追加される列をご確認ください。
その他の変更
v7 では、統合を簡素化し、非推奨のエンティティ読み取りファイルを参照用に使用しないように、表面的な変更も実施しました。
列のサブセットに対する新しいリストの順序付け
SDF v7 では、ファイルの生成時に特定のリスト列の順序が安定していることが保証されます。その結果、動作の一貫性が高まり、審査が容易になります。この順序は、ファイルのアップロード時には適用されず、その後、更新されたファイルを生成するときに適用されます。
昇順またはアルファベット順で生成されるようになった列の一覧については、v7 リリースノートをご覧ください。
新しい ID 参照に関する推奨事項
いくつかの列の定義を更新し、サポートが終了したエンティティ読み取りファイルへの参照を削除し、代わりに ID ルックアップの他の手段を推奨しています。
次の列によって返される値は SDF v6 と変わりませんが、v7 の列の説明にある新しい推奨メソッドを使用して ID を取得するように統合を更新することをおすすめします。
| ファイル形式と列 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campaign |
|
|||||||||||||||||||||
| 広告掲載オーダー |
|
|||||||||||||||||||||
| 広告申込情報 |
|
|||||||||||||||||||||
| メディア商品 |
|
|||||||||||||||||||||
| YouTube 広告グループ |
|
|||||||||||||||||||||