# 計算フィールドの解説

**制限付き**: 計算済みカスタムフィールドは、特定の製品エディションでのみ利用できます。 [サポートにお問い合わせください](https://app.impact.com/support/portal.ihtml?createTicket=true&) アドボケイトプログラムをアップグレードしてアクセス権を取得してください。

を通じて [カスタムフィールド](/brand/ja/nitsuitebitaidesuka/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md)、紹介プログラムの運用に必要な基本情報を超えて、Advocate参加者に関する幅広い追加情報を impact.com に送信できます。

計算済みフィールドはユーザーとイベントのデータを受け取り、その値は計算・保存され、参加者のプロフィールに表示されるようになります。計算済みフィールドを設定すると、条件に合致する Advocate プログラムのイベントを送信するたびに、その値は動的に更新されます。

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

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

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

<details>

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

| 計算済みフィールド          | 説明                                       |
| ------------------ | ---------------------------------------- |
| lastSeenDate       | Advocate でユーザーが最後にアップサートされた日時を追跡します。     |
| firstPurchaseDate  | この参加者について最初に purchase イベントを受信した日付を追跡します。 |
| lastPurchaseDate   | 参加者の最新の purchase イベントの日付を追跡します。          |
| totalPurchaseCount | この参加者の purchase イベントの合計数を追跡します。          |

</details>

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

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

* 計算を一定期間だけ実行したい場合は、開始日と終了日を追加します（例: 1月1日から2月17日まで）。この設定された期間はアクティブ期間と呼ばれます。
* 繰り返し [追跡期間](/brand/ja/nitsuitebitaidesuka/advocate-program/manage-advocate-participants/custom-and-calculated-fields/tracking-windows-for-calculated-fields-explained.md) を指定して、合計およびカウントの計算を行えます。追跡ウィンドウは、固定ウィンドウ（例: 1か月や1年などの単一の暦期間）にも、スライディングウィンドウ（例: 過去90日間）にもできます。
* フィルターを追加するか、JSONata式を記述することで、計算を実行する条件を追加できます。これらのオプションについては、記事で詳しく説明しています。 [計算フィールドの設定](/brand/ja/nitsuitebitaidesuka/advocate-program/manage-advocate-participants/custom-and-calculated-fields/set-up-a-calculated-field.md).

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

<details>

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

計算済みフィールドを作成する際に使用できる計算には、いくつかの種類があります。

| 計算             | 説明                                                    | 例                                                                           |
| -------------- | ----------------------------------------------------- | --------------------------------------------------------------------------- |
| 合計             | の合計を計算する `{fieldname}` のフィールドを `{eventkey}` イベントから    | 紹介された友達がサインアップ後最初の30日以内に行った購入の合計をすべて集計します。支出額に応じて、カスタマーアドボケイトに段階的な報酬を付与します。 |
| 件数             | の数を数える `{eventkey}` イベントから                            | 参加者が11回以上購入したら報酬を与えます。                                                      |
| 最初に確認された日時（日付） | 最初の `{eventkey}` イベントのタイムスタンプを計算します                   | 参加者が特定の日付より前に購入を開始していた場合に報酬を与えます。                                           |
| 最後に確認された日時（日付） | 最後の `{eventkey}` イベントのタイムスタンプを計算します                   | イベントのタイムスタンプを計算します                                                          |
| 最初の値           | 最初の `{fieldname}` イベントのフィールド値を計算する                    | 参加者が初回に大きな購入を行った場合に報酬を与えます。                                                 |
| 最後の値           | 最初の `{fieldname}` 最新の `{eventkey}` イベントのタイムスタンプを計算します | 最後の支払いが少なくとも一定額以上だった場合に参加者に報酬を与えます。                                         |

</details>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/manage-advocate-participants/custom-and-calculated-fields/calculated-fields-explained.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.