> 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. [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 à [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 une large gamme d'informations supplémentaires sur vos participants Advocate, au-delà des éléments de base nécessaires au fonctionnement de 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 met à 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 $ dans une fenêtre 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 $ au cours d'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.

<details>

<summary>Champs calculés par défaut</summary>

| Champ calculé      | Description                                                                                |
| ------------------ | ------------------------------------------------------------------------------------------ |
| lastSeenDate       | Suit la dernière fois que l'utilisateur a été upserté dans Advocate.                       |
| firstPurchaseDate  | Suit la première date à laquelle nous avons reçu un événement d'achat pour ce participant. |
| lastPurchaseDate   | Suit la date de l'événement d'achat le plus récent du participant.                         |
| totalPurchaseCount | Suit le nombre total d'événements d'achat pour ce participant.                             |

</details>

#### 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 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 mois ou une année civile unique) ou des fenêtres glissantes (par exemple, les 90 derniers jours).
* Définir des contraintes supplémentaires pour déterminer quand 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 [Configurer 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/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 %}

<details>

<summary>Champs calculés créés par le client</summary>

Il existe plusieurs types de calculs que vous pouvez utiliser lors de la création d'un champ calculé.

| Calcul                     | Description                                                                                             | Exemple                                                                                                                                                                                                    |
| -------------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Somme                      | Calculer 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 suivant l'inscription. Accordez des récompenses échelonnées au client ambassadeur en fonction du montant dépensé. |
| Nombre                     | Compter le nombre de `{eventkey}` événements                                                            | Récompensez les participants lorsqu'ils ont effectué plus de 10 achats.                                                                                                                                    |
| Première apparition (date) | Calculer 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) | Calculer l'horodatage du dernier `{eventkey}` événement                                                 | Récompensez les participants si leur dernier achat a eu lieu dans les 5 jours.                                                                                                                             |
| Première valeur            | Calculer 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            | Calculer la valeur du `{fieldname}` champ à partir de l'événement le plus récent `{eventkey}` événement | Récompensez les participants lorsque leur dernier paiement atteignait au moins une certaine valeur.                                                                                                        |

</details>


---

# 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:

```
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=<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.
