# Extensibilité
L’extensibilité personnalise la façon dont le connecteur résout les contacts, mappe les champs et formate les événements. Cela est principalement utilisé 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 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 casser la segmentation de production et les déclencheurs de scénarios.
{% stepper %}
{% step %}
#### Ouvrir les paramètres avancés du connecteur Bloomreach
Chaque point d’entrée a son propre emplacement de script :
* Recherche de contact
* Intercepteur d’événements
* Mappeur client
{% endstep %}
{% step %}
#### Commencez par le changement le plus petit possible
La Recherche de contact est généralement implémentée en premier lorsque l’e-mail n’est pas l’identifiant principal. L’Intercepteur d’événements est généralement implémenté en premier lorsque le nommage des événements ou la gouvernance est requis.
Garder les changements petits facilite l’isolement 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 / Notify / appliquer le privilège).
* Un événement est toujours attribué au contact Bloomreach attendu.
Lorsque l’Intercepteur d’événements est utilisé, la validation doit confirmer le nom final de l’événement et les propriétés visibles dans Bloomreach.
{% endstep %}
{% step %}
#### Déployer en production et surveiller
Une fois que le comportement en préproduction correspond aux attentes, les mêmes scripts peuvent être appliqués en production. Lorsque les événements sont utilisés comme déclencheurs de scénario, il est recommandé de déployer pendant une fenêtre de changement.
{% 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 The Wallet Crew.
{% hint style="warning" %}
Les changements peuvent impacter le suivi des événements et l’exécution des scénarios. Un environnement de préproduction est recommandé pour les tests.
{% endhint %}
### Recherche de contact
Une Carte est liée à des identifiants externes (e-mail, téléphone, member ID, ...). Lorsqu’un événement se produit sur une Carte, le connecteur doit l’associer à un contact Bloomreach.
La Recherche de contact 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 pour 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
});
}
```
### Intercepteur d’événements
L’Intercepteur d’événements 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.
Renvoyer `null` supprime l’événement.
```js
/**
* Intercepter les événements avant de les envoyer à Bloomreach.
* Utilisez cela 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