> 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).
# Explication des champs calculés
**Limité**: Les champs calculés personnalisés ne sont disponibles que pour certaines éditions du produit. [Contacter le support](https://app.impact.com/support/portal.ihtml?createTicket=true&) pour mettre à niveau votre programme d'ambassadeurs et obtenir l'accès.
Grâce à [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 informations de base requises pour exécuter votre programme de parrainage.
Les champs calculés reçoivent les 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 le nombre de fois qu'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 les référencer 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 du plus récent événement d'achat 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à des valeurs par défaut fournies. Lorsque vous configurez un champ calculé, vous pouvez :
* Ajoutez une date de début et de fin si vous voulez 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 une période active.
* Définir une fenêtre [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 compte. Les fenêtres de suivi peuvent être soit des fenêtres fixes (par ex., un mois civil ou une année unique) soit des fenêtres glissantes (par ex., les 90 derniers jours).
* Définissez des contraintes supplémentaires pour l'exécution du calcul en ajoutant un filtre ou en écrivant une expression JSONata. Ces options sont abordé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 plus 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/compte uniquement), les valeurs ne seront plus mises à jour une fois la période de calcul terminée. 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 `{fieldname}` champ à partir des `{eventkey}` événements | Additionnez tous les achats effectués par un ami parrainé au cours des 30 premiers jours après l'inscription. Attribuez des récompenses échelonnées 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 à partir du premier événement {eventkey} | Récompensez les participants lorsqu'ils effectuent un premier achat important. |
| Dernière valeur | Calculez la valeur du `{fieldname}` champ à partir 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.