> 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 sont disponibles uniquement dans certaines éditions du produit. [Contactez l’assistance](https://app.impact.com/support/portal.ihtml?createTicket=true&) pour mettre à niveau votre programme d'ambassadeurs et y accéder.
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 les participants de votre programme Advocate, au-delà des informations de base nécessaires pour gérer 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 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 le nombre de fois qu’un participant effectue un achat d’au moins 100 $ sur une période d’un mois. Vous pouvez ensuite 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é mis à jour 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à 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 une période active.
* Spécifier 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 des fenêtres fixes (par exemple, un seul mois ou une seule année civile) ou des fenêtres glissantes (par exemple, les 90 derniers jours).
* Définissez 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 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, uniquement pour les calculs de somme/comptage), les valeurs ne seront plus mises à jour après la fin de la période de calcul. Toutefois, 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 des `{fieldname}` du champ 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 à l’ambassadeur client en fonction du montant dépensé. |
| Compter | Comptez le nombre de `{eventkey}` événements | Récompensez les participants lorsqu’ils ont effectué plus de 10 achats. |
| Première vue (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 vue (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 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 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.