# Enrichissement des événements
Enrichir les événements entrants en temps réel avant de les envoyer aux 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 stockage de données personnalisé.
## Enrichissement à partir du catalogue produit
Vous pouvez importer le catalogue produit complet ; 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 produits, 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 à la ou aux destinations.
### Configuration
Sélectionnez d’abord l’événement que vous souhaitez enrichir.
Sélectionnez la propriété qui sera utilisée comme **matching key**, c’est-à-dire comment faire le 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 entre 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 aux événements entrants (dans le payload). Par défaut, c’est au même niveau que la matching key. 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 depuis une base de données externe. Via API, envoyez une requête avec la matching key (un ID par exemple) et l’API renvoie les données souhaitées, qui seront ensuite intégrées dans l’événement d’achat.
### Configuration
Sélectionnez les sources et les événements auxquels l’enrichissement sera appliqué.
Configurez l’API (Method, 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" %}
Bientôt disponible
{% 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 Custom Data Store
Enrichissez les événements à partir d’événements précédemment stockés.\
Cela vous permet de stocker un événement sélectionné et ses propriétés, puis de les utiliser plus tard 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 après que l’événement a été 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 stockées pendant 1 jour.
#### Correspondance des événements
* **Matching Key**: Définissez une **unique key** pour faire correspondre les événements dans le temps. Cette clé permet de relier les événements associés, ce qui permet d’utiliser les propriétés des événements passés dans les suivants.
#### Enrichissement de l’événement
* **Injection de propriétés**: Injectez automatiquement les propriétés provenant d’événements passés stocké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’usage
Imaginez qu’un client ajoute un produit à son panier, générant un `add_to_cart` event. Quelques heures plus tard, le même client finalise l’achat, générant un `purchase` event. Avec la *Enrichissement de l’événement* feature, vous pouvez enrichir le `purchase` event en temps réel avec des propriétés de l’ancien `add_to_cart` event, avant que l’événement ne soit envoyé à vos destinations.
### Comment utiliser la fonctionnalité Enrichment Event
#### Étape 1 : Créez vos paramètres de stockage
1. **Accédez aux paramètres de stockage**: Allez dans Data Governance -> Storage settings.
2. **Gérez les paramètres de stockage**: Cliquez sur "New Storage" pour créer un nouveau Storage.\\
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 : Enrichissez les événements
1. **Créez un enrichment**: Dans la section Event Enrichment, choisissez l’option Custom Data Store\\
2. **Définir l’enrichment**:
* **Nom**: Donnez un nom à votre règle d’enrichment.
* **Sélectionnez les sources et l’environnement**
* **Sélectionnez les Storage Settings** que vous souhaitez utiliser pour cet enrichment
* **Choisir un événement**: Sélectionnez l’événement que vous souhaitez enrichir.\\
* **Sélectionnez 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 "Storage Settings" 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 storage ne remplace ni n’écrase la valeur d’une propriété existante. Le storage 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.
* **Save**: Enregistrez les nouveaux paramètres d’enrichment.\\
* **Administrateurs uniquement**: Cette fonctionnalité est accessible uniquement aux utilisateurs disposant des privilèges Administrator. 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 dans le temps.
---
# Agent Instructions: 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://doc.commandersact.com/fr/fonctionnalites/enrichments/events-enrichment.md?ask=
```
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.