Mailchimp Interest Categories-anslutning

Mailchimp är en populär plattform för automatiserad marknadsföring och en e-postmarknadsföringstjänst som används av företag för att hantera och kommunicera med kontakter (kunder, kunder eller andra berörda parter) med hjälp av e-postlistor och e-postmarknadsföringskampanjer. Använd den här kopplingen för att sortera dina kontakter baserat på deras intressen och önskemål.

Mailchimp Interest Categories använder målgrupper, grupper och intressekategorier (kallas även gruppnamn eller grupprubriker). Varje Mailchimp-grupp är en lista över intressekategorier. Kontakter är kopplade till en intressekategori när de prenumererar på en eller flera intressekategorier via ett registreringsformulär på din webbplats. Inom en målgrupp kan du också ordna kontakterna i grupper och associera dem med intressekategorier, och dessa kan sedan användas för att skapa segment. Du kan använda dessa målgrupper för att sända riktade kampanjer via e-post till de prenumererade kontakterna.

Detta Adobe Experience Platform mål använder Mailchimp batch subscribe or unsubscribe API-API:t för att skapa intressekategorier och lägger sedan till kontakter från var och en av de valda plattformspublikerna i en motsvarande intressekategori. Du kan lägga till nya kontakter eller uppdatera informationen för befintliga Mailchimp kontakter och sedan lägga till eller ta bort dem från sina önskade grupper inom en befintlig Mailchimp målgrupp efter att du har aktiverat dem i ett nytt segment. Mailchimp Interest Groups använder de valda målgruppsnamnen från plattformen som intressekategorier i Mailchimp.

Användningsfall use-cases

För att du bättre ska kunna förstå hur och när du ska använda målet Mailchimp Interest Categories finns det ett exempel på användning som Adobe Experience Platform-kunder kan lösa genom att använda det här målet.

Skicka e-post till kontakter för marknadsföringskampanjer use-case-send-emails

Försäljningsavdelningen på en webbplats för sportartiklar vill sända en e-postbaserad marknadsföringskampanj till en lista över kontakter som själva har identifierats som intresserade av fotboll. Listorna över kontakter delas upp som grupper i dataexporten som tas emot från webbplatsens utvecklingsteam och måste därför spåras. Teamet identifierar en befintlig Mailchimp-målgrupp och börjar bygga upp de Experience Platform-målgrupper i vilka kontakterna från varje lista läggs till. När de här målgrupperna har skickats till Mailchimp Interest Categories läggs de till i en grupp med målgruppsnamnet som kontakten tillhör om det inte finns några kontakter i den valda Mailchimp-målgruppen. Om det redan finns kontakter i målgruppen eller gruppen Mailchimp uppdateras deras information. När data har skickats över till Mailchimp Interest Categories kan säljarna välja och skicka marknadsföringskampanjens e-post till fotbollsintressegruppen inom Mailchimp-målgruppen.

Förhandskrav prerequisites

I avsnitten nedan finns information om eventuella krav som du måste ställa in i Experience Platform och Mailchimp och om information som du måste samla in innan du kan arbeta med målet för Mailchimp Interest Categories.

Förutsättningar i Experience Platform prerequisites-in-experience-platform

Innan du aktiverar data till målet Mailchimp Interest Categories måste du ha ett schema, en datamängd och segment som skapats i Experience Platform.

Krav för målet Mailchimp Interest Categories prerequisites-destination

Observera följande krav för att kunna exportera data från Platform till ditt Mailchimp-konto:

Du måste ha ett Mailchimp-konto prerequisites-account

Innan du kan skapa ett Mailchimp Interest Categories-mål måste du se till att du har ett Mailchimp-konto. Om du inte redan har en, gå till Mailchimp registreringssidan för att registrera och skapa ditt konto.

Samla in Mailchimp API-nyckel gather-credentials

Du behöver din Mailchimp API-nyckel för att autentisera Mailchimp Interest Categories-målet mot ditt Mailchimp-konto. API-nyckeln fungerar som Lösenord när du autentiserar målet.

Om du inte har din API-nyckel loggar du in på ditt konto och skapar en i dokumentationen för Mailchimp Generera API-nyckeln.

Ett exempel på en API-nyckel är 0123456789abcdef0123456789abcde-us14.

IMPORTANT
Om du genererar API-nyckeln skriver du ned den eftersom du inte kommer att kunna komma åt den efter genereringen.

Identifiera datacenter för Mailchimp identify-data-center

Därefter måste du identifiera ditt Mailchimp-datacenter. Det gör du genom att logga in på ditt Mailchimp-konto och navigera till avsnittet API-nycklar för ditt konto.

Värdet är den första delen av webbadressen som visas i webbläsaren. Om URL:en är https://us14.mailchimp.com/account/api/ är datacentret us14.

Den läggs också till i API-nyckeln i formatet key-dc. Om API-nyckeln är 0123456789abcdef0123456789abcde-us14 är datacentret us14.

Skriv ned datacentervärdet (us14 i det här exemplet), du behöver det här värdet när du fyller i målinformationen.

Om du behöver mer hjälp kan du läsa Mailchimp Grundläggande dokumentation.

Guardrails guardrails

Var och en av dina Mailchimp-målgrupper kan innehålla upp till 60 gruppnamn (eller intressekategorier) i en enda grupp eller i flera grupper inom samma målgrupp. Mer information finns i Mailchimp grupper. När du når den här gränsen får du ett 400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories)-meddelande som ett felsvar från API:t Mailchimp.

Se även Mailchimp tariffgränser för detaljerad information om de begränsningar som gäller för API:t Mailchimp.

Identiteter som stöds supported-identities

Mailchimp stöder aktivering av identiteter som beskrivs i tabellen nedan. Läs mer om identiteter.

Målidentitet
Beskrivning
Överväganden
E-post
E-postadress
Obligatoriskt

Exportera typ och frekvens export-type-frequency

Se tabellen nedan för information om exporttyp och frekvens för destinationen.

Objekt
Typ
Anteckningar
Exporttyp
Profile-based
  • Du exporterar alla medlemmar i ett segment, tillsammans med de önskade schemafälten (till exempel e-postadress, telefonnummer, efternamn), enligt fältmappningen.
  • För varje vald målgrupp i Platform uppdateras motsvarande Mailchimp Interest Categories-segmentstatus med målgruppsstatus från Platform.
Exportfrekvens
Streaming
Direktuppspelningsmål är alltid på API-baserade anslutningar. När en profil uppdateras i Experience Platform baserat på målgruppsutvärdering skickar anslutaren uppdateringen nedströms till målplattformen. Läs mer om direktuppspelningsmål.

Anslut till målet connect

IMPORTANT
Om du vill ansluta till målet behöver du behörigheterna View Destinations och Manage Destinations åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekursen för destinationskonfiguration. I arbetsflödet för att konfigurera mål fyller du i fälten som listas i de två avsnitten nedan.

Sök efter Mailchimp Interest Categories inom Destinations > Catalog. Du kan också hitta den under kategorin Email marketing.

Autentisera till mål authenticate

Om du vill autentisera mot målet fyller du i de obligatoriska fälten nedan och väljer Connect to destination.

Fält
Beskrivning
Username
Ditt Mailchimp Interest Categories-användarnamn.
Password
Din Mailchimp API-nyckel, som du har noterat i avsnittet Samla Mailchimp inloggningsuppgifter.
Din API-nyckel har formen av {KEY}-{DC}, där delen {KEY} refererar till det värde som anges i avsnittet Mailchimp API-nyckeloch delen {DC} refererar till Mailchimp datacenter.
Du kan antingen ange delen {KEY} eller hela formuläret.
Om din API-nyckel till exempel är
0123456789abcdef0123456789abcde-us14
kan du ange antingen *0123456789abcdef0123456789abcde*eller *0123456789abcdef0123456789abcde-us14*som värde.

Skärmbild av användargränssnittet för plattformen som visar hur du autentiserar.

Om den angivna informationen är giltig visas statusen Connected med en grön bockmarkering. Du kan sedan gå vidare till nästa steg.

Fyll i målinformation destination-details

Om du vill konfigurera information för målet fyller du i de obligatoriska och valfria fälten nedan. En asterisk bredvid ett fält i användargränssnittet anger att fältet är obligatoriskt.

Skärmbild för plattformsgränssnitt som visar målinformationen.

Fält
Beskrivning
Name
Ett namn som du känner igen det här målet med i framtiden.
Description
En beskrivning som hjälper dig att identifiera det här målet i framtiden.
Data center
Ditt Mailchimp-konto data center. Mer information finns i avsnittet Identifiera Mailchimp datacenter.
Audience Name (Please select Data center first)
När du har valt Data center fylls den här listrutan automatiskt i med målgruppsnamnen från ditt Mailchimp-konto. Välj den målgrupp som du vill uppdatera med data från Platform.
Interest Category (Please select Data center and Audience Name first)
När du har valt Audience Name fylls den här listrutan automatiskt i med intressegruppkategorinamnen från ditt Mailchimp-konto. Välj det kategorinamn som du vill uppdatera med data från plattformen.
TIP
Om API-nyckeln som du angav i fältet Password eller värdet Data center är felaktig visas ett Mailchimp API-felsvar: No options are available. Please verify the values selected for the following dependent fields: dataCenter enligt nedan. I det här fallet kan du inte välja ett värde i fältet Audience Name (Please select Data center first). Åtgärda felet genom att ange rätt värden.

Aktivera aviseringar enable-alerts

Du kan aktivera varningar för att få meddelanden om dataflödets status till ditt mål. Välj en avisering i listan om du vill prenumerera och få meddelanden om statusen för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med användargränssnittet.

Välj Next när du är klar med att ange information för målanslutningen.

Aktivera målgrupper till det här målet activate

IMPORTANT
  • För att aktivera data behöver du behörigheterna View Destinations, Activate Destinations, View Profiles och View Segments åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.
  • Om du vill exportera identiteter måste du ha View Identity Graph åtkomstkontrollbehörighet.
    Markera identitetsnamnområdet som är markerat i arbetsflödet för att aktivera målgrupper till mål. {width="100" modal="regular"}

Läs Aktivera profiler och målgrupper för att direktuppspela målgruppsexportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.

Mappa överväganden och exempel mapping-considerations-example

Om du vill skicka målgruppsdata från Adobe Experience Platform till målet Mailchimp Interest Categories måste du gå igenom fältmappningssteget. Mappningen består av att skapa en länk mellan XDM-schemafälten (Experience Data Model) i ditt plattformskonto och motsvarande motsvarigheter från målmålet.

Följ stegen nedan för att mappa dina XDM-fält korrekt till målfälten för Mailchimp Interest Categories:

  1. Välj Add new mapping i steget Mapping. Nu kan du se en ny mappningsrad på skärmen.

  2. Välj kategorin Select attributes i fönstret Select source field och markera XDM-attributet eller välj Select identity namespace och välj en identitet.

  3. I fönstret Select target field väljer du Select identity namespace och en identitet eller väljer Select attributes-kategori och väljer i listan över attribut i API:t för Mailchimp . Alla anpassade attribut som du har lagt till i den valda målgruppen för Mailchimp är också tillgängliga för markering som målfält.

    De tillgängliga mappningarna mellan ditt XDM-profilschema och Mailchimp Interest Categories är som följer:
    | Source Field | Målfält | Anteckningar |
    | — | — | — |
    |IdentityMap: Email|Identity: email| Obligatoriskt: Ja |
    |xdm: person.name.firstName|Attribute: FNAME| |
    |xdm: person.name.lastName|Attribute: LNAME| |
    |xdm: person.birthDayAndMonth|Attribute: BIRTHDAY| |

    Dessutom är ADDRESS ett särskilt målfält som kallas merge field inom din Mailchimp-målgrupp. I Mailchimp dokumentationen definieras de nödvändiga nycklarna som addr1, city, state och zip samt de valfria nycklarna addr2 och country. Värdena för dessa fält måste vara strängar. Om någon av ADDRESS-fältmappningarna finns skickar målet ADDRESS-objektet till Mailchimp-API:t för uppdatering. Alla ADDRESS-fält som inte är mappade har standardvärdet NULL förutom för det land som har standardvärdet US.

    Tillgängliga mappningar för fältet ADDRESS är som följer:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Source Field Målfält
    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

    Du vill till exempel uppdatera värdet för country med kontaktens befintliga adressfält addr1, city, state och zip som 132, My Street, Kingston, New York, New York och 12401. Om du vill uppdatera country måste du skicka de befintliga värdena med ändringarna (om det finns någon) och det nya värdet för landet. Värdena i datauppsättningen bör därför vara 132, My Street, Kingston, New York, New York, 12401 och US. Om du bara skickar country och inte anger värden för addr1, city, state och zip skrivs de över av NULL.

    Ett exempel med de slutförda mappningarna visas nedan:
    Exempel på skärmbild för plattformsgränssnitt som visar fältmappningar.

När du har angett mappningarna för målanslutningen väljer du Next.

Validera dataexport exported-data

Följ stegen nedan för att verifiera att du har konfigurerat målet korrekt:

  • Logga in på ditt Mailchimp-konto. Gå sedan till sidan Audience. Expandera sedan menyn Manage Contacts och välj Groups.

Skärmbild för Mailchimp-användargränssnitt som visar sidan Målgrupp.

  • Markera gruppen och kontrollera om de valda målgrupperna har skapats som kategorier med målgruppsnamnet från Platform, som kan följas av ett automatiskt genererat suffix.
    • Det här målet använder de valda segmentens namn för att skapa intressekategorin med hjälp av Mailchimp API:t för Lägg till intressekategori. Om du skapar ett nytt mål och aktiverar samma målgrupper igen lägger Mailchimp till ett suffix som skiljer mellan det befintliga och det nya segmentet.
  • Kontakter vars e-postmeddelanden inte fanns i gruppen läggs till i kategorin som skapades nyligen.
  • För kontakter som redan finns i gruppen uppdateras attributfältsdata och kontakten läggs till i den nyligen skapade kategorin.

Skärmbild av användargränssnittet för Mailchimp som visar kategorierna för målgruppen.

Dataanvändning och styrning data-usage-governance

Alla Adobe Experience Platform-mål är kompatibla med dataanvändningsprinciper när data hanteras. Mer information om hur Adobe Experience Platform använder datastyrning finns i Datastyrningsöversikten.

Fel och felsökning errors-and-troubleshooting

Ett fel påträffades om Mailchimp API-nyckel eller datacentervärden är felaktiga incorrect-credentials-error

Om API-nyckeln som du angav i fältet Password eller värdet Data center är felaktig visas ett Mailchimp API-felsvar: No options are available. Please verify the values selected for the following dependent fields: dataCenter enligt nedan. I det här fallet kan du inte välja ett värde i fältet Audience Name (Please select Data center first).

Skärmbilden för användargränssnittet för plattformen visar ett fel om API-nyckeln eller datacentrets värden för Mailchimp är felaktiga.

Du måste ange rätt värden för att kunna åtgärda felet och fortsätta till nästa steg. Se Identifiera Mailchimp datacenter och
Samla in Mailchimp API-nyckelavsnitt om du behöver hjälp.

Ett fel påträffades om gränsen för gruppnamnet Mailchimp överskreds group-name-limits-error

När du skapar målet kan du få följande felmeddelanden: Cannot have more than 60 interests per list (Across all categories) eller 400 BAD_REQUEST. Detta inträffar när du överskrider de 60 gruppnamnen (eller intressekategorierna) i en enskild grupp eller i flera grupper inom samma målgruppsgräns, vilket beskrivs i avsnittet skyddsutkast. Kontrollera att du inte överskrider gruppnamnsgränsen i Mailchimp om du vill åtgärda det här felet.

Mailchimp Status- och felkoder

På sidan Mailchimp errors finns en omfattande lista över status- och felkoder med förklaringar.

Ytterligare resurser additional-resources

Ytterligare användbar information från dokumentationen för Mailchimp finns nedan:

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