Avec l’intégration Mapp, chaque personne qui s’inscrit est créée ou mise à jour comme contact dans Mapp Engage et ajoutée au groupe (liste) de votre choix.
Ce dont vous avez besoin
- Un compte Mapp Engage, et un utilisateur qui peut créer des utilisateurs système (généralement un administrateur).
- L’adresse API de votre Mapp Engage. C’est l’adresse de votre système Mapp Engage suivie du chemin de l’API ; vous la trouvez dans la documentation API de Mapp pour votre système, ou en la demandant au support de Mapp.
Étape 1 : créer un utilisateur API dans Mapp Engage
Mapp Engage utilise un utilisateur distinct pour l’API, avec un nom d’utilisateur et un mot de passe.
- Dans Mapp Engage, allez dans Administration > System Users.
- Créez un nouvel utilisateur système et nommez-le par exemple « Scratcher ».
- Donnez à l’utilisateur le rôle API (accès API), avec les droits ci-dessous.
- Définissez un mot de passe robuste et enregistrez. Copiez le nom d’utilisateur et le mot de passe.
Les droits dont l’utilisateur API a besoin
Scratcher utilise cet utilisateur pour :
- lire vos groupes, pour que vous puissiez en choisir un dans la campagne ;
- lire vos attributs de contact, pour que vous puissiez y associer des champs ;
- créer et mettre à jour des contacts ;
- ajouter des contacts à des groupes (les abonner).
L’utilisateur n’a pas besoin d’accéder aux messages, aux rapports ou à quoi que ce soit d’autre.
Étape 2 : connecter Mapp à Scratcher
- Dans Scratcher, allez dans Paramètres > Intégrations et cliquez sur Mapp.
- Collez l’adresse API, le nom d’utilisateur et le mot de passe dans les champs correspondants.
- Cliquez sur Installer l’intégration. Scratcher vérifie qu’il peut lire vos groupes.
Étape 3 : l’activer dans une campagne
- Dans l’éditeur, allez dans Connecter > Intégrations > Mapp et cliquez sur Activer.
- Si vous avez connecté plusieurs comptes, choisissez-le sous Choisir un compte.
- Sous Liste externe, choisissez le groupe Mapp.
- Sous Correspondances de champs, cliquez sur Ajouter une correspondance de champ et associez chaque Champ Scratcher à un attribut Mapp, par exemple « Lead - Prénom » à FirstName.
- Sous Filtrer par consentements (facultatif), choisissez votre case de consentement marketing.
- Cliquez sur Enregistrer, puis sur Tester.
Correspondance des champs
- L’adresse e-mail est toujours envoyée et identifie le contact. Vous n’avez pas besoin de l’associer.
- La liste Champ de destination affiche les attributs standard et personnalisés de votre système Mapp. Créez d’abord les attributs personnalisés dans Mapp.
- Pour les numéros de mobile, utilisez le réglage Format. Mapp attend généralement + et l’indicatif pays.
Consentement
Les contacts sont abonnés au groupe que vous choisissez. Si le groupe utilise le double opt-in dans Mapp, Mapp envoie son propre e-mail de confirmation, et les personnes ne sont abonnées qu’une fois qu’elles ont confirmé. Utilisez Filtrer par consentements pour n’ajouter que les personnes qui ont coché votre case marketing.
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 contact est mis à jour. Vérifiez chaque livraison sous Paramètres > Intégrations > Statut de livraison.
Dépannage
- « Certains champs, voire tous, ne sont pas valides... » lors de l’installation : vérifiez l’adresse API, et que l’utilisateur système a le rôle API et n’est pas bloqué.
- Les livraisons échouent avec une erreur d’accès : il manque à l’utilisateur système l’un des droits ci-dessus.
- Le mot de passe a expiré : certains systèmes Mapp font expirer les mots de passe. Définissez un nouveau mot de passe dans Mapp et reconnectez-vous avec Ajouter un compte.