> ## Documentation Index > Fetch the complete documentation index at: https://docs.auxia.io/llms.txt > Use this file to discover all available pages before exploring further. # セクション5: Treatments 日本語版はAIによる翻訳です。正確な情報については[英語版](/guides/comprehensive/treatments)をご参照ください。 Treatmentは、Auxiaにおけるマーケティングの中核的な構成要素です。このセクションでは、Treatmentの作成、管理、最適化に関して知っておくべきすべてのことを説明します。 ## 5.1 Treatmentとは？ **Treatment**は、ユーザーに配信されるパーソナライズされたメッセージまたは体験です。各Treatmentは以下で構成されます： * **コンテンツ**：ユーザーが目にするもの（テキスト、画像、CTA） * **フォーマット**：表示方法（Treatment タイプ） * **配置**：表示場所（Surface） * **ターゲティング**：誰が見るか（Guardrails） * **コンテキスト**：いつ表示されるか（Journeyの割り当て） ### Treatmentの例 | Treatment | タイプ | Surface | Goal | | - | - | - | - | | 「おかえりなさい、`${name}`さん！」 | アプリ内メッセージ | ホーム画面 | 再エンゲージメント | | 「カートにアイテムがあります」 | プッシュ通知 | モバイル | カート回復 | | 「あなただけの新着商品」 | メール | 受信トレイ | 購買 | | 「プロフィールを完成させましょう」 | モーダル | プロフィールページ | アクティベーション | *** ## 5.2 Treatment Portfolio Treatment Portfolioは、すべてのTreatmentを管理するための中央ハブです。 ### Treatment Portfolioへのアクセス 1. サイドバーの**Treatments & Journeys**をクリック 2. **Treatment Portfolio**を選択 ### ポートフォリオビュー ポートフォリオには以下が表示されます： | カラム | 説明 | | - | - | | **Name** | Treatment名 | | **Journey** | 親Journey | | **Type** | Treatmentタイプ（バナー、モーダルなど） | | **Status** | Live、Paused、Draft | | **Created** | 作成日 | | **Modified** | 最終更新日 | ### Treatmentのフィルタリング フィルターを使用して特定のTreatmentを見つけることができます： | フィルター | オプション | | - | - | | **Status** | Live、Paused、Draft、All | | **Journey** | 特定のJourneyを選択 | | **Type** | Treatmentタイプでフィルタリング | | **Search** | 名前で検索 | ### クイックアクション ポートフォリオから以下の操作が可能です： * Treatmentを**クリック**して詳細を表示 * 編集アイコンで**編集** * ステータストグルで**Pause/Activate** * プレビューアイコンで**プレビュー** *** ## 5.3 Treatmentの作成 Treatmentの作成には5ステップのウィザードを使用します。 ### 作成の開始 1. Treatment Portfolioに移動 2. **+ Create Treatment**をクリック ### ステップ1：Journeyの選択 **目的：** すべてのTreatmentはJourneyに所属する必要があります。 **フィールド：** | フィールド | 説明 | 必須 | | - | - | - | | **Journey Type** | Evergreen（継続）またはBurst（期間限定） | はい | | **Journey** | 既存のJourneyを選択 | はい | **Journeyの選択：** **Evergreen Journey**の場合： * 1つまたは複数のEvergreen Journeyを選択 * Treatmentはそれらのjourney内で継続的に実行されます **Burst Journey**の場合： * 1つのBurst Journeyを選択 * TreatmentはJourneyの開始日/終了日を継承します **バリデーション：** * 少なくとも1つのJourneyを選択する必要があります * Burstの場合、期限切れのJourneyはフィルタリングされます > **ヒント：** 新しいJourneyが必要な場合は、まずJourney Portfolioで作成してください。 ### ステップ2：基本情報 **目的：** Treatmentの内容と表示場所を定義します。 **フィールド：** | フィールド | 説明 | 必須 | | - | - | - | | **Name** | 説明的な名前 | はい | | **Description** | 目的と詳細 | 推奨 | | **Target Action** | 期待するユーザーアクション | はい | | **Treatment Type** | フォーマット/テンプレート | はい | | **Surfaces** | Treatmentが表示される場所 | はい | **名前のベストプラクティス：** * 説明的に：「Welcome Back - Home Banner v2」 * Surfaceやタイプを含める：「Checkout Modal - Free Shipping」 * バージョンや日付を追加：「Holiday Sale 2026 - Push」 **説明のヒント：** * 目的を説明する * ターゲットオーディエンスを記載する * A/Bテストのコンテキストがあれば含める **Target Action：** 期待するユーザーアクションを選択します： * 商品を閲覧 * 購入する * プロフィールを完成させる * 機能を開く * など **Treatment Type：** 設定済みのタイプから選択します： * バナー * モーダル * アプリ内メッセージ * プッシュ通知 * メール * など > **注意：** Treatmentタイプは管理者によって設定されます。必要なタイプがない場合は管理者にお問い合わせください。 **Surfaces：** Treatmentを表示できる1つまたは複数のSurfaceを選択します： * ホーム画面 * 商品ページ * 購入手続き * など 複数のSurface = Treatmentが複数の場所に表示できます。 ### ステップ3：コンテンツ **目的：** ユーザーが実際に目にするものを定義します。 **フィールドはTreatmentタイプによって異なりますが、一般的に以下を含みます：** | フィールド | 説明 | 必須 | | - | - | - | | **Language** | コンテンツの言語 | はい | | **Title** | 見出し/ヘッダー | 通常はい | | **Body** | メインのメッセージテキスト | 通常はい | | **Image** | ビジュアルTreatment | 場合による | | **CTA Text** | ボタンのテキスト | 通常はい | | **CTA Action** | クリック時の動作 | 通常はい | **パーソナライゼーションの使用：** データフィールドを挿入してコンテンツをパーソナライズします： ``` Hello `${user_first_name}`! ``` **挿入方法：** 1. 変数を挿入したい場所にカーソルを置く 2. 「Insert Variable」オプションまたはアイコンを探す 3. 利用可能なデータフィールドから選択 4. プレースホルダーが挿入されます **利用可能なパーソナライゼーションオプションは、設定済みのデータフィールドによって異なります。** **画像の要件：** * ホストされている画像のURLを提供 * 画像がパブリックにアクセス可能であることを確認 * Treatmentタイプの解像度要件を確認 * プレビューで画像の読み込みをテスト **CTAの設定：** | CTA Action | 結果 | | - | - | | Open URL | ウェブリンクを開く | | Open Screen | アプリ内をナビゲート | | Dismiss | Treatmentを閉じる | | Custom | アプリ固有のアクション | ### ステップ4：Guardrailsとスケジューリング **目的：** Treatmentを受け取るユーザーと配信タイミングを制御します。 **Guardrails：** ユーザーがTreatmentを受け取るために満たすべき適格性ルールを定義します： | フィールド | 説明 | | - | - | | **Data Field** | 評価するユーザー属性またはイベント指標 | | **Condition** | 比較演算子（例：GREATER\_THAN、EQUALS） | | **Value** | 比較する閾値または値 | 複数のルールはANDロジックで結合されます — すべての条件を満たす必要があります。 **ブール条件：** 一部の条件は、値フィールドの代わりにチェックボックスを使用します。これはデータフィールドが設定されているか否かを確認します： | チェックボックスの状態 | 意味 | | - | - | | ✅ チェックあり（true） | フィールドに**値がある**（設定済み） | | ☐ チェックなし（false） | フィールドに**値がない**（null / 未設定） | > **例：** 特定のTreatmentを一度も受け取っていないユーザーにのみ配信する場合は、`last_timestamp` にブール条件を追加し、チェックボックスを**チェックなし**のままにします。これにより、そのTreatmentのタイムスタンプ記録がないユーザー（つまり、まだ受け取っていないユーザー）が対象になります。 **スケジューリング：** | フィールド | 説明 | 必須 | | - | - | - | | **Start Date** | Treatmentの配信開始日 | はい | | **End Date** | Treatmentの配信終了日 | いいえ（終了日なしの場合は未設定） | > **ヒント：** Burst Journeyの場合、TreatmentのスケジュールはJourneyの開始日と終了日の範囲内である必要があります。 ### ステップ5：確認と作成 **目的：** 作成前にすべてを確認します。 **確認チェックリスト：** * [ ] 正しいJourneyが選択されている * [ ] 名前が説明的で正確 * [ ] Treatmentタイプが意図したフォーマットと一致 * [ ] 正しいSurfaceが選択されている * [ ] コンテンツが完成しスペルチェック済み * [ ] パーソナライゼーション変数が正しい * [ ] CTAアクションが適切 * [ ] Guardrailsが正しく設定されている * [ ] スケジュールの開始日/終了日が正しい **Treatmentの作成：** 1. **Create Treatment**をクリック 2. Treatmentは**Draft**ステータスで保存されます 3. アクティベーションまたは編集の続行に移動 *** ## 5.4 Treatmentの編集 ### 編集モードへのアクセス **方法1：** ポートフォリオでTreatment名をクリックし、**Edit**を選択 **方法2：** ポートフォリオで編集アイコンを直接クリック ### 編集可能な項目 | フィールド | 編集可能 | 備考 | | - | - | - | | Name | はい | いつでも更新可能 | | Description | はい | いつでも更新可能 | | Content | はい | Active状態の場合、変更は即座に反映されます | | Journey | はい | 再割り当て可能 | | Treatment Type | 制限あり | 再作成が必要な場合があります | | Surfaces | はい | いつでも更新可能 | ### バージョニング Auxia ConsoleはTreatmentのバージョンを追跡します： * 保存するたびにバージョンが作成されます * バージョン履歴を確認できます * 以前のバージョンは保持されます ### LiveなTreatmentの編集 > **警告：** LiveなTreatmentを編集すると、ユーザーに表示される内容が即座に更新されます。 **ベストプラクティス：** 1. まずTreatmentをPauseする（大きな変更の場合） 2. 変更を行う 3. 変更をプレビューする 4. 準備ができたら再アクティベーションする ### バージョンセレクター 複数のバージョンを持つTreatmentの場合： 1. Treatmentの詳細を開く 2. バージョンセレクターのドロップダウンを探す 3. 表示するバージョンを選択 4. 必要に応じてバージョンを比較 *** ## 5.5 Treatmentのプレビュー プレビューでは、アクティベーション前にTreatmentの表示を確認できます。 ### プレビューへのアクセス 1. ポートフォリオからTreatmentを開く 2. **Preview**ボタンをクリック 3. またはポートフォリオリストのプレビューアイコンを使用 ### プレビューモード | モード | 表示内容 | | - | - | | **Visual Preview** | Treatmentの近似レンダリング | | **Content Preview** | すべてのコンテンツフィールドと値 | | **JSON Preview** | Treatmentの生データ | ### 制限事項 プレビューは近似的なものです： * 実際のレンダリングはアプリの実装に依存します * パーソナライゼーションはプレースホルダーまたはサンプル値を表示します * 一部のインタラクティブ要素は動作しない場合があります > **ヒント：** 正確なテストには、実際のQAユーザーでQA Testingを使用してください。 *** ## 5.6 一括アップロード 一括アップロードでは、CSVファイルを使用して複数のTreatmentを一度に作成できます。 ### 一括アップロードへのアクセス 1. Treatment Portfolioに移動 2. **Bulk Upload**ボタン（またはタブ）をクリック ### 一括アップロードの手順 **ステップ1：テンプレートのダウンロード** 1. 「Download Template」をクリック 2. テンプレートにはすべての必須カラムが含まれています 3. ExcelまたはGoogleスプレッドシートで開く **ステップ2：テンプレートの入力** 必須カラムは異なりますが、通常以下を含みます： | カラム | 説明 | | - | - | | name | Treatment名 | | journey\_id | 親JourneyのID | | treatment\_type\_id | TreatmentタイプのID | | surface\_ids | カンマ区切りのSurface ID | | content\_\* | コンテンツフィールド（タイプにより異なる） | **ステップ3：ファイルのアップロード** 1. 「Upload」をクリックまたはドラッグ&ドロップ 2. システムがファイルを検証 3. 検証結果を確認 **ステップ4：確認と作成** 1. 作成されるTreatmentを確認 2. バリデーションエラーを修正 3. 「Create All」をクリックしてTreatmentを作成 ### バリデーションエラー よくあるエラー： | エラー | 原因 | 修正方法 | | - | - | - | | Invalid journey\_id | Journeyが存在しない | IDが正しいか確認 | | Missing required field | カラムが空 | 必須データを入力 | | Invalid treatment\_type | タイプが存在しない | 有効なタイプIDを使用 | ### 一括アップロードのヒント * 大量アップロードの前に、まず2〜3件のTreatmentでテスト * CSVのバックアップを保持 * 参照にはIDを使用（名前ではなく） * 問題を引き起こす可能性のある特殊文字を確認 *** ## 5.7 Sparks（AIレコメンデーション） Sparksは、Treatment作成時にAI駆動のレコメンデーションを提供します。 ### Sparksとは？ Sparksは、Treatmentを分析して以下を提案します： * 改善された見出し * より効果的なCTA * パーソナライゼーションの機会 * コンテンツの最適化 ### Sparksの使用方法 1. Treatment作成中（ステップ3） 2. Sparksパネルまたはアイコンを探す 3. 提案を確認 4. クリックして適用または却下 ### Sparksの種類 | Sparksの種類 | 提案内容 | | - | - | | **Headline** | 代替タイトルオプション | | **CTA** | より効果的なボタンテキスト | | **Personalization** | データフィールドを追加する場所 | | **Content** | コピーの改善 | ### フィードバックの提供 以下の方法でSparksの改善にご協力ください： 1. 提案に対して高評価/低評価をクリック 2. フィードバックダイアログを使用 3. どの提案が役立ったかを記録 > **注意：** Sparksの利用可否はConsoleの設定によって異なります。 *** ## 5.8 Treatmentステータスの管理 ### ステータスの定義 | ステータス | 意味 | ユーザーへの表示 | | - | - | - | | **Draft** | 作成済み、未アクティベート | なし | | **Live** | 稼働中、ユーザーに配信中 | あり | | **Paused** | 一時停止中 | なし | | **Archived** | 使用終了 | なし | ### ステータスの変更 **Activateする場合：** 1. Treatmentを開く 2. すべての必須フィールドが入力済みであることを確認 3. ステータスをLiveに変更 4. アクティベーションを確認 **Pauseする場合：** 1. Treatmentを開く 2. ステータスをPausedに変更 3. Treatmentの配信が即座に停止 **Archiveする場合：** 1. Treatmentを開く 2. Archiveオプションを選択 3. TreatmentがArchivedステータスに移行 ### ステータスの依存関係 Treatmentが実際に配信されるためには： 1. TreatmentのステータスがLiveであること 2. 親JourneyのステータスがLiveであること 3. ユーザーがGuardrailsを満たしていること 4. Surfaceがアプリ内でLiveであること *** ## 5.9 Guardrails Guardrailsは、どのユーザーがTreatmentを受け取れるかを制御します。 ### Guardrailsとは？ ユーザーがTreatmentを見るために満たす必要のある条件です： * ユーザー属性条件 * 行動条件 * コンテキスト条件 ### ルールの例 | ルール | 対象ユーザー | | - | - | | subscription\_tier = "Premium" | プレミアムサブスクライバーのみ | | days\_since\_signup \< 7 | 過去1週間以内にサインアップしたユーザー | | cart\_items > 0 | カートにアイテムがあるユーザー | | last\_purchase\_days > 30 | 30日以上購入していないユーザー | ### ブール条件 一部のフィールドは**ブール条件**を使用します。値フィールドの代わりにチェックボックスで、対象ユーザーにそのフィールドが存在するか否かを確認します。 | チェックボックスの状態 | 意味 | | - | - | | ✅ チェックあり（true） | フィールドに**値がある**（設定済み） | | ☐ チェックなし（false） | フィールドに**値がない**（null / 未設定） | **よくある使用例：** 特定のTreatmentをまだ受け取っていないユーザーのみを対象にする。`last_timestamp` にブール条件を追加し、チェックボックスを**チェックなし**にすることで、タイムスタンプ記録がないユーザー（まだそのTreatmentを見ていないユーザー）に絞り込める。 ### ユーザーにフィールドの値がない場合 ユーザー属性に対するルールは、その属性の値を持つユーザーに対してのみ評価できます。値を持たないユーザーの扱いは、ルールの下にあるチェックボックス **OR "\<フィールド>" が定義されていない** で決まります。これは上記のブール条件とは別の設定です。ブール条件はフィールドが設定されているかどうか自体を判定するルールであり、こちらはルールに必要なフィールドが欠けている場合の扱いを決めます。 | チェックボックス | フィールドの値がないユーザー | | - | - | | オフ（デフォルト） | 他のルールに関係なく、Treatmentの対象外になります | | オン | このルールは満たされたものとして扱われ、残りのルールが対象かどうかを判断します | **例：** ルール `country` *is not any of* `AF, BY, CN` は、該当する国のユーザーにTreatmentを配信しないためのものです。`country` の値がまったくないユーザーは、チェックボックスがオフの間は対象外になります。チェックボックスをオンにすると、そのユーザーは対象のまま残り、許可された国のユーザーと同じように残りのルールで判断されます。 このオプションはユーザー属性フィールドにのみ存在します。イベントベースのルールやTreatmentインタラクションのルールには、値がない状態はありません。[一括CSVアップロード](/ja/bulk-upload/csv-field-reference)では、同じ設定が `Apply qualification N if attribute not available` 列に対応します。コンセプトの概要は[ガードレール](/ja/concepts/guardrails)を参照してください。 ### ルールの設定 Guardrailsは通常以下の方法で設定されます： * Treatment作成中に設定 * または事前に定義されたオーディエンスセグメントから選択 > **注意：** ルールの設定オプションはConsoleのセットアップによって異なります。利用可能なルールについては管理者にお問い合わせください。 ### ルールのテスト QA TestingでGuardrailsを検証できます： 1. 特定の属性を持つQAユーザーを設定 2. Treatmentが表示されるSurfaceをトリガー 3. Treatmentが正しく表示される/されないことを確認 *** ## 5.10 Treatmentのベストプラクティス ### 命名規則 一貫した命名パターンを採用しましょう： ``` [Surface] - [Content Theme] - [Audience] - [Version/Date] ``` 例： * 「Home - Welcome Back - Returning Users - v2」 * 「Checkout - Free Shipping - New Users - Jan 2026」 ### ローンチ前のテスト 1. プレビューでコンテンツを確認 2. 実際のアプリでQAユーザーでテスト 3. 該当する場合、異なるデバイスで検証 4. パーソナライゼーションが正しくレンダリングされることを確認 ### 最適化サイクル 1. 初期バージョンのTreatmentを**ローンチ** 2. 1〜2週間パフォーマンスを**モニタリング** 3. 指標を**分析**（CTR、コンバージョン） 4. データに基づいて**改善** 5. サイクルを**繰り返す** *** ## 5.11 Treatmentに関するよくある問題 ### Treatmentが表示されない **チェックリスト：** * [ ] TreatmentのステータスがLive * [ ] JourneyのステータスがLive * [ ] ユーザーがGuardrailsを満たしている * [ ] Surfaceが正しく設定されている * [ ] 技術的な配信の問題がない ### コンテンツが正しくレンダリングされない * 画像URLがアクセス可能か確認 * パーソナライゼーションフィールドがユーザーに存在するか確認 * QAユーザーでテストして問題を特定 * Treatmentタイプの設定を確認 ### 変更が反映されない * 更新が反映されるまで時間を置く * テストアプリのキャッシュをクリア * 変更を保存したことを確認 * 正しいバージョンを確認しているか確認 *** ## 次のセクション [セクション6: 分析](/ja/guides/comprehensive/analytics) に進んで、分析の詳細なドキュメントをご覧ください。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.