Avec l’intégration Bloomreach, chaque personne qui s’inscrit est créée ou mise à jour comme client dans votre projet Bloomreach Engagement, identifiée par son adresse e-mail. Vous pouvez aussi lui attribuer un consentement Bloomreach, pour pouvoir lui envoyer du marketing.
Ce dont vous avez besoin
- Un projet Bloomreach Engagement, et un utilisateur qui peut gérer l’accès API dans les paramètres du projet (généralement un administrateur du projet).
Étape 1 : créer une clé d’API dans Bloomreach
- Dans Bloomreach Engagement, ouvrez le projet et allez dans Project settings > Access management > API.
- Copiez le Project token et l’API base URL affichés sur la page.
- Sous les groupes d’API, créez un nouveau groupe avec Private access, et nommez-le par exemple « Scratcher ».
- Créez une nouvelle clé d’API dans le groupe. Copiez l’API key ID et l’API secret. Le secret ne s’affiche qu’une seule fois.
- Donnez au groupe les autorisations ci-dessous et enregistrez.
Les autorisations dont la clé a besoin
Dans les autorisations du groupe, autorisez :
- Customer properties : get et set, pour retrouver les clients et les créer ou les mettre à jour, et pour afficher vos propriétés client dans la correspondance des champs.
- Events : set, pour l’événement
consent, afin que Scratcher puisse enregistrer les consentements.
Rien d’autre n’est nécessaire. Sans les autorisations set, les livraisons échouent avec l’erreur d’accès de Bloomreach.
Étape 2 : connecter Bloomreach à Scratcher
- Dans Scratcher, allez dans Paramètres > Intégrations et cliquez sur Bloomreach.
- Collez l’API base URL, le project token, l’API key ID et l’API secret dans les champs correspondants.
- Cliquez sur Installer l’intégration. Scratcher vérifie les informations auprès de Bloomreach.
Étape 3 : l’activer dans une campagne
- Dans l’éditeur, allez dans Connecter > Intégrations > Bloomreach et cliquez sur Activer.
- Si vous avez connecté plusieurs projets, choisissez-le sous Choisir un compte.
- Sous Correspondances de champs, cliquez sur Ajouter une correspondance de champ et associez chaque Champ Scratcher à une propriété client Bloomreach, par exemple « Lead - Prénom » à first_name.
- Choisissez la catégorie de consentement que les personnes doivent recevoir, par exemple « newsletter », ou aucune.
- Sous Filtrer par consentements (facultatif), choisissez votre case de consentement marketing, pour n’envoyer que les personnes qui l’ont cochée.
- Cliquez sur Enregistrer, puis sur Tester.
Bon à savoir : Bloomreach n’a pas de listes. Tout le monde va dans le projet, et vous les regroupez avec des segments dans Bloomreach. Scratcher commence donc à envoyer dès que vous cliquez sur Activer. Activez l’intégration avant la mise en ligne de la campagne, ou configurez-la tout de suite.
Correspondance des champs
- L’adresse e-mail est toujours envoyée et sert à retrouver le client. Vous n’avez pas besoin de l’associer.
- La liste Champ de destination affiche les propriétés client de votre projet. S’il manque une propriété, créez-la d’abord dans Bloomreach.
- Pour indiquer d’où viennent les clients, associez une Utiliser une valeur personnalisée comme « Jeu d’été Scratcher » à une propriété que vous utilisez pour la source.
Consentement
Si vous choisissez une catégorie de consentement, Scratcher enregistre un événement consent avec l’action accept et le nom de la campagne comme source. La catégorie doit exister dans Bloomreach (dans les réglages de consentement sous Project settings). Utilisez Filtrer par consentements pour que seules les personnes ayant coché votre case marketing reçoivent le consentement.
Ce qui est envoyé, et quand
Les nouveaux inscrits sont envoyés en une à deux minutes. Quand vous activez l’intégration, les leads existants de la campagne sont aussi envoyés. Quand quelqu’un participe à nouveau, le client est mis à jour. Vérifiez chaque livraison sous Paramètres > Intégrations > Statut de livraison. Voir Vérifier le statut de livraison et renvoyer des leads.
Dépannage
- « Certains champs, voire tous, ne sont pas valides... » lors de l’installation : vérifiez l’API base URL et le project token, et copiez à nouveau l’ID de clé et le secret.
- Les livraisons échouent avec une erreur d’accès : il manque au groupe d’API l’une des autorisations ci-dessus. Modifiez-le dans Bloomreach.
- Le consentement n’apparaît pas sur le client : la catégorie de consentement n’existe pas dans Bloomreach, ou elle est orthographiée différemment.
- Bloomreach propose ses propres guides sur les clés d’API. Cherchez « API access management » dans la documentation de Bloomreach si les menus sont différents.