最終更新日: 2023-10-18
このガイドでは、以前のバージョンから 構造化データファイル（SDF）v7 に移行するプロセスと、統合をより適切に最適化するために行う必要のある変更と推奨される変更について説明します。
v6 と v7 の違いの一覧については、リリースノートをご覧ください。
構造化データファイルのバージョンを移行する
以前のバージョンから構造化データファイル v7 に移行するには、新しいバージョンを指定し、既存の列のサブセットの ID 空間を更新し、新しい列との統合を追加する必要があります。
構造化データファイルのバージョンを更新する
新しい構造化データファイルのバージョンに更新するには、親のパートナー リソースと広告主リソースに割り当てるバージョンと、ディスプレイ＆ビデオ 360 API の個々のダウンロード タスクを更新する必要があります。
親リソースの設定を更新する
デフォルトの構造化データファイルのバージョンは、パートナーと広告主のリソースレベルで設定されます。このバージョンは、インターフェースまたは API から構造化データファイルをダウンロードするときにデフォルトとして使用されます。
管理画面で設定する
- パートナー レベル
- 目的のパートナーに移動します。左側のナビゲーションの [パートナーの設定] メニューで [基本情報] ページに移動します。[構造化データファイル] セクションの SDF バージョンの設定を v7 に更新します。
- 広告主レベル
- 目的の広告主に移動します。左側のナビゲーションの [広告主の設定] メニューで [基本情報] ページに移動します。[Structured Data Files] セクションの 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 スペースが更新され、構造化データファイルがサポート終了したエンティティ読み込みファイル プロダクトから分離され、ディスプレイ＆ビデオ 360 API などのサポートされているツールとの整合性がさらに高まりました。
このセクションでは、v6 とは異なる ID を使用するすべての列と、新しい値の参照情報を取得する方法について説明します。
広告掲載オーダー
| 列の v7 移行手順 | |
|---|---|
|
アプリのターゲティング - 除外 アプリのターゲティング - 含める |
これらの列は更新され、「 アプリ プラットフォームは文字列値で識別されます。アプリ ID は、関連するプラットフォームから提供される ID です（Android の Google Play ストアのバンドル ID や Apple の App Store のアプリ ID など）。 |
|
ブラウザ ターゲティング - 除外 ブラウザ ターゲティング - 含める |
この列は、ターゲティング タイプ
|
|
携帯通信会社によるターゲティング - 除外 携帯通信会社によるターゲティング - 含める |
この列は、ターゲティング タイプ
|
|
チャンネル ターゲティング - 除外 チャンネル ターゲティング - 含める |
この列は、ディスプレイ＆ビデオ 360 API の
|
|
デバイス ターゲティング - 除外 デバイス ターゲティング - 含める |
この列は、次のターゲティング タイプで、ディスプレイ＆ビデオ 360 API の
|
| DAR チャネルを測定する |
この列は、ディスプレイ＆ビデオ 360 API の
|
サイト ターゲティング - 除外 サイト ターゲティング - 含める |
この列は、URL 文字列でサイトを識別するように更新されました。 |
広告申込情報
| 列の v7 移行手順 | |
|---|---|
|
アプリのターゲティング - 除外 アプリのターゲティング - 含める |
これらの列は更新され、「 アプリ プラットフォームは文字列値で識別されます。アプリ ID は、関連するプラットフォームから提供される ID です（Android の Google Play ストアのバンドル ID や Apple の App Store のアプリ ID など）。 |
| 単価調整比 |
この列は、アプリとサイトの行タイプに新しい条件 ID を使用するように更新されました。 app 行タイプが更新され、条件 ID にアプリ プラットフォームとアプリ プラットフォーム ID の連結文字列値（コロン区切り）が使用されるようになりました。アプリ プラットフォームは文字列値で識別されます。アプリ ID は、関連するプラットフォームから提供される ID です（Android の Google Play ストアのバンドル ID や Apple の App Store のアプリ ID など）。 site 行タイプが更新され、URL 文字列が条件 ID として使用されるようになりました。 |
|
ブラウザ ターゲティング - 除外 ブラウザ ターゲティング - 含める |
この列は、ターゲティング タイプ
|
|
携帯通信会社によるターゲティング - 除外 携帯通信会社によるターゲティング - 含める |
この列は、ターゲティング タイプ
|
|
チャンネル ターゲティング - 除外 チャンネル ターゲティング - 含める |
この列は、ディスプレイ＆ビデオ 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 と変わりませんが、新しい推奨方法を使用して ID を取得するように統合を更新することをおすすめします。この方法については、v7 の列の説明をご覧ください。
| ファイルの種類とその列 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| キャンペーン |
|
|||||||||||||||||||||
| 広告掲載オーダー |
|
|||||||||||||||||||||
| 広告申込情報 |
|
|||||||||||||||||||||
| メディア商品 |
|
|||||||||||||||||||||
| YouTube 広告グループ |
|
|||||||||||||||||||||