Avec l’intégration Apsis One, chaque personne qui s’inscrit est créée ou mise à jour comme profil dans Apsis One, dans la section de votre choix, et peut être inscrite à l’un de vos abonnements Apsis One.
Ce dont vous avez besoin
- Un compte Apsis One, et un utilisateur qui peut gérer les clés d’API (généralement un administrateur).
- Savoir si votre compte Apsis One se trouve dans la région Europe ou Asie. La plupart des comptes sont en Europe.
Étape 1 : créer une clé d’API dans Apsis One
- Dans Apsis One, ouvrez Account settings et allez dans API keys (sous les intégrations).
- Cliquez pour créer une nouvelle clé d’API. Donnez-lui un nom que vous reconnaissez, par exemple « Scratcher ».
- Donnez à la clé l’accès à la ou aux sections vers lesquelles Scratcher doit envoyer les profils, avec les autorisations ci-dessous.
- Enregistrez, puis copiez le Client ID et le Client secret. Le secret ne s’affiche qu’une seule fois.
Apsis propose son propre guide pas à pas pour cette étape. Il est accessible depuis le Guide de configuration de la fenêtre d’installation dans Scratcher (« Pour installer l’intégration, suivez ce guide »).
Les autorisations dont la clé a besoin
Scratcher utilise la clé pour :
- lire vos sections, ainsi que les attributs, abonnements (consent topics) et événements qu’elles contiennent, pour que vous puissiez les choisir dans la campagne ;
- créer des profils et mettre à jour leurs attributs ;
- ajouter des consentements (opt-ins) aux profils ;
- ajouter des événements aux profils.
La clé a donc besoin d’un accès en lecture aux sections et d’un accès en écriture aux profils, consentements et événements dans les sections que vous utilisez. Sans accès en écriture, les livraisons échouent avec le message d’erreur d’Apsis One.
Étape 2 : connecter Apsis One à Scratcher
- Dans Scratcher, allez dans Paramètres > Intégrations et cliquez sur Apsis One.
- Choisissez la Région de l’API : Europe ou Asie.
- Collez le ID client et le Secret client.
- Cliquez sur Installer l’intégration. Scratcher se connecte à Apsis One pour vérifier les informations.
Étape 3 : l’activer dans une campagne
- Dans l’éditeur, allez dans Connecter > Intégrations > Apsis One et cliquez sur Activer.
- Si vous avez connecté plusieurs comptes Apsis One, choisissez-le sous Choisir un compte.
- Sous Section Apsis, choisissez la section (Choisir une section).
- Sous Correspondances de champs, cliquez sur Ajouter une correspondance de champ pour chaque champ et associez le Champ Scratcher à l’attribut Apsis One dans Champ de destination. La liste affiche les attributs de la section choisie, y compris les vôtres.
- Sous Abonnements (consentements), choisissez l’abonnement auquel les personnes doivent être inscrites, ou Aucun. « Choisissez l’abonnement auquel le participant doit être inscrit. »
- 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 pour envoyer un profil de test.
Correspondance des champs
- L’adresse e-mail est toujours envoyée et sert à identifier le profil. Vous n’avez pas besoin de l’associer.
- Pour les numéros de téléphone, utilisez le réglage Format pour envoyer le numéro comme l’attend votre attribut.
- Les attributs oui/non reçoivent true ou false : associez donc le champ Accepté d’un consentement à un attribut oui/non.
Consentement
Si vous choisissez un abonnement, chaque personne y est inscrite avec le motif « Subscribed via » suivi du nom de la campagne, et la source « Scratcher ». Si la personne est déjà inscrite, rien ne change. Utilisez Filtrer par consentements pour que seules les personnes ayant coché votre case marketing soient inscrites.
Si votre section contient l’événement de formulaire de consentement d’Apsis One, Scratcher enregistre aussi l’inscription comme événement sur le profil, avec l’adresse de la campagne.
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, son profil est mis à jour. Vérifiez chaque livraison sous Paramètres > Intégrations > Statut de livraison ; vous y voyez aussi si le profil était nouveau ou existait déjà. 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 la région, et copiez à nouveau le client ID et le secret.
- Les livraisons échouent avec une erreur d’accès d’Apsis One : la clé n’a pas accès à la section, ou il lui manque des autorisations en écriture. Modifiez la clé dans Apsis One.
- Abonnements (consentements) est vide : la section n’a pas encore d’abonnement. Créez-en un dans Apsis One et rouvrez l’intégration.