Présentation de l’extension de transfert d’événement Mailchimp
Le Mailchimp transfert d’événement L’extension envoie des événements à l’API marketing Mailchimp qui peut déclencher des courriers électroniques pour des campagnes marketing, des parcours ou des transactions 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 campagnes, parcours, et transactions.
Un compte Mailchimp est requis pour utiliser cette extension. Vous pouvez vous inscrire à un compte here. 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 telle que https://us11.admin.mailchimp.com
ou juste 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é API de votre compte, sélectionnez l’icône de votre profil dans l’interface utilisateur de messagerie, puis cliquez sur Profil. Vous devriez voir une URL comme https://us11.admin.mailchimp.com/account/profile/
mais avec your préfixe au lieu de us11
.
Sélectionner Extras, puis Clés API:
Sous Vos clés d’API, vous pouvez choisir une clé existante ou sélectionner Création D’Une Clé pour en créer un. 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électionner Audience dans la navigation de gauche, puis Tableau de bord Audience. Sélectionnez ensuite l’audience que vous prévoyez d’utiliser avec cette extension. Pour en savoir plus, consultez le document Mailchimp sur création d’une audience.
Une fois votre audience créée et sélectionnée, sélectionnez la variable Gestion de l’audience menu déroulant 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]
where [audience name]
est le nom de votre audience réelle. Copiez l’ID d’audience et enregistrez-le pour une étape ultérieure.
Sélectionner Nom et valeurs par défaut de l’audience et confirmez que Adresse électronique de l’expéditeur par défaut 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éer une Jeton secret appelé Mailchimp API Key
.
Ensuite, créer un élément de données ; en utilisant la variable Core et une Secret type d’élément de données pour référencer la variable Mailchimp API Key
secret que vous venez de créer. Entrée 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, then Catalogue pour afficher les extensions disponibles pour l’installation. À partir de là, recherchez l’extension Mailchimp et sélectionnez Installer.
L’écran de configuration s’affiche. Sous Nom de domaine du préfixe de serveur Mailchimp, 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 Jeton Mailchimp, sélectionnez l’icône de l’élément de données et choisissez la variable Mailchimp Token
élément de données que vous avez créé précédemment. Sélectionner 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
Lorsque vous utilisez 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 la variable Extension SDK Web Adobe Experience Platform pour envoyer ces données à Platform Edge Network à 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 la forme de données XDM (à l’aide de la variable xdm
) ou des données autres que 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 vers le réseau Edge, l’extension déclenche le courrier électronique 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 au réseau Edge, 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
will not automates de déclenchementoccurredAt
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 le 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, la variable Adobe Experience Platform Debugger est très utile. Dans la section Logs (Journaux), sous Edge logs, vous pouvez voir les requêtes 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. Voir Guides d’aide sur l’automatisation des emails pour plus d’informations.