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 Adobe Experience Platform clients 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 consultez la documentation Mailchimp Générer votre clé API pour en créer une.

Un exemple de clé API est 0123456789abcdef0123456789abcde-us14.

IMPORTANT
Si vous générez la clé API, notez-la car vous ne pourrez plus y accéder après la génération.

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.

Consultez également la Mailchimp limites de débit pour obtenir des informations détaillées 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.

Identité cible
Description
Considérations
E-mail
Adresse e-mail du contact
Obligatoire

Audiences prises en charge supported-audiences

Cette section décrit les types d’audiences que vous pouvez exporter vers cette destination. Les deux tableaux ci-dessous indiquent les audiences prises en charge par ce connecteur, par origine de l’audience et types de profil inclus dans l’audience :

Origine de l’audience
Pris en charge
Description
Segmentation Service
Oui
Audiences générées via Experience Platform Segmentation Service.
Toutes les autres origines d’audience
Non

Cette catégorie inclut toutes les origines d’audience en dehors des audiences générées par le Segmentation Service. Découvrez les différentes origines d’audience. Voici quelques exemples :

  • audiences de chargement personnalisées importées dans Experience Platform à partir de fichiers CSV,
  • les audiences semblables,
  • les audiences fédérées,
  • les audiences générées dans d’autres applications Experience Platform, telles que Adobe Journey Optimizer,
  • et plus encore.

Audiences prises en charge par type de données d’audience :

Type de données d’audience
Pris en charge
Description
Cas d’utilisation
Audiences de personnes
Oui
En fonction des profils client, ce qui vous permet de cibler des groupes spécifiques de personnes pour les campagnes marketing.
Acheteurs fréquents, personnes abandonnant leur panier
Audiences de compte
Non
Ciblez des individus au sein d’organisations spécifiques pour les stratégies marketing basées sur les comptes.
Marketing B2B
Audiences de prospects ​
Non
Ciblez les individus qui ne sont pas encore clients, mais qui partagent des caractéristiques avec votre audience cible.
Prospection à l’aide de données tierces
Exportations de jeux de données
Non
Collections de données structurées stockées dans le lac de données Adobe Experience Platform.
Rapports, workflows de science des données

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.

Élément
Type
Notes
Type d’exportation
Profile-based
  • 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.
Fréquence des exportations
Streaming
Les destinations de diffusion en continu sont des connexions basées sur l’API « toujours actives ». Lorsqu’un profil est mis à jour dans Experience Platform en fonction de l’évaluation de l’audience, le connecteur envoie la mise à jour en aval vers la plateforme de destination. En savoir plus sur les destinations de diffusion en continu.

Se connecter à la destination connect

IMPORTANT
Pour vous connecter à la destination, vous avez besoin des View Destinations et Manage Destinations autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

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 > Catalog, recherchez Mailchimp Interest Categories. Vous pouvez également localiser cet élément dans la catégorie Email marketing .

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 Connect to destination.

Champ
Description
Username
Votre nom d’utilisateur Mailchimp Interest Categories.
Password
Votre Mailchimp clé API, que vous avez notée dans la section Collecter Mailchimp informations d’identification.
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-us14
vous pouvez fournir *0123456789abcdef0123456789abcde*ou *0123456789abcdef0123456789abcde-us14*comme valeur.

Capture d’écran de l’interface utilisateur d’Experience Platform montrant comment s’authentifier.

Si les détails fournis sont valides, l’interface utilisateur affiche un statut de Connected 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.

Capture d’écran de l’interface utilisateur d’Experience Platform affichant les détails de la destination.

Champ
Description
Name
Nom par lequel vous reconnaîtrez cette destination à l’avenir.
Description
Une description qui vous aidera à identifier cette destination à l’avenir.
Data center
Votre compte Mailchimp est data center. Reportez-vous à la section Identifier Mailchimp centre de données pour obtenir des conseils.
Audience Name (Please select Data center first)
Une fois la Data center sélectionnée, cette liste déroulante est automatiquement renseignée avec les noms des audiences de votre compte Mailchimp. Sélectionnez l’audience à mettre à jour avec les données d’Experience Platform.
Interest Category (Please select Data center and Audience Name first)
Une fois que vous avez sélectionné votre Audience Name, cette liste déroulante est automatiquement renseignée avec les noms des catégories de groupes d’intérêt de votre compte Mailchimp. Sélectionnez le nom de la catégorie à mettre à jour avec les données d’Experience Platform.
TIP
Si la clé API fournie dans le champ Password ou la valeur Data center 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 Audience Name (Please select Data center first) . 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 Next.

Activer des audiences vers cette destination activate

IMPORTANT
  • Pour activer les données, vous avez besoin des autorisations de contrôle d’accès View Destinations, Activate Destinations, View Profiles et View Segments Access control. 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 View Identity Graph🔗.
    Sélectionnez l’espace de noms d’identité en surbrillance dans le workflow pour activer les audiences vers les destinations. {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 :

  1. À l’étape Mapping, sélectionnez Add new mapping. Une nouvelle ligne de mappage s’affiche désormais à l’écran.

  2. Dans la fenêtre Select source field , choisissez la catégorie Select attributes et sélectionnez l’attribut XDM ou choisissez le Select identity namespace et sélectionnez une identité.

  3. Dans la fenêtre de Select target field, choisissez le Select identity namespace et sélectionnez une identité ou choisissez Select attributes catégorie 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 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 au sein de votre audience Mailchimp. La Mailchimp documentation définit les clés requises comme addr1, city, state et zip, ainsi que les clés facultatives addr2 et country. Les valeurs de ces champs doivent être des chaînes. Si l’un des mappages de champs ADDRESS est présent, la destination transmet l’objet ADDRESS à l’API Mailchimp pour mise à jour. La valeur par défaut de tous les champs de ADDRESS non mappés est NULL, à l’exception du pays qui est défini par défaut sur US.

    Les mappages disponibles pour le champ 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 les valeurs de champ d’adresse existantes du contact addr1, city, state et zip comme 132, My Street, Kingston, New York, New York et 12401. Pour mettre à jour la country, 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 être 132, My Street, Kingston, New York, New York, 12401 et US. En résumé, si vous transmettez uniquement des country et ne fournissez pas de valeurs pour addr1, city, state et zip, elles seront remplacées par NULL.

    Un exemple avec les mappages terminés est illustré ci-dessous :
    Exemple de capture d’écran de l’interface utilisateur d’Experience Platform montrant les mappages de champs.

Lorsque vous avez terminé de fournir les mappages pour votre connexion de destination, sélectionnez Next.

Valider l’exportation des données exported-data

Pour vérifier que vous avez correctement configuré la destination, procédez comme suit :

  • Accédez à votre compte Mailchimp. Accédez ensuite à la page Audience . Développez ensuite le menu Manage Contacts et sélectionnez Groups.

Capture d’écran de l’interface utilisateur Mailchimp montrant la page du groupe d’audiences.

  • 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.

Capture d’écran de l’interface utilisateur Mailchimp présentant les catégories du groupe d’audiences.

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 Password ou la valeur Data center 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 Audience Name (Please select Data center first) .

Capture d’écran de l’interface utilisateur d’Experience Platform affichant une erreur si la clé API Mailchimp ou les valeurs du centre de données sont incorrectes.

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 mailchimp-status-error-codes

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 :

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6