日本語版はAIによる翻訳です。正確な情報については英語版をご参照ください。
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_jabody_en,body_jacta_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)
- CSVでの入力:
- 対応するインタラクションタイプ
Sent:トリートメントがユーザーに送信されたViewed:ユーザーがトリートメントを閲覧したClicked:ユーザーがトリートメントをクリックしたSnoozed:ユーザーがトリートメントをスヌーズしたDismissed:ユーザーがトリートメントを閉じたCta_completed:ユーザーがCTAを完了したSwipe:ユーザーがトリートメントをスワイプした
- 対応するタイムウィンドウ
- 通常のデータフィールド(IDで指定)
-
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:リストが指定リスト内のいずれの値も含まない
-
INTEGERおよびDOUBLEの場合
-
Qualification value N
- 説明:比較対象の値。形式は条件とデータフィールドの型によって異なります。
-
Apply qualification N if attribute not available
- 型:String (Boolean)
- 必須:いいえ(ユーザー属性データフィールドの場合のみ適用)
- 説明:ユーザー属性データフィールドのデータが欠落または利用不可の場合の動作を制御します
- 有効な値
TRUE:属性が欠落している場合、配信対象条件を満たしたものとして扱いますFALSE:属性が欠落している場合、配信対象条件を満たしていないものとして扱います- 空欄:
FALSEと同じ(デフォルト)
- 重要事項
- このフィールドはユーザー属性データフィールド(ユーザープロパティに基づくデータフィールド)にのみ適用されます
- 自己参照トリートメントインタラクションフィールドやイベントベースのフィールドには設定できません
- 非ユーザー属性フィールドにこの値を設定しようとすると、検証に失敗します
- シナリオ例
country=USのユーザーをターゲットにしていて、一部のユーザーに国情報がない場合は、次のようになります。FALSEに設定:国情報のないユーザーは、他の条件を満たしていてもトリートメントを受け取りませんTRUEに設定:国情報のないユーザーは、他の条件を満たしていればトリートメントを受け取ります
次のステップ:CSVへの入力が完了したら、アップロードと検証に進み、検証ルールとエラーのトラブルシューティングを確認して、ファイルをアップロードしてください。