> ## 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.

# QAテスト（表示と配信の確認）

> [!NOTE]
>
> 日本語版はAIによる翻訳です。正確な情報については[英語版](https://docs.auxia.io/guides/quick-start/qa-testing.md)をご参照ください。

トリートメント（施策）を公開する前に、「正しく表示されるか」と「正しいユーザーに届くか」の2点を確認します。このガイドでは、その両方の確認方法を説明します。

## 事前準備

次の項目を準備してください。

* [ ] Auxiaコンソールにアクセスできる
* [ ] トリートメントが1つ以上作成されている（下書きまたは公開済み）
* [ ] テスト用のユーザーIDがある（連携で使用しているユーザー識別子）

***

## AuxiaでのQAの考え方

AuxiaのQAは、従来のマーケティングツールとは少し仕組みが異なります。一般的なツールでは、プレビューやテスト送信で確認することが多いです。一方、Auxiaのトリートメントはパーソナライズされ、配信条件があり、AIによって選択されます。そのため確認すべき内容が多く、QAはより明確に分かれています。

AuxiaのQAは、大きく2種類に分かれます。

| 種類 | 確認内容 | 実施タイミング |
| - | - | - |
| **表示確認（Rendering QA）** | トリートメントの見た目や内容が正しいか | 新規トリートメント、コンテンツ更新、画像変更時 |
| **ガードレール確認（Guardrail QA）** | 正しい条件で正しいユーザーに届くか | 新規リリース、配信対象条件の変更、設定変更時 |

> [!TIP]
>
> 初回リリース時は、両方を実施してください。コンテンツのみの更新では、多くの場合、表示確認だけで十分です。

***

## 表示確認：見た目をチェックする

### ステップ1：QAユーザーの設定

QAユーザーは、テスト用のユーザーアカウントです。QAユーザーには通常の配信条件が適用されず、割り当てられたトリートメントが必ず配信されます。トリートメントが下書きや一時停止中でも配信されます。

1. 「**トリートメントとジャーニー**（Treatments & Journeys）＞ **QAとテスト**（QA & Testing）」に移動する
2. **User Configuration**（ユーザー設定）タブの **Add QA Users**（QAユーザーを追加）をクリックする
3. QAユーザーのユーザーIDを入力する（ユースケースのユーザー識別子と一致させること）
4. 必要に応じて、QAテスター名やタグを追加する
5. 各ユーザーに、特定のトリートメントを優先順位付きで割り当てる
6. **保存**（Save）をクリックする

> [!WARNING]
>
> 設定の反映には最大5分かかります。一度に追加、リセット、または割り当てできるのは最大100ユーザーです。

**知っておくと便利な点：**

* 下書き・一時停止中のトリートメントでもQAできる
* 配信条件は無視される
* ユーザーにデータがない場合、変数がそのまま表示される（例：`${personalization_field_1}`）

### テスト配信

表示方法は、サーフェス（表示面）によって異なります。

**アプリ内／ウェブのサーフェス（バナー、カルーセル、アプリ内メッセージ）：**

手動操作は不要です。QAユーザーを設定すると、そのユーザーがアプリ内またはウェブのサーフェスに移動したときに自動で表示されます。

**アプリ外の配信（メール、プッシュ通知）：**

手動で配信を実行する必要があります。

1. **QAとテスト** 内の **テストアセット**（Test Treatments）をクリックする
2. QAユーザーIDを入力する（ステップ1のユーザーIDと一致させること）
3. 必要に応じて、コンテキスト属性を設定する
4. 最大トリートメント数を設定する（最大10件）
5. 右下の **Run Treatment Test**（テストを実行）をクリックする
6. ステータスが「成功」と表示されれば、配信は完了です

### 表示内容の確認

対象のサーフェスで、次の項目を確認します。

**メール：**

* [ ] 各メールクライアント（Gmail、Outlook、Apple Mail）で正しく表示されるか確認する
* [ ] パーソナライズフィールドに正しいデータが表示されているか確認する（`${field_name}`のような変数が表示されている場合、そのユーザーにはそのフィールドのデータがありません）
* [ ] 画像が表示されるか確認する
* [ ] リンクやCTAの遷移先が正しいか確認する
* [ ] 配信停止リンクが機能するか確認する

**プッシュ通知：**

* [ ] QAデバイスに配信されているか確認する
* [ ] タイトル、本文、画像が正しく表示されているか確認する
* [ ] タップ時のディープリンクが正しいページを開くか確認する

**アプリ内／ウェブバナー：**

* [ ] ページの正しい位置に表示されているか確認する
* [ ] 各画面サイズ（モバイル、タブレット、デスクトップ）で正しく表示されるか確認する
* [ ] 閉じる動作が正しく機能するか確認する
* [ ] クリック時の遷移先が正しいか確認する

***

## ガードレール確認：対象ユーザーをチェックする

ガードレール（配信条件）によって、正しいユーザーが配信対象になっているかを確認します。

### 配信対象の確認

配信対象の確認では、特定のユーザーが配信条件に基づいてトリートメントの配信対象になるかを確かめます。

1. **トリートメントとジャーニー** ページで、対象のトリートメントに移動する
2. **適格性テスト**（Test Eligibility）をクリックする
3. ユーザーIDを入力する
4. **Test**（テスト）をクリックする。ユーザーが配信対象になるかどうかと、その理由が表示されます

**確認すべき内容：**

* **対象になるユーザーで確認する**：配信対象になるはずのユーザーで確認します
* **対象外のユーザーで確認する**：配信対象外のはずのユーザーで確認します
* **境界値で確認する**：境界値をテストします（例：ルールが「days\_since\_signup \< 7」の場合、6と7でテストします）

### シミュレーション

シミュレーションでは、設定をまとめて検証します。配信開始前に、ユーザーベースのサンプルに対してトリートメントをテストします。

1. Auxiaコンソールの **Simulation**（シミュレーション）ページに移動する
2. 含めるユーザー数を設定する
3. テスト対象のトリートメントを選択する
4. **シミュレーションを実行**（Run Simulation）をクリックする
5. 結果を確認する

**結果で確認すべき内容：**

* パーソナライズされたトリートメントが表示されるか
* 配信対象ユーザーの割合が想定どおりか
* トリートメント群とコントロール群の比率が実験設計と一致しているか
* トラフィック配分が設定と一致しているか

**注意すべき点：**

* **配信対象ユーザーが0%の場合**：条件が厳しすぎる可能性があります
* **配信対象ユーザーが100%の場合**：条件が広すぎる可能性があります
* **分布が偏っている場合**：モデルのバイアスや優先順位設定の誤りが考えられます

***

## トラブルシューティング

### QAユーザーにトリートメントが届かない

* QAユーザーIDが完全に一致しているか確認する（大文字・小文字は区別されます）
* 保存後、5分待つ
* トリートメントが割り当てられているか確認する
* アプリ内／ウェブのサーフェスの場合：ユーザーが正しいページに移動しているか確認する
* メール／プッシュ通知の場合：**テストアセット** ページから配信を実行したか確認する

### 変数がそのまま表示される場合（例：`${field_name}`）

* ユーザーに該当データがありません。トリートメントは配信されますが、変数がそのまま表示されます
* トリートメント設定で、パーソナライズフィールド名が完全に一致しているか確認する
* パーソナライズが正しく機能するか確認するには、そのフィールドのデータを持つQAユーザーを使用する

### シミュレーションで予期しない分布が表示される

* 各トリートメントの配信条件を確認する
* 重複または競合する配信条件がないか確認する
* ユーザーベース全体での、パーソナライズフィールドのカバー率を確認する

問題が解決しない場合は、Auxiaサポートチームにお問い合わせください。

***

## 次のステップ

一般的なQAシナリオ、配信中の問題のデバッグ、詳細なチェックリストについては、[包括的なQAガイド](https://docs.auxia.io/ja/guides/comprehensive/qa-testing.md)をご参照ください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.