構造化データファイル（SDF）の部分的なアップロード

構造化データファイル（SDF）の部分アップロードを使用すると、ディスプレイ＆ビデオ 360 のユーザーは、構造化データファイルを使用して、既存の広告申込情報のリソース構成のサブセットを一括で更新できます。このファイルには、広告申込情報ファイル形式で通常必要となる列よりも少ない列が含まれています。

列数を減らすことで、部分的な SDF アップロードには次のようなメリットがあります。

  • 1 つのアップロード ファイルに含めることができるリソースの数を増やします。
  • SDF の手動管理が容易になります。
  • アップロードされた SDF を、以前にダウンロードしたファイルから作成する必要がなくなりました。
  • 最初のファイルのアップロードから更新の伝播までの時間を短縮します。

部分的な SDF は、広告申込情報 SDF でのみサポートされています。

部分的な SDF のアップロードの使用方法

部分的な SDF をビルドしてアップロードする手順は次のとおりです。

  1. 更新する広告申込情報と設定を決定します。

    • Line Item Id 列を使用して広告申込情報を特定します。この列はすべての部分一致 SDF で必須であり、すべてのファイル エントリに入力する必要があります。

    • [利用可能な列グループ] セクションで、更新する列を選択します。

      • 列グループ内の列を更新するには、そのグループ内のすべての列がファイルに存在する必要があります。
      • 1 つのファイルに複数の列グループを含めることができます。
      • 列グループが不完全なファイルや、部分的な SDF アップロードでサポートされていない列を含むファイルは、エラーになります。

  2. 次のいずれかの方法でファイルをビルドします。

    • 既存の SDF を使用します。

      • 標準の SDF を管理してアップロードする場合と同様に、関連する広告申込情報を含む広告申込情報 SDF をダウンロードします。
      • 選択したすべての広告申込情報を含む初期 SDF をダウンロードします。
      • 関連する部分 SDF 列グループに含まれていない列をすべて削除します。
      • 更新しない広告申込情報の項目はすべて削除します。

    • 新しい CSV ファイルを作成します。

      • CSV ファイルを作成し、関連する部分 SDF 列グループの列のヘッダーのみを含めます。
      • 更新する項目 ID ごとに、ファイルにエントリを追加します。

  3. 新しい部分的な SDF にデータを入力します。

    • ダウンロードしたファイルを使用する場合は、各項目エントリの既存の値を更新します。更新しない値は変更する必要はありません。部分的な SDF は Timestamp 列をサポートしていません。ファイル ダウンロードから部分的な SDF アップロードまでの間に明細項目に加えた変更は、関連する列が含まれている場合、上書きされます。
    • 新しい CSV ファイルを使用する場合は、すべての行項目のエントリについて、含まれるすべての列に値を入力します。列の値を意図的に空にすることはできますが、アップロード時にその空の値が広告申込情報の設定の新しい値として保存されます。

  4. 標準の SDF アップロード プロセスを使用して、管理画面でファイルをディスプレイ＆ビデオ 360 にアップロードします。Partial SDF として識別するために追加の構成は必要ありません。アップロードしたファイルが処理されると、一括ステータス ページで結果ファイルを確認できます。このファイルには、どの行項目が正常に更新され、どの行項目が更新に失敗したかが記載されています。標準の SDF のアップロードとは異なり、部分的な SDF がアップロードされて処理された後、結果ファイルを含むメールは送信されません。

サンプル ファイル

部分 SDF の作成に使用できるサンプルファイルが 3 つ用意されています。各サンプルでは、列グループの異なる組み合わせを使用しています。各テンプレートには、関連する列を識別するヘッダー行と、アップロード前に目的のデータで更新する必要がある 3 つの行が含まれています。

特定された列グループを含む次のいずれかの CSV ファイルをテンプレートとして使用するためにダウンロードします。

使用可能な列グループ

部分 SDF で使用できる列グループは次のとおりです。各グループには、SDF 行項目ファイル形式の 1 つ以上の列が含まれます。列グループに複数の列がある場合は、そのグループのすべての列をアップロード ファイルに含める必要があります。

広告申込情報 ID

含まれている列:

  • Line Item ID

名前

含まれている列:

  • Name

ステータス

含まれている列:

  • Status

フライト フィールド

含まれている列:

  • Start Date
  • End Date

[予算とペース] フィールド

含まれている列:

  • Budget Type
  • Budget Amount
  • Pacing
  • Pacing Rate
  • Pacing Amount

フリークエンシー キャップのフィールド

すべての広告申込情報タイプに含まれる列:

  • Frequency Enabled
  • Frequency Exposures
  • Frequency Period
  • Frequency Amount

TrueView 広告申込情報がある場合に必須の追加の列:

  • TrueView View Frequency Enabled
  • TrueView View Frequency Exposures
  • TrueView View Frequency Period

[パートナーの収益モデル] フィールド

含まれている列:

  • Partner Revenue Model
  • Partner Revenue Amount

コンバージョン トラッキング フィールド

含まれている列:

  • Conversion Counting Type
  • Conversion Counting Pct
  • Conversion Floodlight Activity Ids
  • Primary Attribution Model Id

[Reporting Info] フィールド

含まれている列:

  • Integration Code
  • Details

入札戦略のフィールド

含まれている列:

  • Bid Strategy Type
  • Bid Strategy Value
  • Bid Strategy Unit
  • Bid Strategy Do Not Exceed
  • Apply Floor Price For Deals
  • Algorithm Id

クリエイティブの割り当て

含まれている列:

  • Creative Assignments

地域ターゲティングのフィールド

含まれている列:

  • Geography Targeting - Include
  • Geography Targeting - Exclude

近接ターゲット

含まれている列:

  • Proximity Targeting

キーワード ターゲティングのフィールド

含まれている列:

  • Keyword Targeting - Include
  • Keyword Targeting - Exclude

考慮事項

部分 SDF をアップロードする前に、次のことを確認してください。

  • [項目 ID] 列が存在し、すべてのエントリに値が入力されている。
  • 含まれるすべての列が、サポートされている部分 SDF 列グループの一部である。
  • 表現された列グループ内のすべての列が含まれます。
  • カンマと、カンマで区切られた列の値の間にスペースはありません。
  • 現在のエントリの各値は、その列の目的の値です。
  • 異なる広告主の広告申込情報を更新する場合は、共有パートナー レベルで部分 SDF をアップロードします。異なるパートナーの 2 つの広告申込情報を同じ SDF で更新することはできません。