> 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 les événements entrants en temps réel avant de les envoyer vers les destinations.
L'enrichissement peut provenir du catalogue produit, d'une API externe personnalisée, d'une base de données météo (bientôt disponible) ou de tout Custom data store.
## Enrichissement à partir du catalogue produit
Vous pouvez importer l'intégralité du catalogue produit ; ainsi, tous les détails sur les produits seront stockés dans notre plateforme.
{% hint style="info" %}
Cliquez sur [ici](https://community.commandersact.com/platform-x/features/sources/sources-catalog/product-catalog) pour apprendre à importer le catalogue produit
{% endhint %}
Lorsque vous collectez des événements avec des propriétés produit, vous pouvez envoyer uniquement le `product_id`et nous pourrons enrichir les événements entrants avec davantage de propriétés produit provenant du catalogue produit stocké (poids, matériaux, couleur...) et les envoyer vers la ou les destination(s).
### 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 produit stocké ? La plupart du temps, le lien sera le `product_id`Cette propriété doit être commune à celle de l'événement et à celle du catalogue produit stocké.
Sélectionnez les propriétés que vous souhaitez ajouter à l'événement entrant depuis le catalogue produit.
### Section avancée
Vous pouvez définir ici où les propriétés provenant du catalogue produit seront ajoutées dans les événements entrants (dans le payload). Par défaut, elles se trouvent au même niveau que la clé de correspondance. Elles peuvent aussi être à la racine de l'événement ou personnalisées (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 depuis une base de données externe. Via 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 sur quelles sources et quels événements l'enrichissement sera appliqué.
Configurez l'API (méthode, URL, corps, en-tête)
Sélectionnez quelles propriétés de l'API vous souhaitez intégrer aux événements sélectionnés.
## Enrichissement à partir de l'API de base de données météo
{% hint style="info" %}
Bientôt disponible
{% endhint %}
Vous pouvez actuellement le gérer manuellement via [Enrichissement à partir de l'API externe](#enrichment-from-custom-external-api), mais une version plug-and-play est en cours de développement.
## Enrichissement à partir d'un Custom Data Store
Enrichissez les événements à partir d'événements stockés précédemment.\
Cela vous permet de stocker l'événement sélectionné et ses propriétés, puis de les utiliser plus tard pour enrichir les événements, en fournissant un ensemble de données plus complet pour vos besoins marketing et d'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 après le nettoyage de l'événement. 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 stockées pendant 1 jour.
#### Correspondance des événements
* **Clé de correspondance**: Définissez une **clé unique** pour faire correspondre les événements dans le temps. Cette clé aide à relier des événements associés, permettant d'utiliser les propriétés des événements passés dans les futurs.
#### Enrichissement des événements
* **Injection de propriétés**: Injectez automatiquement des propriétés issues d'événements stockés précédemment dans des événements plus récents. Cela crée un jeu de données complet pour chaque événement important dans le customer journey.
### Exemple de cas d'usage
Imaginez qu'un client ajoute un produit à son panier, générant un `add_to_cart` événement. Quelques heures plus tard, le 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 des propriétés issues de l'earlier `add_to_cart` événement, avant que l'événement ne soit envoyé vers vos destinations.
### Comment utiliser la fonctionnalité d'enrichissement d'événement
#### Étape 1 : Créez vos paramètres de stockage
1. **Accédez aux paramètres de stockage**: Rendez-vous dans la Gouvernance des données -> paramètres de stockage.
2. **Gérez 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 Storage Settings, 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 d'événements, choisissez l'option Custom Data Store\\
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 "Storage Settings" column les propriétés, telles qu'elles se trouvent dans votre Storage. 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 remplacer 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é est accessible uniquement aux utilisateurs disposant des privilèges 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.
* **Customer Insights 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.