メインコンテンツへスキップ
日本語版はAIによる翻訳です。正確な情報については英語版をご参照ください。
CSVテンプレートへの入力が完了したら、Upload and Validate（アップロードと検証）タブでファイルをアップロードします。データを検証してエラーを確認し、トリートメント（施策）を作成します。

​
アップロードプロセスの概要

アップロードプロセスは、主に次の3つのステップで構成されています。
  1. CSVファイルのアップロード：入力済みのCSVファイルを選択してアップロードします
  2. 検証：システムがCSV内のすべてのデータを検証します
  3. 確認と作成：検証結果を確認し、アップロードを確定します

​
ステップ1：CSVファイルのアップロード

​
アップロードタブへのアクセス

  1. 管理（Manage）＞ トリートメント（Treatments）＞ 一括アップロード（Bulk Upload）に移動します
  2. Upload and Validateタブをクリックします
  3. Upload CSV（CSVをアップロード）ボタンをクリックするか、ファイルをドラッグ＆ドロップします

​
ファイル要件

  • 形式：CSV（カンマ区切り値）
  • エンコーディング：UTF-8
  • 最大行数：100トリートメント（ヘッダー行1行とオプションのドキュメント行を除く）
CSVファイルは、プロジェクト用に生成されたテンプレートの構造と完全に一致する必要があります。古いテンプレートや手動で作成したCSVを使用すると、検証エラーが発生する可能性があります。

​
ステップ2：検証

CSVファイルをアップロードすると、システムが自動的に次の項目を検証します。
  • ヘッダー検証
    • すべての必須カラムが存在すること
    • 余分なカラムが追加されていないこと
    • カラム名がテンプレートと完全に一致すること（大文字・小文字を含む）
  • 行構造の検証
    • カラム数がヘッダー行と一致すること
    • トリートメント行の数が100を超えていないこと
    • 余分なカラムを持つ行がないこと
  • データ検証 各トリートメント行について、システムは次の項目をチェックします。
    • 必須フィールド
      • Treatment type が空でないこと
      • Name が空でないこと（最大100文字）
      • Description が空でないこと
      • Start timestamp が空でなく、有効なUTC形式であること
      • Target action が空でないこと（プロジェクト設定で必須の場合）
      • Surfaces が空でないこと
    • フィールド形式の検証
      • タイムスタンプ：有効なUTC形式であること
      • タグ：セミコロン区切りで、すべてのタグがプロジェクト内に存在すること
      • ターゲットアクション：イベントが存在し、プロパティがイベント定義と一致すること
      • サーフェス：セミコロン区切りで、すべてのサーフェスがトリートメントタイプに関連付けられていること
      • 相互排他グループ（MEG）：プロジェクト内に存在すること
      • コンテンツフィールド：最大文字数制限を超えていないこと
    • 配信対象条件の検証 各配信対象条件（番号1、2、3…）について、次の項目を検証します。
      • Qualification field：プロジェクト内に存在するか、有効な自己参照トリートメントインタラクション（形式：InteractionType_(THIS_TREATMENT)_TimeWindow）であること
      • Qualification condition：データフィールドの型に対して有効であること
      • Qualification value：条件に対して期待される形式と一致すること
      • Apply qualification if attribute not available：ユーザー属性のデータフィールドに対してのみ有効。TRUE、FALSE、または空欄であること

​
ステップ3：検証結果の確認

検証が完了すると、次のいずれかの結果が表示されます。

​
成功：エラーなし

検証に合格した場合は、次のようになります。
  • プレビューテーブルに作成されるすべてのトリートメントが表示されます
  • Confirm Upload（アップロードを確定）ボタンが有効になります
プレビューテーブルには、次の項目が表示されます。
  • トリートメント名
  • 説明
  • 開始/終了タイムスタンプ
  • タグ
  • 配信対象条件
  • その他の設定済みフィールド

​
失敗：検証エラー

検証に失敗した場合は、次のようになります。
  • エラーテーブルにすべての検証エラーが表示されます
  • Re Upload（再アップロード）ボタンが表示されます

​
エラーテーブルのカラム

​
エラータイプ

  • MISSING_REQUIRED_FIELD：必須フィールドが空です
  • INVALID_FORMAT：データ形式が正しくありません
  • INVALID_TIMESTAMP：タイムスタンプ形式が無効です
  • INVALID_VALUE：値が制約を満たしていません（無効な条件を含む）
  • INVALID_TAG：タグがプロジェクト内に存在しません
  • TARGET_ACTION_NOT_FOUND：ターゲットアクションのイベントが存在しません
  • SURFACE_NOT_AVAILABLE_FOR_TREATMENT_TYPE：サーフェスがこのトリートメントタイプに対して無効です
  • MUTUAL_EXCLUSION_GROUP_NOT_FOUND：MEGが存在しません
  • DATA_FIELD_NOT_FOUND：データフィールドIDが存在しません

​
ステップ4：エラーの修正と再アップロード

検証に失敗した場合は、次の手順で対応します。
  1. 元のCSVファイルを開きます
  2. エラーメッセージに基づいてエラーを修正します
    • 指定された行とカラムに移動します
    • 問題を修正します（正しい形式についてはCSVフィールドリファレンスをご参照ください）
    • ファイルを保存します
  3. 修正したCSVファイルを再アップロードします
  4. 検証が再度完了するまで待ちます
再アップロードする前にすべてのエラーを修正してください。システムは毎回ファイル全体を再検証します。

​
よくある修正

  • タイムスタンプエラー
    • エラー：「Start timestamp must be in UTC format」
    • 修正：MM/dd/yyyy hh:mm a の形式を使用してください
    • 例
  • タグエラー
    • エラー：「Tag ‘promo’ does not exist in the project」
    • 修正：先にAuxiaコンソールでタグを作成するか、既存のタグを使用してください
  • ターゲットアクションエラー
    • エラー：「Event ‘purchase’ does not have property ‘category’」
    • 修正：イベント名とプロパティ名がプロジェクトと完全に一致しているか確認してください
    • 例
  • データフィールドエラー
    • エラー：「Data field with ID 99999 not found」
    • 修正：管理 ＞ Data（データ）＞ データフィールド（Data Fields）で、データフィールドIDが存在するか確認してください
  • 無効な自己参照トリートメントインタラクション
    • エラー：「Invalid treatment data field value」
    • 修正：正しい形式（InteractionType_(THIS_TREATMENT)_TimeWindow）を使用してください
    • 概要：この特定のトリートメントに対するユーザーインタラクション（クリック、閲覧など）を追跡する特殊なデータフィールドです。
    • 例
  • データ欠落時の動作エラー
    • エラー：「Data missing behaviour can only be set for User Attribute data fields」
    • 修正：「Apply qualification N if attribute not available」フィールドは、ユーザー属性データフィールドに対してのみ設定してください。自己参照トリートメントインタラクションフィールドやイベントベースのフィールドには設定しないでください。

​
ステップ5：アップロードの確定

検証にエラーなく合格した場合は、次の手順で確定します。
  1. プレビューテーブルを確認して、すべてのトリートメントが正しいことを確認します
  2. Confirm Uploadボタンをクリックします
  3. 作成の完了を待ちます

​
アップロードの進行状況

  • 進行状況バーに完了率が表示されます
  • トリートメントが作成されるとステータスが更新されます
  • 推定残り時間が表示されます
アップロード中は、ブラウザーのタブを閉じたり、別のページに移動したりしないでください。プロセスが中断される可能性があります。

​
アップロード結果

アップロードが完了すると、次の結果が表示されます。

​
成功サマリー

  • 正常に作成されたトリートメントの数
  • 割り当てられたトリートメントID
  • アップロード完了のタイムスタンプ

​
部分的な成功/失敗

作成中に一部のトリートメントが失敗した場合は、次の情報が表示されます。
  • 成功したトリートメントの数
  • 失敗したトリートメントの数
  • Download Results（結果をダウンロード）ボタンで、どのトリートメントが失敗したか、その理由を確認できます

​
アップロードを成功させるためのヒント

  1. 少量から始める：大量のバッチをアップロードする前に、まず5〜10件のトリートメントでテストしてください
  2. 早めに検証する：テンプレートを生成したら、1行だけ入力して形式が正しいか検証してください
  3. バックアップを保持する：変更を加える前にCSVのコピーを保存してください
  4. すべてのエラーを修正する：検証エラーが残っているとアップロードできないため、無視しないでください
  5. 前提条件を確認する：アップロード前にタグ、MEG、イベントが存在することを確認してください
  6. 正確な名前を使用する：フィールド値は大文字・小文字が区別されるため、完全に一致させてください
  7. ドキュメント行：先頭のドキュメント行は残しても削除しても問題ありません
  8. 生成されたテンプレートを使用する：最新のカラムヘッダーを使うために、常に新しく生成したテンプレートから始めてください
次のステップ：過去のアップロードとその結果を確認するには、一括アップロード履歴をご覧ください。