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