Configuration

Configurez le connecteur The Wallet Crew, connectez les identifiants Bloomreach et installez les activités prédéfinies WebHook Bloomreach.

Connecter Bloomreach Engagement avec L'équipe Wallet pour orchestrer des parcours Wallet. Les scénarios Bloomreach peuvent déclencher des actions Carte (créer, mettre à jour, notifier). The Wallet Crew envoie également des événements à Bloomreach pour la segmentation et la mesure.

Une configuration minimale de bout en bout prend généralement 1 à 2 heures. Cela suppose que les droits d'accès et une Carte de test sont disponibles pour valider le flux.

Prérequis

Avant de commencer, assurez-vous d'avoir :

• autorisations Bloomreach

  • Accès à Paramètres du projet → Intégrations.
  • Accès aux identifiants API dans Paramètres du projet → Gestion des accès → API.
• Les autorisations de The Wallet Crew

  • Accès à la console d'administration pour configurer le connecteur Bloomreach.
  • Autorisation de créer et de gérer des clés API.
• Environnement et données de test

  • Environnement cible identifié (staging ou production).
  • Une Carte de test existe, avec un passId, pour valider les appels de bout en bout.
  • Toute mise en liste d'autorisation réseau et toute contrainte de sécurité requises sont en place.

La configuration de The Wallet Crew

1

Activer le connecteur

Le connecteur Bloomreach doit être activé pour le locataire. Cela est généralement effectué par l'équipe The Wallet Crew.

2

Configurer les paramètres généraux

Ouvrez les paramètres du connecteur Bloomreach dans le back-office de Wallet Crew.

Ouvrir la page des paramètres généraux

Les paramètres généraux définissent la manière dont The Wallet Crew s'authentifie auprès de Bloomreach.

Renseignez :

• Jeton du projet
• URL de base de l'API
• ID de la clé API
• Secret API

Les valeurs Bloomreach sont disponibles dans Paramètres du projet → Gestion des accès → API.

Le jeton du projet détermine l'environnement cible. Cela permet de séparer le staging et la production.

Utilisez un jeton et une clé API associés au bon environnement Bloomreach.

3

Paramètres avancés (extensibilité)

Les paramètres avancés exposent des points d'entrée de script pour le connecteur. Ces scripts contrôlent la résolution des contacts, la transformation des événements et le mappage des champs.

Les paramètres avancés sont utilisés pour les modèles de données personnalisés et la gouvernance.

Détails et exemples de scripts : Extensibilité.

Configuration Bloomreach

1

Configurez un schéma d'authentification HTTP

Bloomreach appelle les API de The Wallet Crew à l'aide d'une clé API. Cela est configuré une seule fois comme schéma d'authentification HTTP dans Bloomreach.

Dans Bloomreach :

1. Allez à Données et ressources → Intégrations → + Ajouter une nouvelle intégration.

1. Sélectionner Schémas d’authentification HTTP.

1. Configurez le schéma avec une clé API créée dans l'équipe Wallet.

Une clé API du Wallet Crew avec locataire.carte:écrire une autorisation est requise. Les clés API sont gérées dans la console d’administration Wallet Crew.

Configuration des clés Open API

Valeurs du schéma Bloomreach :

Point de terminaison	https://app.neostore.cloud/api (production) ou https://app-qa.neostore.cloud/api (staging)
Type	En-têtes personnalisés
Clé	X-API-KEY
Valeur	La clé API de l’équipe Wallet Crew

2

Installez les activités prédéfinies WebHook

Les activités Bloomreach sont installées en tant qu’intégrations prédéfinies WebHook. Une intégration Bloomreach est généralement créée par activité.

Seules les activités nécessaires doivent être installées. Cela simplifie la création de scénarios et réduit les écarts de configuration.

Les icônes d’activité sont disponibles sous forme de fichier :

6KB

twc-bloomreach-icons.zip

archive

Ouvrir

Les exemples de charge utile utilisent la syntaxe des paramètres prédéfinis de Bloomreach WebHook.

Mettre à jour la carte ("Push Update")

URL du point de terminaison :

PATCH https://app.neostore.cloud/api/<<tenantId>>/passes/?id=[[ {name: 'passId', tooltip: 'Identifiant de la carte', category: 'Carte cible', isJsonParam: true} : string]]

Charge utile minimale (options uniquement) :

{
  "options": {
    "correlationId": "[[ {name: 'Correlation Id', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : string]]"
  }
}

Exemple de charge utile à mettre à jour additionalData:

{
  "additionalData": {
    "xx": "[[ {name: 'xx', tooltip: 'xx', category: 'Contenu', orderIndex: 10, isJsonParam: true} : string]]",
    "xy": "[[ {name: 'xy', tooltip: 'xy', category: 'Contenu', orderIndex: 11, isJsonParam: true} : string]]"
  },
  "options": {
    "correlationId": "[[ {name: 'Correlation Id', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : string]]"
  }
}

Exemple de charge utile pour modifier le modèle de Carte (CarteType):

{
  "passType": "newTemplate",
  "options": {
    "correlationId": "[[ {name: 'Correlation Id', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : string]]"
  }
}

Référence de l’API : Référence de l’API.

Notifier

URL du point de terminaison :

PATCH https://app.neostore.cloud/api/<<tenantId>>/passes/notification?id=[[ {name: 'passId', tooltip: 'Identifiant de la Carte', category: 'Cible de la Carte', isJsonParam: true} : string]]

Exemple de charge utile (une seule langue) :

{
  "content": "[[ {name: 'Contenu de la notification', tooltip: 'Contenu de la notification', category: 'Contenu', orderIndex: 10, isJsonParam: true} : string]]",
  "options": {
    "updateData": [[ {name: 'Mettre à jour les données', tooltip: 'Met également à jour les données de la Carte lorsque la notification est envoyée', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : boolean | false]],
    "correlationId": "[[ {name: 'Correlation Id', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : string]]"
  }
}

Exemple de charge utile (localisée) :

{
  "localizedContent": {
    "en": "[[ {name: 'Contenu de la notification (en)', tooltip: 'Contenu de la notification', category: 'Contenu', orderIndex: 10, isJsonParam: true} : string]]",
    "fr": "[[ {name: 'Contenu de la notification (fr)', tooltip: 'Contenu de la notification', category: 'Contenu', orderIndex: 11, isJsonParam: true} : string]]"
  },
  "options": {
    "updateData": [[ {name: 'Mettre à jour les données', tooltip: 'Met également à jour les données de la Carte lorsque la notification est envoyée', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : boolean | false]],
    "correlationId": "[[ {name: 'Correlation Id', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 20, isJsonParam: true} : string]]"
  }
}

Référence de l’API : Référence de l’API.

Appliquer un privilège

URL du point de terminaison :

POST https://app.neostore.cloud/api/<<tenantId>>/passes/[[ {name: 'passId', tooltip: 'Identifiant de la carte', category: 'Carte cible', isJsonParam: true} : string]]/privileges

Exemple de charge utile (privilège non localisé) :

{
  "type": "multiUse",
  "origin": {
    "generator": "bloomreach",
    "processId": "[[ {name: 'Identifiant du processus', tooltip: 'Identifiant du scénario / de la campagne', category: 'Configuration avancée', orderIndex: 120, isJsonParam: true} : string]]"
  },
  "priority": [[ {name: 'Priorité', tooltip: 'Les valeurs élevées indiquent une priorité plus forte', category: 'Configuration avancée', orderIndex: 110, isJsonParam: true} : number]],
  "contenu": {
    "titre": {
      "value": "[[ {name: 'Titre', tooltip: 'Titre de ce privilège', category: 'Contenu', orderIndex: 10, isJsonParam: true} : string]]"
    },
    "description": {
      "value": "[[ {name: 'Description', tooltip: 'Description de ce privilège', category: 'Contenu', orderIndex: 20, isJsonParam: true} : string]]"
    }
  },
  "apparence": {
    "urlImagePrincipale": {
      "value": "[[ {name: 'Image principale', tooltip: 'URL de l'image principale', category: 'Contenu', orderIndex: 30, isJsonParam: true} : image]]"
    }
  },
  "options": {
    "correlationId": "[[ {name: 'Identifiant de corrélation', tooltip: 'Identifiant de regroupement pour associer plusieurs actions', category: 'Configuration avancée', orderIndex: 130, isJsonParam: true} : string]]"
  }
}

Référence de l’API : Référence de l’API.

Les points de terminaison incluent <<tenantId>>. Remplacez-le par l'identifiant du locataire de The Wallet Crew.

Pour en savoir plus sur les activités : les activités Bloomreach.

Checklist de validation

Une exécution de validation minimale couvre généralement :

• Une Carte de test existe et son passId est disponible dans Bloomreach.
• Une activité Mettre à jour la Carte actualise le contenu visible sur la Carte.
• Une activité Notify envoie un message.
• Une installation/désinstallation de test génère des événements Bloomreach.

Noms et propriétés des événements : Événements.

Bonnes pratiques

• Préproduction d'abord: validez les activités et les événements dans un jeton de projet Bloomreach de test.
• Déploiement progressif: installez d'abord uniquement Notify, puis ajoutez le privilège Apply.
• Configuration multi-équipes: l'IT configure les identifiants et les listes d'autorisation, le marketing installe les activités du scénario.

FAQ

Qui est généralement responsable de la configuration ?

L'activation du connecteur et les identifiants sont généralement gérés par l'IT ou un partenaire d'implémentation. L'installation des activités et l'utilisation du scénario relèvent souvent de l'équipe CRM ou des opérations marketing.

Quel environnement doit être configuré en premier ?

Un environnement de préproduction est généralement configuré en premier. Cela permet de valider les activités, les événements et les scripts avant la production.

Quelles autorisations sont requises pour la clé API utilisée par Bloomreach ?

Une clé avec locataire.carte:écrire autorisation est requise pour les activités qui mettent à jour les Cartes. Des autorisations supplémentaires peuvent être requises selon l'ensemble d'activités.