> 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/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/calculated-fields-explained.md).
# Champs calculés expliqués
**Limité**: Les champs personnalisés calculés ne sont disponibles que pour certaines éditions du produit. [Contactez l'assistance](https://app.impact.com/support/portal.ihtml?createTicket=true&) pour mettre à niveau votre programme d’ambassadeurs et obtenir l’accès.
Grâce à [des champs personnalisés](/brand/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md), vous pouvez envoyer à impact.com un large éventail d'informations supplémentaires sur vos participants Advocate, au-delà des bases nécessaires pour exécuter votre programme de parrainage.
Les champs calculés reçoivent des données utilisateur et événementielles, et les valeurs sont calculées, stockées et deviennent visibles sur le profil du participant. Une fois le champ calculé configuré, sa valeur se mettra à jour dynamiquement à mesure que vous enverrez les événements de votre programme Advocate qui répondent à vos critères.
{% hint style="info" %}
**Exemple :** Un champ calculé peut être configuré pour compter combien de fois un participant effectue un achat d'au moins 100 $ sur une période d'un mois. Ensuite, vous pouvez configurer votre programme pour attribuer des récompenses spéciales aux participants qui effectuent au moins 3 de ces achats de 100 $ en un mois.
{% endhint %}
#### Champs calculés par défaut
Par défaut, quatre champs calculés vous sont fournis. Vous pouvez y faire référence dès que vous commencez à configurer les règles de votre programme.
Champs calculés par défaut
| Champ calculé | Description |
| ------------------ | --------------------------------------------------------------------------------------------- |
| lastSeenDate | Indique la dernière fois que l'utilisateur a été upserté dans Advocate. |
| firstPurchaseDate | Indique la première date à laquelle nous avons reçu un événement d'achat pour ce participant. |
| lastPurchaseDate | Indique la date de l'événement d'achat le plus récent du participant. |
| totalPurchaseCount | Indique le nombre total d'événements d'achat pour ce participant. |
#### Champs calculés créés par le client
Vous pouvez créer vos propres champs calculés qui vont au-delà de ceux fournis par défaut. Lorsque vous configurez un champ calculé, vous pouvez :
* Ajouter une date de début et une date de fin si vous souhaitez que le calcul s'exécute pendant une durée limitée (par exemple, du 1er janvier au 17 février). Cette période définie est appelée période active.
* Spécifier une fenêtre de suivi récurrente [fenêtre de suivi](/brand/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/tracking-windows-for-calculated-fields-explained.md) pour vos calculs de somme et de comptage. Les fenêtres de suivi peuvent être soit fixes (par exemple, un mois ou une année civile unique), soit glissantes (par exemple, les 90 derniers jours).
* Définir des contraintes supplémentaires sur le moment où le calcul est effectué en ajoutant un filtre ou en écrivant une expression JSONata. Ces options sont expliquées plus en détail dans notre article [Configuration d’un champ calculé](/brand/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/set-up-a-calculated-field.md).
{% hint style="info" %}
**Remarque :** Si votre champ calculé a une période active ou une fenêtre de suivi, les valeurs ne seront pas mises à jour une fois la période de calcul terminée. Si votre champ calculé a une période active (ou une fenêtre de suivi, pour les calculs de somme/comptage uniquement), les valeurs ne seront plus mises à jour après la fin de la période de calcul. Cependant, les valeurs resteront visibles sur le profil de chaque participant.
{% endhint %}
Champs calculés créés par le client
Il existe plusieurs types de calculs que vous pouvez utiliser lors de la création d'un champ calculé.
| Calcul | Description | Exemple |
| -------------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Somme | Calculez la somme du champ `{fieldname}` à partir de `{eventkey}` événements | Additionnez tous les achats effectués par un ami parrainé au cours des 30 premiers jours suivant l'inscription. Attribuez des récompenses par paliers au client ambassadeur en fonction du montant dépensé. |
| Nombre | Comptez le nombre de `{eventkey}` événements | Récompensez les participants lorsqu'ils ont effectué plus de 10 achats. |
| Première apparition (date) | Calculez l’horodatage du premier `{eventkey}` événement | Récompensez les participants s'ils ont commencé à effectuer des achats avant une certaine date. |
| Dernière apparition (date) | Calculez l’horodatage du dernier `{eventkey}` événement | Récompensez les participants si leur dernier achat date de moins de 5 jours. |
| Première valeur | Calculez la valeur du `{fieldname}` champ du premier {eventkey} événement | Récompensez les participants lorsqu'ils effectuent un premier achat d'un montant élevé. |
| Dernière valeur | Calculez la valeur du `{fieldname}` champ du plus récent `{eventkey}` événement | Récompensez les participants lorsque leur dernier paiement atteint au moins une certaine valeur. |
---
# 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/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/calculated-fields-explained.md?ask=&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.