DocumentatieExperience PlatformHandleiding voor bestemmingen

Mailchimp Interest Categories verbinding

Last update: Fri Apr 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder
  • Gebruiker

Mailchimpis een populair platform van de marketing automatisering en e-mailmarketing de dienst die door ondernemingen wordt gebruikt om en met contacten te beheren (cliënten, klanten, of andere geïnteresseerde partijen) te spreken gebruikend mailing lijsten en e-mail marketing campagnes. Gebruik deze schakelaar om uw contacten te sorteren die op hun belangen en voorkeur worden gebaseerd.

Mailchimp Interest Categories gebruikt publiek, groepen, en interessecategorieën (ook gekend als groepsnamen of groepstitels). Elke Mailchimp -groep is een lijst met belangencategorieën. Contactpersonen zijn gekoppeld aan een belangencategorie wanneer zij zich abonneren op een of meer belangencategorieën via een aanmeldingsformulier op uw website. Binnen een publiek, kunt u de contacten in groepen ook organiseren en hen associëren met rentecategorieën, en deze kunnen dan worden gebruikt om segmenten tot stand te brengen. U kunt dit publiek gebruiken om gerichte campagnee-mails naar de geabonneerde contacten uit te zenden.

Dit Adobe Experience Platform bestemminggebruikt Mailchimp batch subscribe or unsubscribe APIAPI om rentecategorieëntot stand te brengen en dan contacten van elk geselecteerd publiek van Experience Platform in een overeenkomstige rentecategorie toe te voegen. U kunt nieuwe contacten toevoegen of de informatie van bestaande Mailchimp contacten bijwerken, dan toevoegen of verwijderen hen uit hun gewenste groepen binnen een bestaand Mailchimp publiek na het activeren van hen binnen een nieuw segment. Mailchimp Interest Groups gebruikt de geselecteerde publieksnamen van Experience Platform als belangencategorieën binnen Mailchimp .

Gebruiksscenario’s use-cases

Om u beter te helpen begrijpen hoe en wanneer u de Mailchimp Interest Categories bestemming zou moeten gebruiken, is hier een geval van het steekproefgebruik dat de klanten van Adobe Experience Platform kunnen oplossen door deze bestemming te gebruiken.

E-mails verzenden naar contactpersonen voor marketingcampagnes use-case-send-emails

De verkoopafdeling van een website over sportartikelen wil een marketingcampagne per e-mail uitzenden naar een lijst met contactpersonen die zichzelf hebben geïdentificeerd als geïnteresseerd in voetbal. De lijsten van contacten worden gescheiden als partijen in de gegevensuitvoer die van het ontwikkelingsteam van de website wordt ontvangen en moeten daarom worden gevolgd. Het team identificeert een bestaand Mailchimp publiek en begint het publiek van Experience Platform te bouwen waarin de contacten van elke lijst worden toegevoegd. Nadat u deze soorten publiek naar Mailchimp Interest Categories hebt verzonden, worden contactpersonen die niet aanwezig zijn in het geselecteerde Mailchimp -publiek, toegevoegd aan een groep met de publieksnaam waartoe de contactpersoon behoort. Als er al contactpersonen aanwezig zijn in het publiek of de groep van Mailchimp , wordt de informatie van deze contactpersonen bijgewerkt. Zodra de gegevens naar Mailchimp Interest Categories zijn verzonden, kan het verkoopteam de marketingcampagne selecteren en per e-mail verzenden naar de belangengroep van de voetbal in het Mailchimp -publiek.

Vereisten prerequisites

Raadpleeg de onderstaande secties voor alle voorwaarden die u in Experience Platform en Mailchimp moet instellen en voor informatie die u moet verzamelen voordat u met het Mailchimp Interest Categories -doel kunt werken.

Vereisten in Experience Platform prerequisites-in-experience-platform

Alvorens gegevens aan de Mailchimp Interest Categories bestemming te activeren, moet u a schema, a datasethebben, en segmentendie in Experience Platform worden gecreeerd.

Vereisten voor het doel Mailchimp Interest Categories prerequisites-destination

Houd rekening met de volgende voorwaarden om gegevens van Experience Platform naar uw Mailchimp -account te exporteren:

U moet een Mailchimp -account hebben prerequisites-account

Voordat u een Mailchimp Interest Categories -doel kunt maken, moet u eerst controleren of u een Mailchimp -account hebt. Als u niet reeds hebt, bezoek de Mailchimp aanmeldingspaginaom uw rekening te registreren en te creëren.

API-sleutel van Mailchimp verzamelen gather-credentials

U hebt uw Mailchimp API sleutel nodig om de Mailchimp Interest Categories bestemming tegen uw Mailchimp rekening voor authentiek te verklaren. De API sleutel dient als Wachtwoord wanneer u de bestemmingvoor authentiek verklaart.

Als u niet uw API sleutel hebt, het Teken binnen aan uw rekening en verwijs naar Mailchimp produceer uw API sleuteldocumentatie om tot te leiden.

Een voorbeeld van een API-sleutel is 0123456789abcdef0123456789abcde-us14 .

IMPORTANT
Als u de API sleutel produceert, schrijf het neer aangezien u niet tot het na generatie zult kunnen toegang hebben.

Mailchimp datacenter identificeren identify-data-center

Vervolgens moet u het datacenter van Mailchimp identificeren. Dit doen, login aan uw Mailchimp rekening en navigeer aan de API sleutelensectie van uw rekening.

De waarde is het eerste deel van de URL die u in uw browser ziet. Als URL https:// us14 .mailchimp.com/account/api/ is, dan is het gegevenscentrum us14.

Het is ook toegevoegd aan uw API sleutel in de vorm sleutel-dc; als uw API sleutel 0123456789abcdef0123456789abcde-us14 is, dan is het gegevenscentrum us14.

Schrijf de waarde van het gegevenscentrum (us14 in dit voorbeeld) neer, hebt u deze waarde nodig wanneer u bestemmingsdetailsvult.

Als u verdere begeleiding vereist, verwijs naar de Mailchimp documentatie van Grondbeginselen.

Guardrails guardrails

Elk van uw Mailchimp publiek kan tot 60 groepnamen (of rentecategorieën) in één enkele groep of over verscheidene groepen binnen het zelfde publiek bevatten. Verwijs naar Mailchimp groepenvoor om het even welke vereiste verduidelijkingen. Wanneer u deze limiet bereikt, ontvangt u een 400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories) -bericht als een foutreactie van de API van Mailchimp .

Bovendien, verwijs naar Mailchimp tariefgrenzenvoor gedetailleerde informatie over de grenzen die door Mailchimp API worden opgelegd.

Ondersteunde identiteiten supported-identities

Mailchimp ondersteunt de activering van identiteiten die in de onderstaande tabel worden beschreven. Leer meer over identiteiten.

Doelidentiteit
Beschrijving
Overwegingen
Email
E-mailadres contactpersoon
Verplicht

Type en frequentie exporteren export-type-frequency

Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.

Item
Type
Notities
Exporttype
Profile-based
  • U exporteert alle leden van een segment samen met de gewenste schemavelden (bijvoorbeeld: e-mailadres, telefoonnummer, achternaam) volgens uw veldtoewijzing.
  • Voor elk geselecteerd publiek in Experience Platform wordt de bijbehorende segmentstatus van Mailchimp Interest Categories bijgewerkt met de publieksstatus van Experience Platform.
Exportfrequentie
Streaming
Streaming doelen zijn "altijd aan" API-verbindingen. Wanneer een profiel in Experience Platform wordt bijgewerkt dat op publieksevaluatie wordt gebaseerd, verzendt de schakelaar de update stroomafwaarts naar het bestemmingsplatform. Lees meer over het stromen bestemmingen.

Verbinden met de bestemming connect

IMPORTANT
Om met de bestemming te verbinden, hebt u View Destinations en Manage Destinations toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Om met deze bestemming te verbinden, volg de stappen die in het leerprogramma van de bestemmingsconfiguratieworden beschreven. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.

Zoek in Destinations > Catalog naar Mailchimp Interest Categories . U kunt de locatie ook in de categorie Email marketing vinden.

Verifiëren voor bestemming authenticate

Als u voor verificatie bij het doel wilt zorgen, vult u de vereiste velden hieronder in en selecteert u Connect to destination .

Veld
Beschrijving
Username
Uw Mailchimp Interest Categories gebruikersnaam.
Password
Uw Mailchimp API sleutel, die u neer in de Gather Mailchimp geloofsbrievensectie had genoteerd.
Uw API sleutel neemt de vorm van {KEY}-{DC}, waar het {KEY} gedeelte naar de waarde verwijst neer in de Mailchimp API belangrijkstesectie en het {DC} gedeelte verwijst naar het Mailchimp gegevenscentrum.
U kunt of het {KEY} gedeelte of het volledige vorm verstrekken.
Als uw API-sleutel bijvoorbeeld
*0123456789abcdef0123456789abcde-us14*is,
kunt u *0123456789abcdef0123456789abcde*of *0123456789abcdef0123456789abcde-us14*als waarde opgeven.

{het schermschot van 0} Experience Platform UI die toont hoe te voor authentiek te verklaren.

Als de opgegeven gegevens geldig zijn, geeft de gebruikersinterface de status Connected weer met een groen vinkje. Vervolgens kunt u verdergaan met de volgende stap.

Doelgegevens invullen destination-details

Als u details voor de bestemming wilt configureren, vult u de vereiste en optionele velden hieronder in. Een sterretje naast een veld in de gebruikersinterface geeft aan dat het veld verplicht is.

{het schermschot van 0} Experience Platform UI die de bestemmingsdetails toont.

Veld
Beschrijving
Name
Een naam waarmee u deze bestemming in de toekomst zult erkennen.
Description
Een beschrijving die u zal helpen deze bestemming in de toekomst identificeren.
Data center
Uw Mailchimp account data center . Verwijs naar identificeer Mailchimp gegevenscentrumsectie voor om het even welke begeleiding.
Audience Name (Please select Data center first)
Nadat u Data center hebt geselecteerd, wordt deze vervolgkeuzelijst automatisch gevuld met de publieksnamen van uw Mailchimp -account. Selecteer het publiek dat u wilt bijwerken met gegevens uit Experience Platform.
Interest Category (Please select Data center and Audience Name first)
Nadat u Audience Name hebt geselecteerd, wordt deze vervolgkeuzelijst automatisch gevuld met de categorienamen van de belangengroep van uw Mailchimp -account. Selecteer de categorienaam die u wilt bijwerken met gegevens uit Experience Platform.
TIP
Als de API-sleutel die u in het veld Password of de waarde Data center hebt opgegeven, onjuist is, geeft de interface een API-foutreactie Mailchimp weer: No options are available. Please verify the values selected for the following dependent fields: dataCenter zoals hieronder wordt weergegeven. In dit geval kunt u geen waarde selecteren in het veld Audience Name (Please select Data center first) . Geef de juiste waarden op om deze fout te corrigeren.

Waarschuwingen inschakelen enable-alerts

U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Voor meer informatie over alarm, zie de gids bij het intekenen aan bestemmingsalarm gebruikend UI.

Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next .

Soorten publiek naar dit doel activeren activate

IMPORTANT

Lees activeer profielen en publiek aan het stromen publiek uitvoerbestemmingenvoor instructies bij het activeren van publiek aan deze bestemming.

Afbeeldingsoverwegingen en voorbeeld mapping-considerations-example

Als u uw publieksgegevens correct vanuit Adobe Experience Platform naar de Mailchimp Interest Categories -bestemming wilt verzenden, moet u de stap voor veldtoewijzing doorlopen. Toewijzing bestaat uit het maken van een koppeling tussen de schemavelden van uw Experience Data Model (XDM) in uw Experience Platform-account en de overeenkomstige equivalenten van de doelbestemming.

Voer de onderstaande stappen uit om uw XDM-velden correct toe te wijzen aan de Mailchimp Interest Categories -doelvelden:

  1. Selecteer Add new mapping in de stap Mapping . U ziet nu een nieuwe toewijzingsrij op het scherm.

  2. Kies in het venster Select source field de categorie Select attributes en selecteer het XDM-kenmerk of kies de categorie Select identity namespace en selecteer een identiteit.

  3. Kies in het Select target field -venster de Select identity namespace en selecteer een identiteit of kies Select attributes -categorie en selecteer een van de kenmerken die zijn ingevuld in de Mailchimp API. om het even welke douanekenmerken die u aan het geselecteerde Mailchimp publiek hebt toegevoegd zullen ook voor selectie als doelgebieden beschikbaar zijn.

    De toewijzingen tussen uw XDM-profielschema en Mailchimp Interest Categories zijn als volgt:

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
    Source-veld Doelveld Notities
    IdentityMap: Email Identity: email Verplicht: Ja
    xdm: person.name.firstName Attribute: FNAME
    xdm: person.name.lastName Attribute: LNAME
    xdm: person.birthDayAndMonth Attribute: BIRTHDAY

    Daarnaast is ADDRESS een speciaal doelveld dat merge field binnen uw publiek Mailchimp wordt genoemd. De Mailchimp documentatiebepaalt de vereiste sleutels zoals addr1, city, state, en zip, en de facultatieve sleutels addr2 en country. De waarden voor deze velden moeten tekenreeksen zijn. Als een van de ADDRESS -veldtoewijzingen aanwezig is, geeft de bestemming het ADDRESS -object door aan de Mailchimp API voor update. Voor alle ADDRESS -velden die niet worden toegewezen, wordt de standaardwaarde NULL gebruikt, behalve voor het land dat standaard op US is ingesteld.

    De volgende toewijzingen zijn beschikbaar voor het veld ADDRESS :

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Source-veld Doelveld
    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

    U wilt bijvoorbeeld de waarde voor country bijwerken met de bestaande adresvelden addr1 , city , state en zip van de contactpersoon als 132, My Street, Kingston , New York , New York en 12401 . Om country bij te werken moet u de bestaande waarden met veranderingen (als om het even welk) en de nieuwe waarde voor land overgaan. De waarden in uw gegevensset moeten dus 132, My Street, Kingston, New York, New York, 12401 en US zijn. Als u alleen country doorgeeft en geen waarden voor addr1 , city , state en zip opgeeft, worden deze door NULL overschreven.

    Hieronder ziet u een voorbeeld met de voltooide toewijzingen:
    {het schermschot van 0} Experience Platform UI die gebiedsafbeeldingen toont.

Wanneer u klaar bent met het opgeven van de toewijzingen voor uw doelverbinding, selecteert u Next .

Gegevens exporteren valideren exported-data

Volg onderstaande stappen om te controleren of u de bestemming correct hebt ingesteld:

  • Meld u aan bij uw Mailchimp-account. Navigeer vervolgens naar de pagina Audience . Vouw vervolgens het menu Manage Contacts uit en selecteer Groups .

{het schermschot van 0} Mailchimp UI die de de groepspagina van het Publiek toont.

  • Selecteer de groep en controleer of het geselecteerde publiek is gemaakt als categorieën met de publieksnaam uit Experience Platform, die kunnen worden gevolgd door een automatisch gegenereerd achtervoegsel.
    • Deze bestemming gebruikt de geselecteerde segmenten' namen om de rentecategorie tot stand te brengen door Mailchimp te gebruiken voeg rentecategorie APItoe. Als u een nieuw doel maakt en hetzelfde publiek weer activeert, voegt Mailchimp een achtervoegsel toe om onderscheid te maken tussen de bestaande en de nieuwe segmenten.
  • Contacten waarvan de e-mails niet in de groep bestonden, worden toegevoegd aan de nieuwe categorie.
  • Voor contacten die reeds binnen de groep bestaan, worden de gegevens van het attributengebied bijgewerkt, en het contact toegevoegd aan de pas gecreëerde categorie.

{het schermschot van 0} Mailchimp UI die de de groepscategorieën van het Publiek toont.

Gegevensgebruik en -beheer data-usage-governance

Alle Adobe Experience Platform -doelen zijn compatibel met het beleid voor gegevensgebruik bij het verwerken van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform gegevensbeheer afdwingt, zie het overzicht van het Beleid van Gegevens.

Fouten en problemen oplossen errors-and-troubleshooting

Fout aangetroffen als de waarden van de Mailchimp API-sleutel of het datacenter onjuist zijn incorrect-credentials-error

Als de API-sleutel die u in het veld Password of de waarde Data center hebt opgegeven, onjuist is, geeft de interface een API-foutreactie Mailchimp weer: No options are available. Please verify the values selected for the following dependent fields: dataCenter zoals hieronder wordt weergegeven. In dit geval kunt u geen waarde selecteren in het veld Audience Name (Please select Data center first) .

het schermschot van Experience Platform UI die fout toont als uw sleutel van de Brievenchimp API of waarden van het gegevenscentrum onjuist zijn.

Als u deze fout wilt verhelpen en wilt doorgaan naar de volgende stap, moet u de juiste waarden opgeven. Verwijs naar Mailchimp gegevenscentrumidentificeren en
verzamel Mailchimp API zeer belangrijkesecties als u begeleiding nodig hebt.

Fout aangetroffen als de limiet voor Mailchimp groepsnaam is overschreden group-name-limits-error

Wanneer u het doel maakt, ontvangt u mogelijk de volgende foutberichten: Cannot have more than 60 interests per list (Across all categories) of 400 BAD_REQUEST . Dit gebeurt wanneer u de 60 groepsnamen (of rentecategorieën) in één enkele groep of over verscheidene groepen binnen de zelfde publieksgrens overschrijdt, zoals die in de wordt beschreven guardrailssectie. Als u deze fout wilt corrigeren, moet u ervoor zorgen dat de limiet voor de groepsnaam in Mailchimp niet wordt overschreden.

Mailchimp Status- en foutcodes

Verwijs naar de Mailchimp pagina van foutenvoor een uitvoerige lijst van status en foutencodes met verklaringen.

Aanvullende bronnen additional-resources

Hieronder vindt u aanvullende nuttige informatie uit de documentatie van Mailchimp :

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