> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/test-your-advocate-program.md).

# Advocateプログラムをテストする

Advocateプログラムは、次の方法でテストできます。 [プログラムのルール](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) サンプルデータを使ってシミュレーションし、本番環境で使用する前に、ルールが期待どおりに動作することを確認できます。

{% hint style="success" %}
**注:** プログラムをテストするには、少なくとも1つのプログラムルールを設定する必要があります。
{% endhint %}

{% stepper %}
{% step %}

## 「プログラムをテスト」にアクセスする

1. 左側のナビゲーションメニューで、 ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[エンゲージ]** <i class="fa-arrow-right">:arrow-right:</i> **プログラムルール** <i class="fa-arrow-right">:arrow-right:</i> **プログラムをテスト**.
   1. 「 **次へ** 」を選択して、手順を移動します。
      {% endstep %}

{% step %}

## プログラムとバージョンを確認する

2. プログラムには現在のコンテキストのものがあらかじめ入力されています。別のプログラムをテストする場合のみ、切り替えてください。
3. 「 *バージョン* ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[ドロップダウンメニュー]**」から、シミュレーションする **ドラフト** または **ライブ** バージョンを選択します。
   1. Advocateプログラムのドラフト版とライブ版について詳しくはこちらをご覧ください。
      {% endstep %}

{% step %}

## イベントを選択し、入力項目に入力する

4. シミュレーションするイベントを選択し、プログラム内で発生する場合と同じように情報を入力します。
   * **紹介の開始**
   * **友人が購入**
   * **友人が購入を返品**
   * **友人がアクションを実行**

<details>

<summary>フィールドの説明</summary>

| 項目                     | 説明                               | 対象                            |
| ---------------------- | -------------------------------- | ----------------------------- |
| **購入イベント**             | シミュレーションする、追跡対象の購入イベントです。        | 友人が購入する、友人が購入を払い戻す            |
| **購入日**                | シミュレーションする購入の日付です。               | 友人が購入する、友人が購入を払い戻す            |
| **イベントタイプ**            | シミュレーションする追跡対象のイベントです。           | 友人がアクションを実行                   |
| **イベント日**              | イベントが発生した日付です。                   | 友人がアクションを実行                   |
| **通貨**                 | シミュレーションする購入金額の通貨です。             | 友人が購入する、友人がアクションを実行する         |
| **購入金額**               | シミュレーションする購入金額です。                | 友人が購入する（必須）、友人がアクションを実行する（任意） |
| **紹介開始日**              | 紹介が開始された日付です。                    | すべてのイベント                      |
| **紹介のコンバージョン**         | 紹介がすでにコンバージョンしたかどうかと、その日時を指定します。 | 「紹介の開始」以外のすべてのイベント            |
| **Advocateセグメント** （任意） | テストを特定のアドボケイトセグメントに限定します。        | すべてのイベント                      |
| **フレンドセグメント** （任意）     | テストを特定のフレンドセグメントに限定します。          | すべてのイベント                      |

</details>
{% endstep %}

{% step %}

## テストを実行

5. 選択 **テストを実行**。ルールは、選択したプログラムとバージョン、および指定した入力に基づいて評価されます。
   {% endstep %}

{% step %}

## プレビュー出力を確認する

6. 次の *プレビュー* パネルを確認します。
   1. トリガーされたルールの概要、日付ベースのアクションが適用される場合はその日付範囲、そして結果として実行される各アクションのチェックマーク付き行が表示されます。想定どおりか確認してください。
      {% endstep %}
      {% endstepper %}

## テストケース

これらのテストケースでは、公開前にプログラムが意図したとおりに動作することを確認するために設定できるルールの例を使用します。以下の各シナリオでは、特定の状況を詳しく説明します。トリガー、金額、セグメントなどの詳細を、ご自身のプログラムの設定に合わせて調整してください。

<details>

<summary>基本的なトリガーロジック</summary>

**目的：**

* 基本的な購入トリガーのルールが一致し、想定される結果を返すことを確認します。
* 誤ったフォールバック動作がないことを確認します。

**ルールの設定：**

* トリガー：フレンドが購入する。
* アクション：アドボケイトへの報酬とメール。アドボケイトには現金報酬を付与します。
* デフォルトアクションは不要です。

**テスト入力：**

* イベント：フレンドが購入する。
* 購入イベント、購入日、購入金額、通貨をルールに一致させます。
* 同じ日に紹介が開始されています。
* セグメントは指定しません。

**期待される結果：**

* ルールが一致し、プレビューに一致したルールが正確に表示されます。
* アドボケイト報酬の行に、設定した報酬額が表示されます。
* アドボケイトへのメールの行が表示されます。
* ほかの誤ったフォールバックアクションは表示されません。

</details>

<details>

<summary>期間内の一致とフォールバック</summary>

**目的：**

* 期間ベースのウィンドウ内の日付では、期間ベースのアクションが適用されることを確認します。
* 期間外の日付では、デフォルトにフォールバックすることを確認します。

**ルールの設定：**

* トリガー：フレンドが購入する。
* 紹介開始日を基準にした、日付範囲が設定された期間ベースのアクション。
* 期間外に適用されるデフォルトアクション。

**実行 A（期間内）：**

* 紹介開始日を期間内に設定します。

**期待される結果 A：**

* プレビューに、一致した期間ベースのルールが正確に表示されます。
* そのルールの報酬とメールが適用されます。

**実行 B（期間外）：**

* 紹介開始日を期間外に設定します。

**期待される結果 B：**

* 期間ベースのアクションは一致しません。
* 代わりに、デフォルトの報酬とメールが適用されます。

</details>

<details>

<summary>段階別報酬の選択</summary>

**目的：**

* 購入金額に基づいて、正しい報酬段階が選択されることを確認します。

**ルールの設定：**

* トリガー：フレンドが購入する。
* アクション：段階型報酬とアドボケイトへのメール。
* 購入金額の範囲に応じた報酬ティアを少なくとも3段階（例：低・中・高）。

**テスト入力：**

* ティアごとに1回ずつ実行します。
* 各ティアの範囲内に収まる購入金額を入力します。
* 実行ごとに、ほかの入力値はすべて同じにします。

**期待される結果：**

* 各実行で、金額が該当するティアに設定された報酬が表示され、別のティアの報酬は表示されません。

</details>

<details>

<summary>セグメントによる適用条件</summary>

**目的：**

* セグメント条件によってルールの適用可否が決まることを確認します。

**ルールの設定：**

* トリガー：フレンドが購入する。
* アドボケイトが特定のセグメントに属していることを必須とする条件。
* 可能であれば、それ以外のすべてのユーザーに適用するデフォルトアクション。

**実行A（一致）：**

* アドボケイトのセグメントを、適用対象のセグメントに設定します。

**期待される結果 A：**

* 適用対象のアクションが適用されます。
* デフォルトアクションは適用されません。

**実行B（不一致）：**

* アドボケイトのセグメントを、適用対象外のセグメントに設定します。

**期待される結果 B：**

* デフォルトアクションが設定されている場合は、それが適用されます。
* 設定されていない場合は、条件を満たすアクションは何も実行されません。

</details>

<details>

<summary>コミッションの計算</summary>

**目的：**

* コミッション報酬が購入金額に基づいて計算され、正しい通貨で表示されることを確認します。

**ルールの設定：**

* トリガー：フレンドが購入する。
* アクション：報酬とアドボケイトへのメール。
* 取引通貨での、購入金額に対する一定割合のコミッション報酬。

**実行AとB：**

* 通貨は同じで、購入金額は異なる2つのケース。

**AとBで期待される結果：**

* それぞれの金額にコミッション率が正しく適用されて表示されます。

**実行C（プログラムが複数通貨に対応している場合）：**

* 実行Aと同じ金額で、通貨だけを変えます。

**Cで期待される結果：**

* コミッションが正しく計算され、新しい通貨で表示されます。
* これにより、通貨の処理と金額の計算を切り分けて確認できます。

</details>

<details>

<summary>一致なし、デフォルトアクションなし</summary>

**目的：**

* 何も一致せず、フォールバックもない場合に、プレビューにアクションなしと明確に表示されることを確認します。

**ルールの設定：**

* デフォルトアクションが設定されていない時間ベースのアクション。

**テスト入力：**

* 紹介開始日を時間枠の範囲外に設定します。

**期待される結果：**

* 時間枠に一致しません。
* デフォルトのフォールバックはありません。
* プレビューに、条件を満たすアクションは実行されないと明確に表示されます。

</details>

<details>

<summary>ルール条件を満たさないことによる不一致</summary>

**目的：**

* 時間枠だけでなく、ルール自体の条件を満たさない場合に、プレビューにアクションなしと表示されることを確認します。

**ルールの設定：**

* トリガーイベントに対する条件が2つあるルール：特定の購入イベントと、購入金額の下限。

**テスト入力：**

* 一致しない購入イベント、下限未満の金額、またはその両方を入力します。

**期待される結果：**

* どのルール条件にも一致しません。
* プレビューに何も起こらないことが明確に表示されます。

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/test-your-advocate-program.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
