# 計算フィールドの説明

**制限付き**：計算されたカスタムフィールドは特定の製品エディションでのみ利用可能です。 [サポートに連絡する](https://app.impact.com/support/portal.ihtml?createTicket=true&) あなたのアドボケイトプログラムをアップグレードしてアクセス権を取得する。

を通じて [カスタムフィールド](https://help.impact.com/brand/ja/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained)、impact.com にリファラルプログラムを運営するために必要な基本情報を超える、あなたのアドボケート参加者に関する幅広い追加情報を送信できます。

計算フィールドはユーザーおよびイベントデータを受け取り、その値は計算されて保存され、参加者のプロファイルに表示されます。計算フィールドを設定すると、条件を満たすアドボケートプログラムのイベントを送信するたびにその値は動的に更新されます。

{% hint style="info" %}
**例：** 計算フィールドは、参加者が1か月の間に少なくとも100ドルの購入を行った回数をカウントするように設定できます。次に、これらの100ドルの購入を1か月に3回以上行った参加者に特別な報酬を発行するようプログラムを設定できます。
{% endhint %}

#### デフォルトの計算フィールド

デフォルトでは、4つの計算フィールドが提供されます。プログラムのルールを設定し始めるとすぐにこれらを参照できます。

<details>

<summary>デフォルトの計算フィールド</summary>

| 計算フィールド            | 説明                                    |
| ------------------ | ------------------------------------- |
| lastSeenDate       | ユーザーが Advocate にアップサートされた最後の日時を追跡します。 |
| firstPurchaseDate  | この参加者に関する購入イベントを初めて受信した日付を追跡します。      |
| lastPurchaseDate   | 参加者の直近の購入イベントの日付を追跡します。               |
| totalPurchaseCount | この参加者の購入イベントの総数を追跡します。                |

</details>

#### クライアント作成の計算フィールド

提供されるデフォルトのものを超える独自の計算フィールドを作成できます。計算フィールドを設定すると、次のことができます：

* 計算を限定期間で実行したい場合は開始日と終了日を追加します（例：1月1日〜2月17日）。この設定された期間をアクティブ期間と呼びます。
* 定期的な [追跡ウィンドウ](https://help.impact.com/brand/ja/advocate-program/manage-advocate-participants/custom-and-calculated-fields/tracking-windows-for-calculated-fields-explained) 合計およびカウント計算のための追跡ウィンドウを指定します。追跡ウィンドウは固定ウィンドウ（例：単一のカレンダー月や年）またはスライディングウィンドウ（例：過去90日）にすることができます。
* フィルターを追加したり JSONata 式を書くことで、計算が実行される追加の制約を設定できます。これらのオプションについては当社の記事で詳しく説明しています： [計算フィールドの設定](https://help.impact.com/brand/ja/advocate-program/manage-advocate-participants/custom-and-calculated-fields/set-up-a-calculated-field).

{% hint style="info" %}
**注：** 計算フィールドにアクティブ期間や追跡ウィンドウがある場合、計算期間終了後は値は更新されません（合計/カウント計算については追跡ウィンドウが該当）。ただし、値は各参加者のプロファイルに表示されたままになります。
{% endhint %}

<details>

<summary>クライアント作成の計算フィールド</summary>

計算フィールドを構築する際に使用できる計算の種類はいくつかあります。

| 計算                | 説明                                                              | 例                                                                       |
| ----------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------- |
| 合計（Sum）           | の合計を計算します `{fieldname}` フィールドを `{eventkey}` イベントから              | 紹介された友人がサインアップ後最初の30日以内に行ったすべての購入を合計します。支出金額に基づいて顧客アドボケートに段階的な報酬を発行します。 |
| カウント（Count）       | の数をカウントします `{eventkey}` イベントから                                  | 参加者が10回以上購入した場合に報酬を与えます。                                                |
| 初回確認（日付）          | 最初の `{eventkey}` イベントのタイムスタンプを計算します                             | 参加者がある日付より前に購入を開始していた場合に報酬を与えます。                                        |
| 最終確認（日付）          | 最後の `{eventkey}` イベントのタイムスタンプを計算します                             | 参加者の最後の購入が5日以内であれば報酬を与えます。                                              |
| 最初の値（First Value） | の値を計算します `{fieldname}` 最初の {eventkey} イベントの {fieldname} フィールドから | 参加者が大きな初回購入を行ったときに報酬を与えます。                                              |
| 最終値（Last Value）   | の値を計算します `{fieldname}` 最新の `{eventkey}` イベントのタイムスタンプを計算します      | 参加者の最後の支払いが一定の価値以上であれば報酬を与えます。                                          |

</details>
