Présentation de l’extension de transfert d’événement Mailchimp
L’extension Mailchimp event transfert envoie des événements à l’API Mailchimp Marketing qui peut déclencher des courriers électroniques pour les campagnes, parcours ou transactions marketing Mailchimp.
Ce document explique comment configurer l’extension et les règles à l’aide de l’action Ajouter un événement .
Conditions préalables
Ce document suppose que vous connaissez les produits Mailchimp pertinents utilisés par l’extension. Pour plus d’informations, consultez la documentation d’aide de Mailchimp pour campaigns, parcours et transactions.
Un compte Mailchimp est requis pour utiliser cette extension. Vous pouvez vous abonner à un compte ici. Dans le tableau de bord du compte Mailchimp, notez les valeurs suivantes à utiliser dans ce guide :
- Votre préfixe de domaine Mailchimp
- Votre clé API
- ID d’audience
- Adresse email "expéditeur" par défaut
En fonction de votre forfait de compte Mailchimp, vous avez peut-être un accès limité aux outils de Parcours client Mailchimp.
Préfixe de domaine
Après vous être connecté à Mailchimp et avoir accédé à la vue Tableau de bord, la barre d’adresse de votre navigateur doit afficher une URL du type https://us11.admin.mailchimp.com
ou seulement us11.admin.mailchimp.com
. Dans cet exemple, le préfixe us11
n’est qu’un espace réservé et votre valeur sera différente. Enregistrez votre URL avec votre préfixe pour une étape ultérieure.
Clé API
Pour trouver la clé d’API de votre compte, sélectionnez l’icône de votre profil dans l’interface utilisateur Mailchimp, puis sélectionnez Profil. Vous devriez voir une URL du type https://us11.admin.mailchimp.com/account/profile/
mais avec le préfixe votre au lieu de us11
.
Sélectionnez Extras, puis Clés API :
Sous Vos clés d’API, vous pouvez choisir une clé existante ou sélectionner Créer une clé pour en créer une nouvelle. Vous pouvez créer une clé à utiliser spécifiquement avec cette extension. Copiez la clé API et enregistrez-la pour une étape ultérieure. Pour plus d’informations, consultez la documentation de Mailchimp sur la façon de générer votre clé API.
ID d’audience et adresse de l’expéditeur
Sélectionnez Audience dans le volet de navigation de gauche, puis Tableau de bord d’audience. Sélectionnez ensuite l’audience que vous prévoyez d’utiliser avec cette extension. Pour en savoir plus, consultez le document Mailchimp sur la création d’une audience.
Une fois l’audience créée et sélectionnée, sélectionnez la liste déroulante Gérer l’audience et choisissez Paramètres. Cet écran affiche divers paramètres pour votre audience.
Au bas de l’écran Paramètres, vous devriez voir Unique id for audience [audience name]
où [audience name]
est le nom de votre audience réelle. Copiez l’ID d’audience et enregistrez-le pour une étape ultérieure.
Sélectionnez Nom de l’audience et valeurs par défaut et confirmez que l’ adresse électronique par défaut de l’expéditeur a la valeur correcte pour vos campagnes. Notez que l’ID d’audience est également répertorié en haut de cette page et est la même valeur que celle que vous avez copiée à l’étape précédente.
Automatisations de Mailchimp
Selon votre forfait Mailchimp et si vous utilisez des emails transactionnels, des Parcours client ou d’autres automatisations Mailchimp, vos paramètres de parcours spécifiques peuvent varier.
Installation et configuration
Cette section répertorie les étapes d’installation et de configuration de l’extension. Pour enregistrer la clé API Mailchimp en toute sécurité, vous devez utiliser le transfert d’événement secrets.
Création d’un secret et d’un élément de données
Dans une propriété de transfert d'événement, créez un secret appeléMailchimp API Key
.
Ensuite, créez un élément de données à l’aide de l’extension Core et d’un type d’élément de données Secret pour référencer le secret Mailchimp API Key
que vous venez de créer. Saisissez Mailchimp Token
comme nom de l’élément de données.
Installation et configuration de l’extension
Dans la même propriété de transfert d’événement, sélectionnez Extensions,, puis Catalogue pour afficher les extensions disponibles pour l’installation. À partir de là, recherchez l’extension Mailchimp et sélectionnez Install.
L’écran de configuration s’affiche. Sous Mailchimp Server Prefix Domain Name, saisissez le domaine que vous avez copié précédemment à partir de votre compte Mailchimp, y compris votre préfixe de domaine unique.
http://
ou https://
dans ce champ.
Sous Mailchimp token, sélectionnez l’icône de l’élément de données et choisissez l’élément de données Mailchimp Token
que vous avez créé précédemment. Sélectionnez Enregistrer pour enregistrer les modifications.
L’extension est maintenant installée et configurée pour être utilisée dans votre propriété.
Collecte de données
Lors de l’utilisation de cette extension dans une règle, il existe plusieurs valeurs de données que l’extension envoie à Mailchimp avec chaque événement. Pour une mise en oeuvre type, vous pouvez configurer l’ extension SDK Web Adobe Experience Platform pour envoyer ces données à Platform Edge Network en vue de les utiliser par l’extension dans la propriété de transfert d’événement.
Les données requises par cette extension peuvent être envoyées à partir du SDK Web sous forme de données XDM (à l’aide de l’objet xdm
) ou de données non XDM (à l’aide de l’objet data
).
Par exemple, si un client effectue un achat ou s’inscrit pour un événement sur votre site, vous pouvez envoyer un email de confirmation par le biais de Mailchimp avec cette extension. Une fois que vous avez envoyé les informations requises du SDK Web à l’Edge Network, l’extension déclenche l’e-mail avec Mailchimp.
Éléments de données
La capture d’écran de la section précédente montre les données que vous pouvez envoyer avec chaque événement de cette extension à Mailchimp. Une fois que vous avez configuré le SDK Web pour envoyer ces données à l’Edge Network, vous pouvez créer des éléments de données dans la propriété de transfert d’événement afin que l’extension puisse accéder à ces valeurs.
Le tableau ci-dessous fournit des détails supplémentaires pour chaque valeur possible.
email
arc.event.xdm._tenant.emailId
ou
arc.event.data._tenant.emailId
listId
arc.event.xdm._tenant.listId
ou
arc.event.data._tenant.listid
name
arc.event.xdm._tenant.name
ou
arc.event.data._tenant.name
properties
arc.event.xdm._tenant.properties
ou
arc.event.data._tenant.properties
isSyncing
arc.event.xdm._tenant.isSyncing
ou
arc.event.data._tenant.isSyncing
is_syncing
défini sur true
ne déclencheront pas des automatisationsoccurredAt
arc.event.xdm._tenant.occuredAt
ou
arc.event.data._tenant.occuredAt
.Dans la propriété de transfert d’événement, vous pouvez créer un élément de données pour chacun des champs décrits ci-dessus. Une fois créés, vous pouvez référencer les éléments de données dans l’action Ajouter un événement de cette extension.
Vous pouvez maintenant utiliser cette extension et l’action Ajouter un événement pour déclencher les emails des chimpanzés de courrier électronique pour vos audiences.
Validation des données
Lorsque vous utilisez des extensions de transfert d’événement, l’ Adobe Experience Platform Debugger est très utile. Dans la section Journaux , sous Journaux Edge , vous pouvez voir les demandes effectuées par vos règles de transfert d’événement après leur déclenchement. Les captures d’écran suivantes présentent une demande envoyée à l’API Mailchimp par l’extension.
Dans le tableau de bord Mailchimp, dans la vue Flux d’activité de votre audience ou membre d’audience, une liste d’événements pour ce membre d’audience ou d’audience est fournie. Cela doit correspondre aux événements envoyés par l’extension et afficher toutes les données facultatives envoyées, ainsi que l’email ou la campagne qu’ils ont reçu. Pour plus d’informations, consultez les guides d’aide sur l’automatisation de l’envoi de courrier électronique .