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

# セクション 8: QA & テスト

<Note>
  日本語版はAIによる翻訳です。正確な情報については[英語版](/guides/comprehensive/qa-testing)をご参照ください。
</Note>

Treatment を公開する前にテストすることで、品質を確保しミスを防ぐことができます。このセクションでは、Auxia Console で利用可能なすべての QA ツールについて説明します。

## 8.1 Treatment をテストする理由

### テストの重要性

Treatment を Active にする前に、テストによって以下を確認できます：

* **コンテンツ**が正しく表示されること
* **パーソナライゼーション**が期待通りに動作すること
* **適格性ルール**が正しいユーザーをターゲットにしていること
* **エラー**が実際のユーザーに届くのを防ぐこと
* ローンチ前に**自信を持てる**こと

### テストの考え方

| フェーズ      | テスト対象              |
| --------- | ------------------ |
| **作成時**   | コンテンツ、フォーマット、画像    |
| **設定時**   | Guardrails、Surface |
| **ローンチ前** | 実際のアプリでのエンドツーエンド   |
| **ローンチ後** | 問題の監視              |

***

## 8.2 QA ツールへのアクセス

### ナビゲーション

1. サイドバーの **Treatments & Journeys** をクリックします
2. **QA & Testing** を選択します

### QA & Testing の概要

QA セクションには以下が含まれます：

* **QA Users** - Treatment をプレビューするためのテストアカウント
* **Test Treatments** - 特定のユーザーに Treatment をトリガー
* **QA Tags** - テストコンテンツのラベル付けとフィルタリング

***

## 8.3 QA Users

### QA Users とは？

QA Users は、以下が可能な特別なテストアカウントです：

* 通常の適格性に関係なく Treatment を受信
* 公開前の Treatment をプレビュー
* 実機/実アプリでテスト

### QA Users の設定

**ステップ 1: QA User の作成**

1. QA & Testing > QA Users に移動します
2. **+ Add QA User** をクリックします
3. ユーザー識別子（メールアドレスまたはユーザー ID など）を入力します
4. 保存します

**ステップ 2: デバイスの設定**

* QA User アカウントでアプリにログインします
* アプリが Auxia プロジェクトに接続されていることを確認します

**ステップ 3: テスト**

* Console から Treatment をトリガーします
* アプリに表示されることを確認します

### QA User の属性

Guardrails をテストするために、QA Users に属性を設定できます：

| 属性                  | 例         | テスト目的                  |
| ------------------- | --------- | ---------------------- |
| subscription\_tier  | "Premium" | プレミアム限定 Treatment のテスト |
| days\_since\_signup | 3         | 新規ユーザー Treatment のテスト  |
| location            | "US"      | 地域ターゲットコンテンツのテスト       |

### QA Users の管理

**QA Users の表示：**

* QA Users タブにすべての設定済みユーザーが表示されます

**QA User の編集：**

* ユーザーをクリックして属性を変更します

**QA User の削除：**

* 不要になった場合は削除します

***

## 8.4 Treatment のテスト

### コンソール内プレビュー

Console で直接 Treatment をプレビューします：

1. ポートフォリオから Treatment を開きます
2. **Preview** をクリックします
3. 概算のレンダリングを確認します

**プレビューの制限：**

* コンテンツ構造が表示されますが、アプリの正確なレンダリングではありません
* パーソナライゼーションはプレースホルダー値が表示されます
* すべてのインタラクティブ要素が機能するわけではありません

### 実機でのテスト

正確なテストのために：

1. **QA User を設定**します（上記参照）
2. **QA User に Treatment をターゲット**します
3. テストデバイスで**アプリを開き**ます
4. Treatment の Surface に**ナビゲート**します
5. Treatment が正しく表示されることを**確認**します

### Treatment の強制送信

特定の Treatment をテストするには：

1. QA & Testing に移動します
2. 「Test Treatment」を選択します
3. テストする Treatment を選択します
4. QA User ID を入力します
5. 「Send Test」をクリックします
6. デバイスで Treatment を確認します

### テストチェックリスト

Treatment を Active にする前に：

* [ ] コンテンツが正しく表示される
* [ ] 画像が正しく読み込まれる
* [ ] CTA ボタンが動作する
* [ ] パーソナライゼーションが実際の値を表示する
* [ ] リンク/ディープリンクが正しく遷移する
* [ ] Treatment が正しく閉じられる
* [ ] 異なる画面サイズで正しくレンダリングされる

***

## 8.5 Guardrails のテスト

### テスト対象

Guardrails が以下を確認します：

* 意図したユーザーを含む
* 意図しないユーザーを除外する
* エッジケースを正しく処理する

### テストアプローチ

**テスト 1: ポジティブケース**

* マッチすべき属性を持つ QA User を設定
* Treatment が配信されることを確認

**テスト 2: ネガティブケース**

* マッチすべきでない属性を持つ QA User を設定
* Treatment が配信されないことを確認

**テスト 3: 境界ケース**

* エッジ値をテスト（例：ちょうど7日）
* 境界での動作を確認

### 例：ルールのテスト

**ルール：** `days_since_signup < 7` の場合に Treatment を表示

| QA User の設定             | 期待される結果                |
| ----------------------- | ---------------------- |
| days\_since\_signup = 3 | Treatment が表示されるべき     |
| days\_since\_signup = 7 | Treatment が表示されるべきではない |
| days\_since\_signup = 6 | Treatment が表示されるべき     |

***

## 8.6 パーソナライゼーションのテスト

### パーソナライゼーションとは？

パーソナライゼーションは、ユーザーデータを Treatment コンテンツに挿入します：

```
Hello `${first_name}`, welcome back!
```

以下のようになります：

```
Hello Sarah, welcome back!
```

### パーソナライゼーションのテスト

1. 必要な属性を持つ QA User を設定します
   * 例：first\_name = "TestUser"

2. QA User に Treatment を送信します

3. パーソナライゼーションが正しくレンダリングされることを確認します
   * "Hello TestUser, welcome back!"

### よくあるパーソナライゼーションの問題

| 問題          | 症状               | 修正方法            |
| ----------- | ---------------- | --------------- |
| データフィールドの欠落 | プレースホルダーまたは空白が表示 | ユーザーに属性があることを確認 |
| フィールド名の誤り   | プレースホルダーが表示      | フィールド名のスペルを確認   |
| フォーマットの問題   | 予期しないフォーマット      | データ型とフォーマットを確認  |

***

## 8.7 QA Tags

### QA Tags とは？

タグは、テストコンテンツの整理と識別に役立ちます。

### タグの使用

**Treatment のタグ付け：**

* 作成時にタグを追加
* 「QA」、「Test」、「Draft」などとマーク

**タグによるフィルタリング：**

* ポートフォリオでタグフィルターを使用
* テストコンテンツをすばやく検索

**タグの削除：**

* 公開時にタグを削除
* ポートフォリオをきれいに保つ

***

## 8.8 テストワークフロー

### 推奨テストプロセス

```
1. Create Treatment (Draft)
         ↓
2. In-Console Preview
         ↓
3. Set Up QA User
         ↓
4. Test on Device
         ↓
5. Verify All Elements
         ↓
6. Fix Any Issues
         ↓
7. Re-test
         ↓
8. Activate
```

### ローンチ前チェックリスト

**コンテンツ：**

* [ ] タイトルが正しい
* [ ] 本文が正確
* [ ] 誤字脱字がない
* [ ] パーソナライゼーションが動作する

**ビジュアル：**

* [ ] 画像が読み込まれる
* [ ] レイアウトが正しい
* [ ] 色が正しい
* [ ] CTA が表示されている

**機能：**

* [ ] CTA が正しく動作する
* [ ] リンクが正しく遷移する
* [ ] 閉じる機能が動作する

**設定：**

* [ ] 正しい Surface が選択されている
* [ ] Guardrails が正しい
* [ ] Journey の割り当てが正しい

***

## 8.9 テストのベストプラクティス

### 早期かつ頻繁にテストする

* 最後までテストを待たない
* 重要な変更のたびにテストする
* 簡単なテストで問題を早期に発見する

### 複数のテストアカウントを使用する

* 異なる属性の組み合わせ
* 異なるデバイス/プラットフォーム
* 異なるアプリバージョン

### テストを記録する

以下を記録します：

* テストした内容
* テスト結果（合格/不合格）
* 発見・修正した問題
* テスト実施者と日時

### 他の人を巻き込む

* 同僚にコンテンツをレビューしてもらう
* 見た目について意見をもらう
* 新鮮な目で問題を発見する

### 本番に近い環境でテストする

* ステージング/本番のアプリバージョンを使用する
* 現実的なデータでテストする
* 実際のユーザー条件をシミュレートする

***

## 8.10 よくあるテストの問題

### Treatment が表示されない

**確認事項：**

1. QA User が正しく設定されている
2. ユーザー識別子が一致している
3. Treatment が正しい Surface をターゲットにしている
4. アプリが正しいプロジェクトに接続されている
5. デバイスにネットワーク接続がある

### 間違ったコンテンツが表示される

**確認事項：**

1. 正しい Treatment が選択されている
2. キャッシュの問題がない（アプリキャッシュのクリアを試す）
3. Treatment の正しいバージョンである

### パーソナライゼーションが動作しない

**確認事項：**

1. QA User に必要な属性がある
2. 属性名が正確に一致している
3. データ型が正しい

### Treatment が間違ったユーザーに表示される

**確認事項：**

1. Guardrails が正しい
2. 競合するルールがない
3. Treatment のステータス（Active かどうか？）

***

## 8.11 QA の権限

### 必要な権限

| 権限              | アクセス              |
| --------------- | ----------------- |
| TREATMENT\_VIEW | Treatment の閲覧     |
| QA\_USER\_VIEW  | QA Users の閲覧      |
| QA\_USER\_EDIT  | QA Users の管理      |
| TREATMENT\_TEST | テスト Treatment の送信 |

### アクセスの取得

QA テストの権限が必要な場合は、管理者にお問い合わせください。

***

## 次のセクション

[セクション 9: Configuration](/ja/guides/comprehensive/configuration) に進んで、システム設定のドキュメントをご覧ください。
