Connexion Mailchimp Interest Categories
Mailchimp est une plateforme d’automatisation du marketing et un service de marketing par e-mail utilisé par les entreprises pour gérer et communiquer avec des contacts (clients ou autres parties intéressées) à l’aide de listes de diffusion et de campagnes de marketing par e-mail. Utilisez ce connecteur pour trier vos contacts en fonction de leurs centres d’intérêt et de leurs préférences.
Mailchimp Interest Categories utilise les audiences, groupes et catégories d’intérêt (également appelées noms de groupe ou titres de groupe). Chaque groupe de Mailchimp est une liste de catégories d’intérêt. Les contacts sont associés à une catégorie d’intérêt lorsqu’ils s’abonnent à une ou plusieurs catégories d’intérêt par le biais d’un formulaire d’inscription sur votre site web. Au sein d’une audience, vous pouvez également organiser les contacts en groupes et les associer à des catégories d’intérêt, qui pourront ensuite être utilisées pour créer des segments. Vous pouvez utiliser ces audiences pour diffuser des e-mails de campagne ciblés aux contacts abonnés.
Cette Adobe Experience Platform destination utilise l’API Mailchimp batch subscribe or unsubscribe API pour créer des catégories d’intérêt puis ajouter des contacts de chacune des audiences Experience Platform sélectionnées dans une catégorie d’intérêt correspondante. Vous pouvez ajouter de nouveaux contacts ou mettre à jour les informations des contacts Mailchimp existants, puis ajouter ou supprimer ces contacts de leurs groupes souhaités dans une audience Mailchimp existante après les avoir activés dans un nouveau segment. Mailchimp Interest Groups utilise les noms d’audience sélectionnés dans Experience Platform en tant que catégories d’intérêt dans Mailchimp.
Cas d’utilisation use-cases
Pour mieux comprendre quand et comment utiliser la destination Mailchimp Interest Categories, consultez l’exemple de cas d’utilisation ci-dessous que les clientes et clients d’Adobe Experience Platform peuvent résoudre à l’aide de cette destination.
Envoyer des e-mails aux contacts pour les campagnes marketing use-case-send-emails
Le service commercial d’un site web d’articles de sport souhaite diffuser une campagne marketing par e-mail à une liste de contacts qui se sont auto-identifiés comme étant intéressés par le football. Les listes de contacts sont séparées sous forme de lots dans l’exportation des données reçues de l’équipe de développement du site web et doivent donc être suivies. L’équipe identifie une audience Mailchimp existante et commence à créer les audiences Experience Platform dans lesquelles les contacts de chaque liste sont ajoutés. Après avoir envoyé ces audiences à Mailchimp Interest Categories, si des contacts n’existent pas dans l’audience Mailchimp sélectionnée, ils sont ajoutés à un groupe avec le nom d’audience auquel le contact appartient. Si des contacts existent déjà dans l’audience ou le groupe Mailchimp, leurs informations sont mises à jour. Une fois les données envoyées à Mailchimp Interest Categories, l’équipe des ventes peut sélectionner et envoyer l’e-mail de campagne marketing au groupe d’intérêt football de l’audience Mailchimp.
Conditions préalables prerequisites
Reportez-vous aux sections ci-dessous pour connaître les conditions préalables à configurer dans Experience Platform et Mailchimp et pour obtenir des informations que vous devez rassembler avant d’utiliser la destination Mailchimp Interest Categories.
Conditions préalables dans Experience Platform prerequisites-in-experience-platform
Avant d’activer des données dans la destination Mailchimp Interest Categories, vous devez avoir un schéma, un jeu de données, ainsi que des segments créés dans Experience Platform.
Conditions préalables pour la destination Mailchimp Interest Categories prerequisites-destination
Notez les conditions préalables suivantes pour exporter des données d’Experience Platform vers votre compte Mailchimp :
Vous devez disposer d'un compte Mailchimp prerequisites-account
Avant de pouvoir créer une destination Mailchimp Interest Categories, vous devez d’abord vous assurer que vous disposez d’un compte Mailchimp. Si vous n’en avez pas encore, rendez-vous sur la Mailchimp page d’inscription pour vous inscrire et créer votre compte.
Collecter la clé API Mailchimp gather-credentials
Vous avez besoin de votre Mailchimp clé API pour authentifier la destination Mailchimp Interest Categories sur votre compte Mailchimp. La clé API sert de mot de passe lorsque vous authentifiez la destination.
Si vous ne disposez pas de votre clé API, connectez-vous à votre compte et reportez-vous à la documentation Mailchimp Générer votre clé API pour en créer une.
Un exemple de clé API est 0123456789abcdef0123456789abcde-us14.
Identification Mailchimp centre de données identify-data-center
Ensuite, vous devez identifier votre centre de données Mailchimp. Pour ce faire, connectez-vous à votre compte Mailchimp et accédez à la section Clés API de votre compte.
La valeur est la première partie de l’URL que vous voyez dans votre navigateur. Si l’URL est https://us14.mailchimp.com/account/api/, le centre de données est us14.
Elle est également ajoutée à votre clé API sous la forme key-dc ; si votre clé API est 0123456789abcdef0123456789abcde-us14, le centre de données est us14.
Notez la valeur du centre de données (us14 dans cet exemple) vous avez besoin de cette valeur lorsque vous renseignez les détails de la destination.
Si vous avez besoin de conseils supplémentaires, consultez la Mailchimp documentation sur les principes de base.
Mécanismes de sécurisation guardrails
Chacune de vos audiences Mailchimp peut contenir jusqu’à 60 noms de groupe (ou catégories d’intérêt) dans un seul groupe ou dans plusieurs groupes au sein d’une même audience. Voir Mailchimp groupes pour toute clarification requise. Lorsque vous atteignez cette limite, vous obtenez un message d’400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories) en tant que réponse d’erreur de l’API Mailchimp.
En outre, reportez-vous à la Mailchimp limites de débit pour plus d’informations sur les limites imposées par l’API Mailchimp.
Identités prises en charge supported-identities
Mailchimp prend en charge l’activation des identités décrites dans le tableau ci-dessous. En savoir plus sur les identités.
Type et fréquence d’exportation export-type-frequency
Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.
- Vous exportez tous les membres d’un segment, ainsi que les champs de schéma souhaités, (par exemple : adresse e-mail, numéro de téléphone, nom), en fonction de votre mappage de champs.
- Pour chaque audience sélectionnée dans Experience Platform, le statut du segment Mailchimp Interest Categories correspondant est mis à jour avec son statut d’audience à partir d’Experience Platform.
Se connecter à la destination connect
Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations. Dans le workflow de configuration des destinations, renseignez les champs répertoriés dans les deux sections ci-dessous.
Dans Destinations > Catalogue, recherchez Mailchimp Interest Categories. Vous pouvez également localiser cet élément dans la catégorie Marketing par e-mail.
S’authentifier auprès de la destination authenticate
Pour vous authentifier auprès de la destination, renseignez les champs obligatoires ci-dessous et sélectionnez Se connecter à la destination.
Votre clé API se présente sous la forme d’
{KEY}-{DC}, où la partie {KEY} fait référence à la valeur indiquée dans la section Mailchimp Clé API et la partie {DC} fait référence au Mailchimp centre de données.Vous pouvez fournir la partie
{KEY} ou l’intégralité du formulaire.Par exemple, si votre clé API est
0123456789abcdef0123456789abcde-us14vous pouvez fournir *
0123456789abcdef0123456789abcde*ou *0123456789abcdef0123456789abcde-us14*comme valeur.
Si les détails fournis sont valides, l’interface utilisateur affiche un statut Connecté avec une coche verte. Vous pouvez ensuite passer à l’étape suivante.
Renseigner les détails de la destination destination-details
Pour configurer les détails de la destination, renseignez les champs obligatoires et facultatifs ci-dessous. Un astérisque situé en regard d’un champ de l’interface utilisateur indique que le champ est obligatoire.
data center. Reportez-vous à la section Identifier Mailchimp centre de données pour obtenir des conseils.No options are available. Please verify the values selected for the following dependent fields: dataCenter comme illustré ci-dessous. Dans ce cas, vous ne pouvez pas sélectionner de valeur dans le champ Nom de l’audience (veuillez d’abord sélectionner Centre de données). Pour corriger cette erreur, indiquez les valeurs correctes.Activer les alertes enable-alerts
Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données vers votre destination. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des destinations dans l’interface utilisateur.
Lorsque vous avez terminé de renseigner les détails sur votre connexion de destination, sélectionnez Suivant.
Activer des audiences vers cette destination activate
- Pour activer les données, vous avez besoin des autorisations de contrôle d’accès Afficher les destinations, Activer les destinations, Afficher les profils et Afficher les segments 🔗. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.
- Pour exporter des identités, vous devez disposer de l’autorisation de contrôle d’accès Afficher le graphique d’identités 🔗.
{width="100" modal="regular"}
Consultez la section Activer les profils et les audiences vers les destinations d’exportation d’audiences en flux continu pour obtenir des instructions sur l’activation des audiences vers cette destination.
Considérations sur le mappage et exemple mapping-considerations-example
Pour envoyer correctement vos données d’audience de Adobe Experience Platform vers la destination Mailchimp Interest Categories, vous devez passer par l’étape de mappage des champs. Le mappage consiste à créer un lien entre vos champs de schéma de modèle de données d’expérience (XDM) dans votre compte Experience Platform et leurs équivalents issus de la destination cible.
Pour mapper correctement vos champs XDM vers les champs de destination Mailchimp Interest Categories, procédez comme suit :
-
Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Une nouvelle ligne de mappage s’affiche désormais à l’écran.
-
Dans la fenêtre Sélectionner le champ source, choisissez la catégorie Sélectionner les attributs et sélectionnez l’attribut XDM ou choisissez l’espace de noms d’identité Sélectionner et sélectionnez une identité.
-
Dans la fenêtre Sélectionner le champ cible, choisissez la catégorie Sélectionner un espace de noms d’identité et sélectionnez une identité ou choisissez Sélectionner des attributs et sélectionnez dans la liste des attributs renseignée à partir de l’API Mailchimp. Tous les attributs personnalisés que vous avez ajoutés à l’audience Mailchimp sélectionnée pourront également être sélectionnés en tant que champs cibles.
Les mappages disponibles entre votre schéma de profil XDM et Mailchimp Interest Categories sont les suivants :
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Champ source Champ cible Notes IdentityMap: EmailIdentity: emailObligatoire : Oui xdm: person.name.firstNameAttribute: FNAMExdm: person.name.lastNameAttribute: LNAMExdm: person.birthDayAndMonthAttribute: BIRTHDAYEn outre,
ADDRESSest un champ cible spécial appelémerge fieldau sein de votre audience Mailchimp. La Mailchimp documentation définit les clés requises commeaddr1,city,stateetzip, ainsi que les clés facultativesaddr2etcountry. Les valeurs de ces champs doivent être des chaînes. Si l’un des mappages de champsADDRESSest présent, la destination transmet l’objetADDRESSà l’API Mailchimp pour mise à jour. La valeur par défaut de tous les champs deADDRESSnon mappés estNULL, à l’exception du pays qui est défini par défaut surUS.Les mappages disponibles pour le champ
ADDRESSsont les suivants :table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 Champ source Champ cible xdm: workAddress.street1Attribute: ADDRESS.addr1xdm: workAddress.street2Attribute: ADDRESS.addr2xdm: workAddress.cityAttribute: ADDRESS.cityxdm: workAddress.stateAttribute: ADDRESS.statexdm: workAddress.postalCodeAttribute: ADDRESS.zipxdm: workAddress.countryAttribute: ADDRESS.countryPar exemple, vous souhaitez mettre à jour la valeur de
countryavec les valeurs de champ d’adresse existantes du contactaddr1,city,stateetzipcomme132, My Street, Kingston,New York,New Yorket12401. Pour mettre à jour lacountry, vous devez transmettre les valeurs existantes avec les modifications (le cas échéant) et la nouvelle valeur pour le pays. Les valeurs de votre jeu de données doivent donc être132, My Street, Kingston,New York,New York,12401etUS. En résumé, si vous transmettez uniquement descountryet ne fournissez pas de valeurs pouraddr1,city,stateetzip, elles seront remplacées parNULL.Un exemple avec les mappages terminés est illustré ci-dessous :
Lorsque vous avez terminé de fournir les mappages pour votre connexion de destination, sélectionnez Suivant.
Valider l’exportation des données exported-data
Pour vérifier que vous avez correctement configuré la destination, procédez comme suit :
- Connectez-vous à votre compte Mailchimp. Accédez ensuite à la page Audience . Développez ensuite le menu Manage Contacts et sélectionnez Groups.
- Sélectionnez le groupe et vérifiez si les audiences sélectionnées sont créées sous la forme de catégories avec le nom de l’audience d’Experience Platform, qui peut être suivi d’un suffixe généré automatiquement.
- Cette destination utilise les noms des segments sélectionnés pour créer la catégorie d’intérêt à l’aide de l’API Mailchimp Ajouter une catégorie d’intérêt . Si vous créez une nouvelle destination et activez à nouveau les mêmes audiences, Mailchimp ajoute un suffixe pour distinguer les segments existants des nouveaux segments.
- Les contacts dont les e-mails n’existaient pas dans le groupe sont ajoutés à la catégorie nouvellement créée.
- Pour les contacts qui existent déjà dans le groupe, les données du champ d’attribut sont mises à jour et le contact est ajouté à la catégorie nouvellement créée.
Utilisation et gouvernance des données data-usage-governance
Lors de la gestion de vos données, toutes les destinations Adobe Experience Platform se conforment aux politiques d’utilisation des données. Pour obtenir des informations détaillées sur la manière dont Adobe Experience Platform applique la gouvernance des données, lisez la présentation de la gouvernance des données.
Erreurs et résolution des problèmes errors-and-troubleshooting
Erreur rencontrée si les valeurs de Mailchimp clé API ou du centre de données sont incorrectes incorrect-credentials-error
Si la clé API fournie dans le champ Mot de passe ou la valeur Centre de données est incorrecte, l’interface utilisateur affiche une réponse d’erreur d’API Mailchimp : No options are available. Please verify the values selected for the following dependent fields: dataCenter comme illustré ci-dessous. Dans ce cas, vous ne pouvez pas sélectionner de valeur dans le champ Nom de l’audience (veuillez d’abord sélectionner Centre de données).
Pour corriger cette erreur et passer à l’étape suivante, vous devez fournir les valeurs correctes. Reportez-vous au Identifier Mailchimp centre de données et
Sections Rassembler Mailchimp Clé API si vous avez besoin de conseils.
Erreur rencontrée si Mailchimp limite de nom de groupe est dépassée group-name-limits-error
Pendant la création de la destination, vous pouvez recevoir les messages d’erreur suivants : Cannot have more than 60 interests per list (Across all categories) ou 400 BAD_REQUEST. Cela se produit lorsque vous dépassez les 60 noms de groupe (ou catégories d’intérêt) dans un seul groupe ou dans plusieurs groupes au sein de la même limite d’audience, comme décrit dans la section Mécanismes de sécurisation . Pour corriger cette erreur, veillez à ne pas dépasser la limite de noms de groupe dans Mailchimp.
Statut de Mailchimp et codes d’erreur
Reportez-vous à la Mailchimp page Erreurs pour une liste complète des statuts et des codes d’erreur avec des explications.
Ressources supplémentaires additional-resources
Retrouvez d’autres informations utiles de la documentation Mailchimp ci-dessous :