> 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 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 passer à une version supérieure de votre programme Advocate 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 nécessaires pour faire fonctionner 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 envoyez 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 fenêtre 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 $ par 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 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 champs par défaut fournis. Lorsque vous configurez un champ calculé, vous pouvez :
* Ajouter une date de début et de fin si vous souhaitez que le calcul s’exécute pendant une période 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 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 des fenêtres fixes (par exemple, un seul mois civil ou une seule année), soit des fenêtres glissantes (par exemple, les 90 derniers jours).
* Définissez des contraintes supplémentaires pour le moment où le calcul est effectué 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 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 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 issu de `{eventkey}` événements | Faites la somme de tous les achats effectués par un ami parrainé au cours des 30 premiers jours après son inscription. Attribuez des récompenses progressives au client promoteur en fonction du montant dépensé. |
| Comptage | Comptez le nombre de `{eventkey}` événements | Récompensez les participants lorsqu’ils ont effectué plus de 10 achats. |
| Vu pour la première fois (date) | Calculez l’horodatage du premier `{eventkey}` événement | Récompensez les participants s’ils ont commencé à effectuer des achats avant une certaine date. |
| Vu pour la dernière fois (date) | Calculez l’horodatage du dernier `{eventkey}` événement | Récompensez les participants si leur dernier achat remonte à moins de 5 jours. |
| Première valeur | Calculez la valeur du `{fieldname}` champ issu 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 issu du plus récent `{eventkey}` événement | Récompensez les participants lorsque leur dernier paiement était d’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.