データの一括書き出しと読み込み

Planning を使用すると、大量のプロジェクト データをまとめて変更できます。それには、データをファイルに書き出してからファイルの内容を編集し、編集後のデータを Planning に読み込みます。

広告枠ファイルの書き出し

プロジェクト内のすべてのプレースメント、パッケージ、ロードブロッキングを、カンマで値を区切る形式のファイル（CSV、.csv）に書き出すことができます。この広告枠ファイルには、プロジェクト内のプレースメント、パッケージ、ロードブロッキングに関する情報が含まれます。このファイルは、テキスト エディタでも表示、編集できますが、スプレッドシート プログラムに読み込むと編集しやすくなります。

広告枠ファイルの読み込み

広告枠ファイルの値を編集したら、その変更を Planning に読み込むことができます（スプレッドシート エディタで変更した場合は、読み込む前に .csv ファイルとして保存してください）。複数のプレースメントを一度に変更する場合はこの方法が便利です。

広告枠ファイルを次のように変更してから、Planning にアップロードして戻すことができます。

• プレースメントを作成、編集する
• プレースメント グループ（パッケージとロードブロッキング）を作成、編集する
• グループ内プレースメントを作成、編集する
• プレースメントまたはプレースメント グループの複数の掲載期間を編集する

スプレッドシートを編集する際には、次の点に注意してください。

• キャンペーン マネージャー 360 での編集とは異なり、グループ内プレースメントのグループ割り当てを変更することで割当先のグループを変えることはできません。
• 既存のグループ内プレースメントを編集する際、[プレースメント ID] 列にグループ内プレースメントの ID があれば、スプレッドシート内にその親のプレースメント グループはなくても構いません。

以下、操作ごとに一括処理する方法を説明します。各操作の横にある下矢印をクリックすると、説明が表示されます。

新しいプレースメントを作成する

プロジェクトでプレースメントを作成する手順は次のとおりです。

1. スプレッドシートで、プロジェクトに追加するプレースメントごとに行を追加します。
2. [操作] 列に「作成」と入力します。
3. [プレースメント タイプ] 列に「プレースメント」と入力します。
4. 次の必須項目をすべて入力します。
   1. サイト名
   2. プレースメント名
   3. 開始日と終了日
   4. 互換性
   5. 幅と高さ（プレースメントの [互換性] が「ディスプレイ」の場合。プレースメントが読み込まれると、この 2 つの値は [サイズ] として 1 つの値にまとめられます）
   6. 支払い元
   7. 課金形態
   8. 費用上限
   9. ユニット
   10. レート（プレースメントの [課金形態] が「CPM」、「vCPM - アクティブ ビュー」、「CPC」、「CPA」のいずれかの場合）
   11. 費用（プレースメントの [課金形態] が「フラットレート - インプレッション数」または「フラットレート - クリック数」の場合）
5. スプレッドシートを保存します。
6. Planning を開き、プロジェクトの [広告枠] ビューで、[インポート] をクリックします。保存したファイルを選択して [開く] をクリックします。
   1. プロフィールに関連付けたアカウントに、変更した内容と、Planning によるファイルの処理中に発生したすべてのエラーを記載したメール通知が届きます。
7. ファイルに追加したプレースメントの行に基づき、プロジェクトに新しいプレースメントが作成されます。

新しいプレースメント グループ（パッケージまたはロードブロッキング）を作成する

グループ内プレースメントを含む新しいプレースメント グループを作成する手順は次のとおりです。

1. スプレッドシートに 1 行追加します。
2. [操作] 列に「作成」と入力します。
3. [プレースメント タイプ] 列に「パッケージ」または「ロードブロッキング」と入力します。
4. このプレースメント グループについて次の必須項目をすべて入力します。
   1. サイト名
   2. プレースメント名
   3. 開始日と終了日
   4. 課金形態
   5. 費用上限
   6. ユニット
   7. レート（プレースメント グループの [課金形態] が「CPM」、「vCPM - アクティブ ビュー」、「CPC」、「CPA」のいずれかの場合）
   8. 費用（プレースメント グループの [課金形態] が「フラットレート - インプレッション数」または「フラットレート - クリック数」の場合）
5. 必要に応じて、プレースメント（複数可）を任意のプレースメント グループに追加します。手順については下記をご覧ください。
6. プレースメント グループとグループ内プレースメントを追加したら、スプレッドシートを保存します。
7. Planning を開き、プロジェクトの [広告枠] ビューで、[インポート] をクリックします。保存したファイルを選択して [開く] をクリックします。
   1. プロフィールに関連付けたアカウントに、変更した内容と、Planning によるファイルの処理中に発生したすべてのエラーを記載したメール通知が届きます。
8. ファイルに追加した行に基づき、プロジェクトに新しいプレースメント グループとグループ内プレースメントが作成されます。

グループ内プレースメントを新しいプレースメント グループに追加する

グループ内プレースメントを新しいプレースメント グループ（上記参照）に追加する手順は次のとおりです。

1. プロジェクトに追加するグループ内プレースメント用に行を追加します。注: この行は、親となるプレースメント グループか、他のグループ内プレースメントの直下に追加する必要があります。
2. [操作] 列に「作成」と入力します。
3. [プレースメント タイプ] 列に「グループ内プレースメント」と入力します。
4. 次の必須項目をすべて入力します。
   1. プレースメント名
   2. メイン プレースメントかどうか（プレースメント グループが「ロードブロッキング」の場合。注: ロードブロッキングのメイン プレースメントに指定できるグループ内プレースメントは 1 つだけです）
   3. 互換性
   4. 幅と高さ（グループ内プレースメントの [互換性] が「ディスプレイ」の場合）。プレースメントが読み込まれると、この 2 つの値は [サイズ] の 1 つの値としてまとめられます。
   5. 支払い元
5. スプレッドシートを保存します。
6. Planning を開き、プロジェクトの [広告枠] ビューで、[インポート] をクリックします。保存したファイルを選択して [開く] をクリックします。
   1. プロフィールに関連付けたアカウントに、変更した内容と、Planning によるファイルの処理中に発生したすべてのエラーを記載したメール通知が届きます。
7. ファイルに追加した行に基づき、プロジェクトに新しいプレースメント グループとグループ内プレースメントが作成されます。

既存のプレースメント、プレースメント グループ、グループ内プレースメントを編集する

プロジェクトの既存のプレースメント、プレースメント グループ、グループ内プレースメントを編集する手順は次のとおりです。

1. 書き出したスプレッドシートで、プロジェクトに追加するプレースメントの行を探します。または、新しい行を追加して、編集するプレースメントの ID を [プレースメント ID] 列に入力します。
2. [操作] 列に「更新」と入力します。
3. 次の項目を編集します（注: 必須項目はすべて埋める必要があります）。
   1. サイト名
   2. プレースメント名
   3. 開始日と終了日
   4. 互換性
   5. 幅と高さ（プレースメントの [互換性] が「ディスプレイ」の場合）。プレースメントが読み込まれると、この 2 つの値は [サイズ] の 1 つの値としてまとめられます。
   6. 支払い元
   7. 課金形態
   8. 費用上限
   9. ユニット
   10. レート（プレースメントの [課金形態] が「CPM」、「vCPM - アクティブ ビュー」、「CPC」、「CPA」のいずれかの場合）
   11. 費用（プレースメントの [課金形態] が「フラットレート - インプレッション数」または「フラットレート - クリック数」の場合）
4. スプレッドシートを保存します。
5. Planning を開き、プロジェクトの [広告枠] ビューで、[インポート] をクリックします。保存したファイルを選択して [開く] をクリックします。
   1. プロフィールに関連付けたアカウントに、変更した内容と、Planning によるファイルの処理中に発生したすべてのエラーを記載したメール通知が届きます。
6. ファイルで編集したプレースメントの行に基づき、プロジェクトの既存のプレースメント、プレースメント グループ、グループ内プレースメントが編集されます。

新しいプレースメントまたはプレースメント グループに掲載期間を追加する

新しいプレースメントまたはプレースメント グループに掲載期間を追加する手順は次のとおりです。

1. スプレッドシートで、掲載期間を追加する行に移動します。
2. 該当するプレースメントの行の下に新しい行を作成します。
3. 新しい行の [操作] 列は空欄のままにします。
4. [プレースメント タイプ] 列に「掲載期間」と入力します。
5. 次の必須項目をすべて入力します。
   1. 開始日
   2. 終了日
   3. レート（プレースメントの [課金形態] が「CPM」、「vCPM - アクティブ ビュー」、「CPC」、「CPA」のいずれかの場合）
   4. 費用（プレースメントの [課金形態] が「フラットレート - インプレッション数」または「フラットレート - クリック数」の場合）
6. 掲載期間をさらに追加する場合はステップ 2～5 を繰り返します。追加を終えたら、スプレッドシートを保存します。
7. Planning を開き、プロジェクトの [広告枠] ビューで、[インポート] をクリックします。保存したファイルを選択して [開く] をクリックします。
   1. プロフィールに関連付けたアカウントに、変更した内容と、Planning によるファイルの処理中に発生したすべてのエラーを記載したメール通知が届きます。
8. ファイルに追加した掲載期間が、Planning の該当するプレースメントやプレースメント グループに追加されます。

既存のプレースメントまたはプレースメント グループに掲載期間を追加する

既存のプレースメントまたはプレースメント グループに掲載期間を追加する手順は次のとおりです。

1. スプレッドシートで、掲載期間を追加する行に移動します。
2. [操作] 列に「更新」と入力します。
3. 該当するプレースメントの行の下に新しい行を作成します。
4. 新しい行の [操作] 列は空欄のままにします。
5. [プレースメント タイプ] 列に「掲載期間」と入力します。
6. 次の必須項目をすべて入力します。
   1. 開始日
   2. 終了日
   3. レート（プレースメントの [課金形態] が「CPM」、「vCPM - アクティブ ビュー」、「CPC」、「CPA」のいずれかの場合）
   4. 費用（プレースメントの [課金形態] が「フラットレート - インプレッション数」または「フラットレート - クリック数」の場合）
7. 掲載期間をさらに追加する場合はステップ 3～6 を繰り返します。追加を終えたら、スプレッドシートを保存します。
8. Planning を開き、プロジェクトの [広告枠] ビューで、[インポート] をクリックします。保存したファイルを選択して [開く] をクリックします。
   1. プロフィールに関連付けたアカウントに、変更した内容と、Planning によるファイルの処理中に発生したすべてのエラーを記載したメール通知が届きます。
9. ファイルに追加した掲載期間が、Planning の該当するプレースメントやプレースメント グループに追加されます。

既存のプレースメントまたはプレースメント グループから掲載期間を削除する

既存のプレースメントまたはプレースメント グループから掲載期間を削除する手順は次のとおりです。

1. スプレッドシートで、掲載期間を削除するプレースメントの行に移動します。
2. [操作] 列に「更新」と入力します。
3. そのプレースメントから削除する掲載期間の行を削除します。
4. 掲載期間をさらに削除する場合はステップ 3 を繰り返します。削除を終えたら、スプレッドシートを保存します。
5. Planning を開き、プロジェクトの [広告枠] ビューで、[インポート] をクリックします。保存したファイルを選択して [開く] をクリックします。
   1. プロフィールに関連付けたアカウントに、変更した内容と、Planning によるファイルの処理中に発生したすべてのエラーを記載したメール通知が届きます。
6. ファイルから削除した掲載期間が、Planning の該当するプレースメントやグループから削除されます。

広告枠ファイルを Planning に読み込むと、次のような結果を確認できます。

• 変更した値がプロジェクトに反映されます。
• 読み込みの確認メールが届きます。エラーがあった場合、一部のエラーはこのメールで報告されます。
• このメールには読み込まれたデータを含むスプレッドシートが添付されます。読み込みエラーがあった場合は、このスプレッドシートに記載されます。

広告枠ファイルの形式

.csv ファイルをスプレッドシートとして編集する場合、広告枠ファイルの各行はプレースメント、パッケージ、ロードブロッキングのいずれかを表します。広告枠ファイルの書き出しでは、プレースメント、パッケージ、ロードブロッキングそれぞれに関するすべての値が書き出されます。広告枠ファイルの読み込みでは、更新するプレースメント、パッケージ、ロードブロッキングに必要な値を入力する必要があります。

次の表に、広告枠ファイルの各列と、それぞれ使用する値の種類を示します。

項目名	必須 / 省略可	値
操作	必須	読み込み時の列の処理方法。値は次のいずれかを指定します（大文字と小文字は区別されません）。 表示 - 値は無視されます。 更新 - 値は既存のプレースメント、パッケージ、ロードブロッキングの更新に使用されます。 作成 - 値は新しいプレースメント、パッケージ、ロードブロッキングの作成に使用されます。
プレースメント タイプ	必須	行が表す項目の種類。新しい項目を作成する場合、この値は必須です。値は次のいずれかを指定します（大文字と小文字は区別されません）。 プレースメント パッケージ ロードブロッキング 注: 作成後に項目の種類を変更することはできません。
サイト名	必須	プレースメントが属するサイト。値は、自由形式のテキスト欄に入力する文字列で指定します（大文字と小文字は区別されます）。
プレースメント名	必須	プレースメント、パッケージ、ロードブロッキングの名前。値は文字列で指定します（大文字と小文字は区別されます）。
プレースメント ID	「更新」操作の場合は必須	プレースメント、パッケージ、またはロードブロッキングの ID。この値は、行の操作に「更新」を指定した場合に必須となります（操作に「作成」を指定した場合、この ID は無視され、新しい ID が自動的にプレースメントに割り当てられます）。
メイン プレースメントかどうか	ロードブロッキング内で 1 つのグループ内プレースメントの指定が必須	グループ内プレースメントがロードブロッキングのメイン プレースメントかどうか。値は次のいずれかを指定します（大文字と小文字は区別されません）。 Y（メイン プレースメントである） N（メイン プレースメントではない）
グループの割り当て	「作成」操作の場合は必須	この新しいグループ内プレースメントの割り当て先となる、既存のプレースメント グループの ID。 新しいプレースメント グループのグループ内プレースメントを作成する場合は、このセルを空欄のままにします。
開始日 終了日	必須	プレースメントの開始日と終了日。行の操作に「作成」を指定した場合に、自動作成される単一の掲載期間の開始日と終了日として使用されます。値は yyyy-mm-dd の日付形式で指定します。
掲載期間数	読み込み時は無視	プレースメントの掲載期間数。この値は、読み込み時は無視されます。
互換性	プレースメントの行で必須、パッケージとロードブロッキングの行では無視	プレースメントの互換性タイプ（パッケージとロードブロッキングには互換性タイプはありません）。値は次のいずれかを指定します（大文字と小文字は区別されません）。 ディスプレイ ディスプレイ インタースティシャル インストリーム動画
幅 高さ	互換性タイプが「ディスプレイ」のプレースメントの場合は必須	プレースメントのサイズ。幅と高さは、互換性タイプが「ディスプレイ」のプレースメントにのみ適用されます。値は整数です。プレースメントが読み込まれると、この 2 つの値は [サイズ] として 1 つの値にまとめられます。
支払い元	プレースメントの行で必須、パッケージとロードブロッキングの行では無視	プレースメントの料金の支払い元（代理店またはサイト運営者）。値は「代理店」か「サイト運営者」のいずれかを指定します（大文字と小文字は区別されません）。
課金形態	必須	プレースメント費用の計算方法。値は次のいずれかを指定します（大文字と小文字は区別されません）。 CPM vCPM - アクティブ ビュー CPC CPA フラットレート - インプレッション数 フラットレート - クリック数
費用上限	必須	プレースメント費用の上限の設定方法（上限がある場合）。値は次のいずれかを指定します（大文字と小文字は区別されません）。 なし 月別 累計
ユニット数	必須	プレースメントのユニット数（インプレッション数またはクリック数）。複数の掲載期間が設定されているプレースメントの場合、広告枠ファイルの読み込みでこの項目を更新することはできません。値は整数で指定します。
レート	課金形態が CPM、CPC、CPA の場合は必須、それ以外は無視	プレースメントのユニット単価。複数の掲載期間が設定されているプレースメントの場合、広告枠ファイルの読み込みでこの項目を更新することはできません。このプレースメントのレート値は、書き出し時は無視されます。値は、小数点以下第 4 位までの小数で指定します。
費用	課金形態が「フラットレート - インプレッション数」または「フラットレート - クリック数」の場合は必須、それ以外は無視。クレジットの場合は必須。	プレースメントの合計費用。複数の掲載期間が設定されているプレースメントの場合、広告枠ファイルの読み込みでこの項目を更新することはできません。値は、小数点以下第 2 位までの小数で指定します。クレジットは負の値として指定する必要があります。
プランに含まれているかどうか	省略可	プレースメントがプランに含まれているかどうか。値は次のいずれかを指定します（大文字と小文字は区別されません）。 Y（プレースメントはプランに含まれている） N（プレースメントはプランに含まれていない）
説明	省略可	プレースメントまたはプレースメント グループの説明（任意）。
キャンペーン マネージャー 360 プレースメント ID	読み込み時は無視	Planning のプレースメントのリンク先となるキャンペーン マネージャー 360 プレースメントの ID（ある場合）。
エラー	読み込み時は無視	読み込み時にその行で発生したエラーが記録されます。この列は、Planning によって入力されます。読み込み時は無視されます。