> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/connectors/fr/marketing-automation/bloomreach/extensibility.md).
# Extensibilité
L’extensibilité personnalise la façon dont le connecteur résout les contacts, mappe les champs et formate les événements. Elle est principalement utilisée par les équipes techniques lorsque le comportement par défaut ne correspond pas au modèle de données.
## Configuration
L’extensibilité est configurée dans la console d’administration de The Wallet Crew. Chaque point d’entrée est un script JavaScript stocké dans le connecteur Bloomreach **Paramètres avancés**.
La préproduction est le point de départ recommandé. Cela réduit le risque de perturber la segmentation de production et les déclencheurs de scénario.
{% stepper %}
{% step %}
#### Ouvrez les paramètres avancés du connecteur Bloomreach
Chaque point d’entrée a son propre emplacement de script :
* Contact Finder
* Event Interceptor
* Customer Mapper
{% endstep %}
{% step %}
#### Commencez par le changement le plus petit possible
Contact Finder est généralement implémenté en premier lorsque l’e-mail n’est pas l’identifiant principal. Event Interceptor est généralement implémenté en premier lorsque la nomenclature des événements ou la gouvernance est requise.
Limiter les changements facilite l’isolation des problèmes d’attribution et d’ingestion.
{% endstep %}
{% step %}
#### Validez le comportement de bout en bout
La validation couvre généralement les deux sens du connecteur :
* Une activité fonctionne toujours (Mettre à jour la Carte / Notifier / Appliquer le privilège).
* Un événement est toujours attribué au contact Bloomreach attendu.
Lorsque Event Interceptor est utilisé, la validation doit confirmer le nom final de l’événement et les propriétés visibles dans Bloomreach.
{% endstep %}
{% step %}
#### Déployez en production et surveillez
Une fois que le comportement en préproduction correspond aux attentes, les mêmes scripts peuvent être appliqués à la production. Lorsque les événements sont utilisés comme déclencheurs de scénario, un déploiement pendant une fenêtre de changement est recommandé.
{% endstep %}
{% endstepper %}
## Points d’entrée de l’extensibilité
Les scripts du connecteur sont configurés dans les paramètres avancés du connecteur Bloomreach dans la console d’administration de The Wallet Crew.
{% hint style="warning" %}
Les changements peuvent avoir un impact sur le suivi des événements et l’exécution des scénarios. Un environnement de préproduction est recommandé pour les tests.
{% endhint %}
### Contact Finder
Une Carte est liée à des identifiants externes (e-mail, téléphone, ID membre, ...). Lorsqu’un événement se produit sur une Carte, le connecteur doit l’associer à un contact Bloomreach.
Contact Finder personnalise la façon dont ces identifiants sont convertis en identifiants de contact Bloomreach.
```js
/**
* Récupérer l’identifiant de contact à partir des identifiants de la Carte afin de déterminer le contact Bloomreach d’une Carte.
* L’implémentation par défaut utilise l’e-mail comme identifiant enregistré
*
* Cette méthode est asynchrone, ce qui permet d’appeler des services web externes si nécessaire.
*
* @param {Record} identifiers - Paires clé-valeur des identifiants de la Carte
* @returns {Promise>} Objet avec la clé 'registered' contenant l’identifiant de contact côté Bloomreach
*/
async function getContactIdentifiers(identifiers) {
// Exemple : utiliser l’e-mail comme identifiant de contact
// il s’agit de l’implémentation par défaut
return { "registered": identifiers["email"] };
}
export default function (context) {
context.register('extensions.bloomreach.contactFinder', {
GetContactIdentifiers: getContactIdentifiers
});
}
```
### Event Interceptor
Event Interceptor peut transformer `eventName` et `properties` avant d’envoyer l’événement à Bloomreach. C’est utile pour les conventions de nommage, le filtrage et l’enrichissement.
En renvoyant `null` supprime l’événement.
```js
/**
* Intercepter les événements avant leur envoi à Bloomreach.
* Utiliser ceci pour transformer dynamiquement les noms d’événements ou les propriétés.
* Exemple : ajouter des champs calculés, renommer des propriétés, filtrer des données
*
* @param {Object} eventData - Objet de données d’événement
* @param {string} eventData.Name - Nom de l’événement suivi
* @param {Record} eventData.Properties - Attributs/métadonnées de l’événement
* @returns {Promise