メインコンテンツへスキップ
日本語版はAIによる翻訳です。正確な情報については英語版をご参照ください。
このページでは、一括アップロード用CSVテンプレートの各カラムについて詳しく説明します。

1. 基本フィールド

  • External treatment ID
    • 型:String
    • 必須:いいえ
    • 説明:他のシステムとの連携用の外部識別子
    • 備考
      • プロジェクト設定で有効にしている場合のみ利用可能です
      • 指定する場合、プロジェクト内で一意である必要があります
  • Tags
    • 型:String
    • 必須:いいえ
    • 説明:トリートメント(施策)の整理・分類用のタグ
    • 形式:複数のタグを区切るにはセミコロン(;)を使用します
    • 書式ルール
      • タグの区切りにはセミコロン(;)を使用します
      • セミコロンの後にスペースを入れないでください
      • セミコロン間に空の値を残さないでください
      • タグでは大文字と小文字が区別されます
    すべてのタグは、一括アップロードで使用する前にプロジェクト内に存在している必要があります。必要に応じて、先にAuxiaコンソールでタグを作成してください。
  • Treatment type*
    • 型:String
    • 必須:はい
    • 説明:このトリートメントのトリートメントタイプ
    • 例:POPUP_BANNER, PUSH_NOTIFICATION
    • 備考
      • トリートメントタイプはすでに存在している必要があります
      • 1つのCSV内のすべてのトリートメントは、同じトリートメントタイプである必要があります
  • Target action(ターゲットアクション)
    • 型:String
    • 形式
      • 基本イベント
        • 特定のプロパティ要件がないイベントの場合
        • 構文:EventName
        • 例:purchase
      • プロパティ付きイベント
        • 特定のプロパティ値が必要なイベントの場合
        • 構文:EventName (PropertyName1: PropertyValue1 ; PropertyName2: PropertyValue2)
        • 単一プロパティの例:purchase (product_type: premium)
        • 複数プロパティの例:level_end (level_number: 5 ; result: success ; difficulty: hard)
    • 重要事項
      • イベント名はプロジェクト内に存在している必要があります
      • プロパティ名はイベントのプロパティ定義と完全に一致する必要があります
      • プロパティ値はそのプロパティの既存の値と完全に一致する必要があります
      • 指定するすべてのプロパティはそのイベントに存在している必要があります
  • Name*
    • 型:String
    • 必須:はい
    • 説明:Auxiaコンソールに表示されるトリートメント名
  • Description*
    • 型:String
    • 必須:はい
    • 説明:トリートメントの目的に関する詳細な説明
  • サーフェス(Surfaces)*
    • 型:String(セミコロン区切り)
    • 必須:はい
    • 説明:このトリートメントに含めるサーフェス(表示面)
    • 形式:複数のサーフェスを区切るにはセミコロン(;)を使用します
    • 備考
      • トリートメントタイプに関連付けられたサーフェスのみ指定できます
      • 少なくとも1つのサーフェスを指定する必要があります
      • サーフェス名は既存のサーフェスと完全に一致する必要があります
  • MEG
    • 型:String
    • 必須:いいえ
    • 説明:相互排他グループ(MEG)名
    • 例:holiday_promotions
相互排他グループ(MEG)は、一括アップロードで使用する前にプロジェクト内に存在している必要があります。必要に応じて、先にAuxiaコンソールでMEGを作成してください。

2. 配信スケジュール

  • Start timestamp*
    • 型:Timestamp (UTC)
    • 必須:はい
    • 説明:トリートメントが有効になる日時
    • 形式:MM/dd/yyyy hh:mm a
    • 例:06/01/2024 12:00 AM
    • 備考
      • UTCタイムゾーンで指定する必要があります
      • AM/PM付きの12時間形式を使用してください
      • 月と日はゼロ埋め形式にしてください(例:1 ではなく 01)
  • End timestamp
    • 型:Timestamp (UTC)
    • 必須:いいえ
    • 説明:トリートメントの有効期限
    • 形式:MM/dd/yyyy hh:mm a
    • 例:12/31/2024 11:59 PM
    • 備考
      • UTCタイムゾーンで指定する必要があります
      • AM/PM付きの12時間形式を使用してください
      • 指定しない場合、トリートメントは無期限に配信されます

3. コンテンツフィールド

コンテンツフィールドはトリートメントタイプによって異なり、次の2つのカテゴリーに分類されます。
  • 言語非依存フィールド すべての言語に共通して適用されるフィールドです。
    • カラム名:field_name
    • 例:image_url, deep_link
  • 言語固有フィールド 言語ごとに異なるコンテンツを持つフィールドです。
    • カラム名:field_name_languagecode
    • 例
      • title_en, title_ja
      • body_en, body_ja
      • cta_text_en, cta_text_ja
    備考
    • 各フィールドには最大文字数制限があります(トリートメントタイプとフィールドによって異なります)
    • 文字数制限を超えると検証エラーが発生します

4. 配信対象条件

配信対象条件は、トリートメントの配信対象となるユーザーを決めるものです。各配信対象条件は4つのカラムで定義されます。
  • カラムパターン 配信対象条件番号N(N = 1、2、3…)ごとに、次のカラムがあります。
  • Qualification field N
    • 説明:配信対象かどうかを判定するためにチェックするデータフィールド。次の2つのタイプのいずれかです。
    • タイプ
      • 通常のデータフィールド(IDで指定)
        • プロジェクトの数値データフィールドIDを使用します
        • 例:12345
      • 自己参照トリートメントインタラクション
        • 概要:現在作成中のトリートメントに対するユーザーのインタラクションを追跡する特殊なデータフィールドです
        • 形式:InteractionType_(THIS_TREATMENT)_TimeWindow
        • 注意:(THIS_TREATMENT) は作成中のトリートメントを自動的に参照するプレースホルダーです
        • 例:トリートメントの表示頻度を制限する場合
          • CSVでの入力:Sent_(THIS_TREATMENT)_last_1d、条件 is less than、値 2
          • Auxiaコンソールでの表示:auxia_treatment_sent treatment_id:12345 last_1d<2(12345はトリートメントID)
        • 対応するインタラクションタイプ
          • Sent:トリートメントがユーザーに送信された
          • Viewed:ユーザーがトリートメントを閲覧した
          • Clicked:ユーザーがトリートメントをクリックした
          • Snoozed:ユーザーがトリートメントをスヌーズした
          • Dismissed:ユーザーがトリートメントを閉じた
          • Cta_completed:ユーザーがCTAを完了した
          • Swipe:ユーザーがトリートメントをスワイプした
        • 対応するタイムウィンドウ
  • Qualification condition N
    • 説明:使用する比較演算子。有効な条件はデータフィールドの型によって異なります。
    • 型ごとの条件
      • INTEGERおよびDOUBLEの場合
        • is:等しい
        • is not:等しくない
        • is greater than:より大きい
        • is at least:以上
        • is less than:より小さい
        • is at most:以下
        • is any of:リスト内のいずれかの値に一致
        • is not any of:リスト内のいずれの値にも一致しない
        between 条件はサポートされていません。代わりに、最小値に is at least を使用する条件と、最大値に is at most を使用する条件の2つの配信対象条件を別々に作成してください。
      • STRINGの場合
        • is:完全に一致
        • is not:一致しない
        • contains:部分文字列を含む
        • does not contain:部分文字列を含まない
        • is any of:リスト内のいずれかの値に一致
        • is not any of:リスト内のいずれの値にも一致しない
      • BOOLEANの場合
        • is:等しい(trueまたはfalse)
      • TIMESTAMP_SECONDSの場合
        • at or before:指定タイムスタンプ以前
        • at or after:指定タイムスタンプ以降
        • is older than:現在時刻から指定期間を引いた時刻より前
        • > current time minus:現在時刻から指定期間を引いた時刻より後
        • has happened:イベントが発生した(値:true)か発生していない(値:false)かを確認
      • INTEGER_LIST、DOUBLE_LIST、STRING_LISTの場合
        • contains:リストが値を含む
        • does not contain:リストが値を含まない
        • contains any of:リストが指定リスト内のいずれかの値を含む
        • does not contain any of:リストが指定リスト内のいずれの値も含まない
  • Qualification value N
    • 説明:比較対象の値。形式は条件とデータフィールドの型によって異なります。
  • Apply qualification N if attribute not available
    • 型:String (Boolean)
    • 必須:いいえ(ユーザー属性データフィールドの場合のみ適用)
    • 説明:ユーザー属性データフィールドのデータが欠落または利用不可の場合の動作を制御します
    • 有効な値
      • TRUE:属性が欠落している場合、配信対象条件を満たしたものとして扱います
      • FALSE:属性が欠落している場合、配信対象条件を満たしていないものとして扱います
      • 空欄:FALSE と同じ(デフォルト)
    • 重要事項
      • このフィールドはユーザー属性データフィールド(ユーザープロパティに基づくデータフィールド)にのみ適用されます
      • 自己参照トリートメントインタラクションフィールドやイベントベースのフィールドには設定できません
      • 非ユーザー属性フィールドにこの値を設定しようとすると、検証に失敗します
    • シナリオ例 country = US のユーザーをターゲットにしていて、一部のユーザーに国情報がない場合は、次のようになります。
      • FALSE に設定:国情報のないユーザーは、他の条件を満たしていてもトリートメントを受け取りません
      • TRUE に設定:国情報のないユーザーは、他の条件を満たしていればトリートメントを受け取ります

次のステップ:CSVへの入力が完了したら、アップロードと検証に進み、検証ルールとエラーのトラブルシューティングを確認して、ファイルをアップロードしてください。