> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/enrichments/events-enrichment.md).
# Enrichissement des événements
Enrichissez en temps réel les événements entrants avant de les envoyer vers les destinations.
L’enrichissement peut provenir du catalogue de produits, d’une API externe personnalisée, d’une base de données météo (bientôt disponible) ou de tout stockage de données personnalisé.
## Enrichissement à partir du catalogue de produits
Vous pouvez importer l’intégralité du catalogue de produits ; ainsi, tous les détails sur les produits seront stockés dans notre plateforme.
{% hint style="info" %}
Cliquez [ici](https://community.commandersact.com/platform-x/features/sources/sources-catalog/product-catalog) pour apprendre à importer le catalogue de produits
{% endhint %}
Lorsque vous collectez des événements avec des propriétés de produits, vous pouvez envoyer uniquement le `product_id`, et nous serons en mesure d’enrichir les événements entrants avec davantage de propriétés produit provenant du catalogue de produits stocké (poids, matériaux, couleur...) et de les envoyer vers les destinations.
### Configuration
Sélectionnez d’abord l’événement que vous souhaitez enrichir.
Sélectionnez la propriété qui sera utilisée comme **clé de correspondance**, c’est-à-dire comment établir un lien entre l’événement entrant et le catalogue de produits stocké ? La plupart du temps, le lien sera le `product_id`. Cette propriété doit être commune entre celle de l’événement et celle du catalogue de produits stocké.
Sélectionnez les propriétés que vous souhaitez ajouter dans l’événement entrant à partir du catalogue de produits.
### Section avancée
Vous pouvez définir ici où les propriétés provenant du catalogue de produits seront ajoutées dans les événements entrants (dans le payload). Par défaut, c’est au même niveau que la clé de correspondance. Cela peut aussi être à la racine de l’événement ou personnalisé (saisissez la position).
## Enrichissement à partir d’une API externe personnalisée
Enrichissez les événements avec des données provenant de n’importe quelle API.
Par exemple, enrichissez un événement d’achat en ajoutant des propriétés provenant d’une base de données externe. Via l’API, envoyez une requête avec la clé de correspondance (un ID par exemple) et l’API renvoie les données souhaitées, qui seront ensuite intégrées à l’événement d’achat.
### Configuration
Sélectionnez les sources et les environnements auxquels l’enrichissement sera appliqué.
Configurez l’API (méthode, URL, Body, Header)
Sélectionnez quelles propriétés de l’API vous souhaitez intégrer dans les événements sélectionnés.
## Enrichissement à partir de l’API de la base de données météo
{% hint style="info" %}
À venir
{% endhint %}
Vous pouvez actuellement le gérer manuellement via [Enrichissement à partir d’une API externe](#enrichment-from-custom-external-api), mais une version plug\&play est en cours de développement.
## Enrichissement à partir d’un Data Store personnalisé
Enrichissez les événements à partir d’événements précédemment stockés.\
Cela vous permet de stocker des événements et des propriétés sélectionnés, puis de les utiliser ensuite pour enrichir des événements, en fournissant un ensemble de données plus complet pour vos besoins en marketing et en analyse.
### Fonctionnalités clés
#### Stockage de l’événement
* **Stockage sélectif**: Choisissez des propriétés spécifiques d’un événement à stocker une fois l’événement nettoyé. Cela garantit que seules les données pertinentes et propres sont stockées.
* **Durée de stockage**: Par défaut, les propriétés sont conservées pendant 1 jour.
#### Correspondance des événements
* **Clé de correspondance**: Définissez une **clé unique** pour faire correspondre les événements au fil du temps. Cette clé aide à relier les événements associés, permettant d’utiliser les propriétés des événements passés dans les événements futurs.
#### Enrichissement des événements
* **Injection de propriétés**: Injectez automatiquement les propriétés des événements stockés passés dans des événements plus récents. Cela crée un jeu de données complet pour chaque événement significatif dans le customer journey.
### Exemple de cas d’utilisation
Imaginez qu’un client ajoute un produit à son panier, générant un `add_to_cart` événement. Quelques heures plus tard, ce même client finalise l’achat, générant un `purchase` événement. Avec la *Enrichissement des événements* fonctionnalité, vous pouvez enrichir le `purchase` événement en temps réel avec les propriétés de l’événement précédent `add_to_cart` événement, avant que l’événement ne soit envoyé vers vos destinations.
### Comment utiliser la fonctionnalité d’enrichissement d’événements
#### Étape 1 : créez vos paramètres de stockage
1. **Accéder aux paramètres de stockage**: Rendez-vous dans Gouvernance des données -> paramètres de stockage.
2. **Gérer les paramètres de stockage**: Cliquez sur "Nouveau stockage" pour créer un nouveau stockage.\\
Pour en savoir plus sur l’utilisation de cette fonctionnalité et obtenir des conseils sur la création des paramètres de stockage, veuillez [lire la page dédiée](/fr/fonctionnalites/enrichments/storage-settings.md)\\
#### Étape 2 : enrichir les événements
1. **Créer un enrichissement**: Dans la section Enrichissement des événements, choisissez l’option Stockage de données personnalisé\\
2. **Définir l’enrichissement**:
* **Nom**: Nommez votre règle d’enrichissement.
* **Sélectionnez les sources et l’environnement**
* **Sélectionnez les paramètres de stockage** que vous souhaitez utiliser pour cet enrichissement
* **Choisir l’événement**: Sélectionnez l’événement que vous souhaitez enrichir.\\
* **Sélectionner les propriétés**: Définissez quelles propriétés de l’événement stocké doivent être injectées dans le nouvel événement. Sélectionnez, dans la colonne "Paramètres de stockage", les propriétés telles qu’elles sont dans votre stockage. Sélectionnez la propriété que vous souhaitez enrichir dans la colonne "Event Property"\
Le stockage ne remplace ni n’écrase la valeur d’une propriété existante. Le stockage créera de nouvelles propriétés.\
Si vous souhaitez écraser une valeur existante, cliquez sur l’option "override"
* **Vérifier les paramètres**: Assurez-vous que tous les paramètres sont correctement configurés.
* **Enregistrer**: Enregistrez les nouveaux paramètres d’enrichissement.\\
* **Réservé aux administrateurs**: Cette fonctionnalité n’est accessible qu’aux utilisateurs disposant de droits d’administrateur. Des profils personnalisés peuvent être créés pour accorder un accès spécifique à d’autres utilisateurs.
### Avantages
* **Jeux de données complets**: L’enrichissement des événements garantit que toutes les données pertinentes sont disponibles pour l’analyse et les actions marketing.
* **Insights client améliorés**: Obtenez une compréhension plus détaillée du comportement des clients en reliant les événements associés au fil du temps.
---
# 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://doc.commandersact.com/fr/fonctionnalites/enrichments/events-enrichment.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.