Connexion Mailchimp Interest Categories
Mailchimp est une plateforme d’automatisation du marketing et un service de marketing par e-mail très utilisé par les entreprises pour gérer et communiquer avec les contacts. (clients, clients ou autres parties intéressées) utilisation 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 uses audiences, groups, et les catégories d’intérêt (également appelés noms de groupe ou titres de groupe). Chaque Mailchimp groupe 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. Ces catégories peuvent ensuite être utilisées pour créer des segments. Vous pouvez utiliser ces audiences pour diffuser des emails de campagne ciblés vers les contacts abonnés.
Ceci Adobe Experience Platform destination utilise la variable Mailchimp batch subscribe or unsubscribe API API à créer catégories d'intérêt puis ajouter des contacts de chacune des audiences 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 Mailchimp contacts, puis les ajouter ou les supprimer des groupes de votre choix dans un Mailchimp après les avoir activés dans un nouveau segment. Mailchimp Interest Groups utilise les noms d’audience sélectionnés de Platform comme 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 emails aux contacts pour les campagnes marketing use-case-send-emails
Le service des ventes d'un site web de sport souhaite diffuser une campagne marketing par email à une liste de contacts qui se sont identifiés comme intéressés par le football. Les listes de contacts sont séparées en tant que lots dans l’exportation des données reçue de l’équipe de développement du site web et doivent donc être suivies. L’équipe identifie une Mailchimp et commence à créer les audiences Experience Platform dans lesquelles sont ajoutés les contacts de chaque liste. Après avoir envoyé ces audiences à Mailchimp Interest Categories, si des contacts n’existent pas dans le Mailchimp audience à laquelle ils sont ajoutés à un groupe avec le nom de l’audience auquel le contact appartient. Si des contacts existent déjà dans la variable Mailchimp audience ou groupe, puis leurs informations sont mises à jour. Une fois les données envoyées à Mailchimp Interest Categories, l’équipe des ventes peut sélectionner et envoyer le courrier électronique de la campagne marketing au groupe d’intérêt football au sein de la Mailchimp audience.
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 les informations que vous devez rassembler avant de travailler avec la variable Mailchimp Interest Categories destination.
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 l’ Mailchimp Interest Categories destination prerequisites-destination
Notez les conditions préalables suivantes pour exporter des données de Platform vers votre Mailchimp compte :
Vous devez disposer d’un Mailchimp account prerequisites-account
Avant de pouvoir créer un Mailchimp Interest Categories destination, vous devez d’abord vous assurer que vous disposez d’une Mailchimp compte . Si vous n’en avez pas déjà un, consultez la page Mailchimp page d’inscription pour enregistrer et créer votre compte.
Collecte Mailchimp Clé API gather-credentials
Vous avez besoin de votre Mailchimp Clé API pour authentifier la variable Mailchimp Interest Categories destination par rapport à votre Mailchimp compte . La variable Clé API sert de Password lorsque vous authentifier la destination.
Si vous n’avez pas votre Clé API, connectez-vous à votre compte et reportez-vous à la section Mailchimp Génération de votre clé API pour en créer une.
Exemple de clé API : 0123456789abcdef0123456789abcde-us14
.
Identifier Mailchimp centre de données identify-data-center
Ensuite, vous devez identifier votre Mailchimp centre de données. Pour ce faire, connectez-vous à Mailchimp et accédez au Section Clés API de votre compte.
La valeur correspond à 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
.
Il est également ajouté à votre clé API dans le formulaire. key-dc; si votre clé d’API est 0123456789abcdef0123456789abcde-us14
, le centre de données est us14
.
Écrire la valeur du centre de données (us14
dans cet exemple), cette valeur est nécessaire lorsque vous remplir les détails de destination.
Si vous avez besoin d’autres conseils, reportez-vous à la section Mailchimp Documentation de base.
Mécanismes de sécurisation guardrails
Chacune de vos Mailchimp Les audiences peuvent contenir jusqu’à 60 noms de groupe (ou catégories d’intérêt) au sein d’un seul groupe ou entre plusieurs groupes au sein d’une même audience. Voir Mailchimp groups pour toute clarification requise. Lorsque vous atteignez cette limite, vous obtenez une 400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories)
message en tant que réponse d’erreur de la fonction Mailchimp API.
En outre, reportez-vous au Mailchimp limites de taux pour obtenir des informations détaillées sur les limites imposées par la variable Mailchimp API.
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 Platform, la valeur Mailchimp Interest Categories l’état du segment est mis à jour avec son état d’audience de 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.
Within Destinations > Catalogue, recherchez Mailchimp Interest Categories. Vous pouvez également la localiser sous le Marketing par e-mail catégorie.
S’authentifier auprès de la destination authenticate
Pour vous authentifier à la destination, renseignez les champs obligatoires ci-dessous et sélectionnez Se connecter à la destination.
Votre clé API prend la forme
{KEY}-{DC}
, où la variable {KEY}
fait référence à la valeur indiquée dans la variable Mailchimp Clé API et la section {DC}
fait référence à la Mailchimp centre de données.Vous pouvez fournir le
{KEY}
ou l’intégralité du formulaire.Par exemple, si votre clé API est
0123456789abcdef0123456789abcde-us14
,vous 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
. Voir 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 la variable Nom de l’audience (veuillez d’abord sélectionner le centre de données) champ . 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 de l’événement Affichage des destinations, Activation des destinations, Afficher les profils, et Affichage de segments autorisations de contrôle d’accès. 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 identités, vous avez besoin de la fonction Affichage du graphique des identités autorisation de contrôle d’accès.
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 le Mailchimp Interest Categories destination, 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 Platform et leurs équivalents de la destination cible.
Pour mapper correctement vos champs XDM à Mailchimp Interest Categories pour les champs de destination, procédez comme suit :
-
Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Vous pouvez désormais voir une nouvelle ligne de mappage sur l’écran.
-
Dans le Sélectionner le champ source , choisissez la Sélectionner des attributs et sélectionnez l’attribut XDM ou choisissez l’option Sélectionner un espace de noms d’identité et sélectionnez une identité.
-
Dans le Sélectionner le champ cible , choisissez la 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és à partir du Mailchimp API. Tous les attributs personnalisés que vous avez ajoutés au Mailchimp L’audience sera également disponible pour la sélection en tant que champs cibles.
Mappages disponibles entre votre schéma de profil XDM et Mailchimp Interest Categories sont les suivants : | Champ source | Champ cible | Remarques | | — | — | — | |
IdentityMap: Email
|Identity: email
| Obligatoire : Oui | |xdm: person.name.firstName
|Attribute: FNAME
| | |xdm: person.name.lastName
|Attribute: LNAME
| | |xdm: person.birthDayAndMonth
|Attribute: BIRTHDAY
| |En outre,
ADDRESS
est un champ cible spécial appelémerge field
dans votre Mailchimp audience. La variable Mailchimp documentation définit les clés requises commeaddr1
,city
,state
, etzip
et les clés facultativesaddr2
etcountry
. Les valeurs de ces champs doivent être des chaînes. Si l’une des variablesADDRESS
les mappages de champs sont présents, la destination transfère la variableADDRESS
vers l’objet Mailchimp API pour la mise à jour. QuelconqueADDRESS
les champs non mappés ont la valeur par défaut àNULL
sauf pour le pays par défautUS
.Les mappages disponibles pour la variable
ADDRESS
sont 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.street1
Attribute: ADDRESS.addr1
xdm: workAddress.street2
Attribute: ADDRESS.addr2
xdm: workAddress.city
Attribute: ADDRESS.city
xdm: workAddress.state
Attribute: ADDRESS.state
xdm: workAddress.postalCode
Attribute: ADDRESS.zip
xdm: workAddress.country
Attribute: ADDRESS.country
Par exemple, vous souhaitez mettre à jour la valeur de
country
avec le champ d'adresse existant du contactaddr1
,city
,state
, etzip
valeurs en tant que132, My Street, Kingston
,New York
,New York
et12401
. Pour mettre à jour la variablecountry
vous devez transmettre les valeurs existantes avec des 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
,12401
, etUS
. Réitérer, si vous ne réussissez quecountry
et ne fournissent pas de valeurs pouraddr1
,city
,state
, etzip
Ils seront remplacés parNULL
.Un exemple avec les mappages terminés est illustré ci-dessous :
Une fois les mappages fournis pour la connexion à la 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 à Mailchimp compte . Ensuite, accédez à la Audience page. Ensuite, développez la variable Manage Contacts et sélectionnez Groups.
- Sélectionnez le Groupe et vérifiez si les audiences sélectionnées sont créées en tant que catégories avec le nom de l’audience de 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 en utilisant la variable Mailchimp Ajout d’une API de catégorie d’intérêt. Si vous créez une destination et réactivez les mêmes audiences, Mailchimp ajoute un suffixe pour distinguer les segments existants des nouveaux segments.
- Les contacts dont les emails n'existaient pas dans le groupe sont ajoutés à la catégorie nouvellement créée.
- Pour les contacts déjà présents 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 Mailchimp Les valeurs de clé API ou de centre de données sont incorrectes incorrect-credentials-error
Si la clé d’API que vous avez fournie dans la variable Password ou le champ Centre de données est incorrecte, l’interface affiche une Mailchimp Réponse d’erreur de l’API : 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 la variable Nom de l’audience (veuillez d’abord sélectionner le centre de données) champ .
Pour corriger cette erreur et passer à l’étape suivante, vous devez fournir les valeurs correctes. Voir Identifier Mailchimp centre de données et
Collecte Mailchimp Clé API si vous avez besoin d’instructions.
Erreur rencontrée si Mailchimp la limite du nom de groupe est dépassée. group-name-limits-error
Lors de 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) d’un seul groupe ou de plusieurs groupes dans la même limite d’audience, comme décrit dans la section barrières de sécurité . Pour corriger cette erreur, veillez à ne pas dépasser la limite du nom du groupe dans Mailchimp.
Mailchimp Codes d’état et d’erreur
Voir Mailchimp page erreurs pour obtenir une liste complète des codes d’état et d’erreur avec des explications.
Ressources supplémentaires additional-resources
Informations utiles supplémentaires de la section Mailchimp la documentation est la suivante :