構造化データファイル（SDF）は、特別な形式の CSV ファイルです。これにより、ディスプレイ＆ビデオ 360 でリソースの一括取得、作成、編集が可能になります。SDF をダウンロード、編集、再アップロードして、リソースを一括で更新します。
ディスプレイ＆ビデオ 360 の管理画面では、SDF のダウンロードとアップロードがサポートされています。ディスプレイ＆ビデオ 360 API は SDF のダウンロードをサポートしています。
フォーマット
SDF では、標準と QA の 2 つの基本形式のいずれかを使用します。
- 標準形式のファイルをダウンロード、アップロードできます。これらのファイルのデータでは、アップロード時の精度を確保するために数値 ID が使用されている場合があります。データを解釈するには、参照情報が必要になる場合があります。
- QA 形式のファイルをダウンロードできます。これらのファイルは、標準形式のファイルと同じデータを提供しますが、より人間が読める値を使用します。たとえば、一部の列では ID の代わりに表示名が使用されることがあります。この形式に固有の列には、接尾辞「Qa」が使用されます。
ファイル形式
SDF は 7 つのリソースタイプをサポートしています。各リソースタイプには、独自の列構造を持つ独自のファイルタイプがあります。サポートされているリソースタイプは次のとおりです。
- キャンペーン
- 広告掲載オーダー
- 広告申込情報
- 広告グループ
- 広告
- 広告枠ソース
- メディア商品
QA 形式をサポートしているのは、広告申込情報と広告グループのファイル形式のみです。
SDF の新バージョンは定期的にリリースされ、以前のバージョンは非推奨となります。新しいバージョンでは、ファイル形式の列構造が更新されます。必要に応じて、新しい SDF バージョンにはリリース時に移行ガイドが含まれます。
エラーをダウンロード
SDF のダウンロードでは、ファイルの生成エラーとスキップされたリソースの 2 種類のエラーが発生する可能性があります。
ファイル生成エラー
SDF の生成がエラーで終了することがあります。Display & Video 360 API の使用時に生成が失敗した場合、完了したタスクは error フィールドを Status オブジェクトで設定します。Status オブジェクトには、エラーの原因を説明するメッセージが含まれます。
これらのエラーについて詳しくは、エラーと警告に関するガイドページをご覧ください。
スキップされたエラー
SDF は、すべてのリソース サブタイプをサポートしていません。リソースを SDF に含めることができない場合は、「スキップ」ファイル（例: SDF-LineItems-Skipped.csv）がダウンロードに含まれます。このファイルは 2 列の構造になっています。最初の列は、スキップされたリソースを示します。2 列目は除外の理由を示しています。
ファイルのアップロード
ディスプレイ＆ビデオ 360 の管理画面を使用して SDF をアップロードすることで、新しいリソースを作成したり、既存のリソースを更新したりできます。
SDF を使用してリソースを更新または作成する際にエラーを最小限に抑えるには、次の手順を行います。
- ディスプレイ＆ビデオ 360 API または管理画面を使用して SDF をダウンロードします。
- 既存のファイル エントリを変更して、既存のリソースを更新します。
- ファイル エントリを追加して新しいリソースを作成します。
- 新規または更新されたエントリ以外のエントリを削除します。これにより、ファイルサイズが小さくなり、意図しない更新が発生する可能性がなくなります。
- ディスプレイ＆ビデオ 360 の UI でファイルをアップロードします。
SDF がアップロードされて処理されると、SDF-ResultFile.zip ファイルをダウンロードできるようになります。この ZIP ファイルには、次の 2 つのファイルが含まれる可能性があります。
SDF-{ResourceType}-Updated-ResultFile.csv: 正常に更新または作成されたリソースのリスト。SDF-{ResourceType}-Failed-ResultFile.csv。失敗したオペレーションと関連するエラー メッセージが一覧表示されます。
ZIP ファイルには、これらのファイルの一方または両方が含まれている場合があります。