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 tala med kontakter (kunder, kunder eller andra berörda parter) med hjälp av e-postlistor och e-postkampanjer. 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, grupperoch intressekategorier (kallas även gruppnamn eller gruppnamn). 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 att skapa räntekategorier och sedan lägga till kontakter från var och en av de valda plattformsmålgrupperna i en motsvarande intressekategori. Du kan lägg till nya kontakter eller uppdatera information om befintlig Mailchimp kontakter sedan lägga till eller ta bort dem från önskad grupp inom en befintlig Mailchimp efter att ha aktiverat dem i ett nytt segment. Mailchimp Interest Groups använder de valda målgruppsnamnen från Platform som intressekategorier inom Mailchimp.

Användningsfall use-cases

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

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ålgruppen och börjar bygga upp de Experience Platform-målgrupper i vilka kontakterna från varje lista läggs till. När dessa målgrupper har skickats till Mailchimp Interest Categories, om det inte finns några kontakter i det markerade Mailchimp målgrupp som de läggs till i en grupp med det målgruppsnamn som kontakten tillhör. Om det redan finns kontakter i Mailchimp målgrupp eller grupp, så uppdateras deras information. När data har skickats till Mailchimp Interest Categorieskan säljarna välja och skicka marknadsföringskampanjer via e-post till fotbollsintressegruppen i Mailchimp målgrupp.

Förutsättningar prerequisites

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

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

Innan du aktiverar data för Mailchimp Interest Categories mål, du måste ha schema, a datauppsättningoch segment som Experience Platform.

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

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

Du måste ha en Mailchimp konto prerequisites-account

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

Samla Mailchimp API-nyckel gather-credentials

Du behöver dina Mailchimp API-nyckel autentisera Mailchimp Interest Categories mål mot Mailchimp konto. The API-nyckel fungerar som Lösenord när du autentisera målet.

Om du inte har API-nyckel, logga in på ditt konto och se Mailchimp Generera API-nyckel dokumentation för att skapa en.

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

IMPORTANT
Om du genererar API-nyckel, skriv ned det eftersom du inte kommer åt det efter genereringen.

Identifiera Mailchimp datacenter identify-data-center

Därefter måste du identifiera Mailchimp datacenter. Om du vill göra det loggar du in på Mailchimp och navigera till API-nycklar av 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/, blir datacentret us14.

Den läggs även till i din API-nyckel i formuläret key-dc; om API-nyckeln är 0123456789abcdef0123456789abcde-us14, blir datacentret us14.

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

Om du behöver mer information, se Mailchimp Grundläggande dokumentation.

Guardrails guardrails

Alla 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. Se Mailchimp grupper eventuella förtydliganden. När du når den här gränsen får du 400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories) som ett felsvar från Mailchimp API.

Se även Mailchimp hastighetsbegränsningar Detaljerad information om de gränser som anges i Mailchimp API.

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 (t.ex. e-postadress, telefonnummer, efternamn), enligt fältmappningen.
  • För varje vald publik i Platform Mailchimp Interest Categories segmentets status uppdateras 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 mål för direktuppspelning.

Anslut till målet connect

IMPORTANT
Om du vill ansluta till målet behöver du View Destinations och Manage Destinations behörigheter för åtkomstkontroll. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.

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

Inom Destinations > Catalog, sök efter Mailchimp Interest Categories. Du kan också hitta den under Email marketing kategori.

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
Dina Mailchimp Interest Categories användarnamn.
Password
Dina Mailchimp API-nyckel som du hade noterat i Samla Mailchimp autentiseringsuppgifter -avsnitt.
Din API-nyckel har formen av {KEY}-{DC}, där {KEY} refererar till värdet som anges nedåt i Mailchimp API-nyckel -avsnittet och {DC} refererar till Mailchimp datacenter.
Du kan antingen ange {KEY} eller hela formuläret.
Om API-nyckeln till exempel är
0123456789abcdef0123456789abcde-us14,
du kan ange antingen *0123456789abcdef0123456789abcde*eller *0123456789abcdef0123456789abcde-us14*som värdet.

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

Om den angivna informationen är giltig visas en Connected status 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 användargränssnittet för plattformen 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
Dina Mailchimp konto data center. Se Identifiera Mailchimp datacenter för vägledning.
Audience Name (Please select Data center first)
När du har valt Data center fylls den här listrutan automatiskt med målgruppsnamnen från 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 Mailchimp konto. Välj det kategorinamn som du vill uppdatera med data från plattformen.
TIP
Om API-nyckeln som du angav i Password fält eller Data center värdet är felaktigt, gränssnittet visar 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 från Audience Name (Please select Data center first) fält. Å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 på prenumerera på destinationsvarningar med användargränssnittet.

När du är klar med informationen för målanslutningen väljer du Next.

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

IMPORTANT

Läs Aktivera profiler och målgrupper för att strömma målgruppernas exportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.

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

Så här skickar du målgruppsdata från Adobe Experience Platform till Mailchimp Interest Categories mål 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.

Mappa XDM-fälten korrekt till Mailchimp Interest Categories målfält, följ stegen nedan:

  1. I Mapping steg, välja Add new mapping. Nu kan du se en ny mappningsrad på skärmen.

  2. I Select source field väljer du Select attributes och välj XDM-attributet eller välj Select identity namespace och välj en identitet.

  3. I Select target field väljer du Select identity namespace och välj en identitet eller välj Select attributes och välj i listan över attribut i Mailchimp API. Alla anpassade attribut som du har lagt till i det markerade Mailchimp Målgruppen kan också väljas som målfält.

    Tillgängliga mappningar mellan XDM-profilschemat och Mailchimp Interest Categories se nedan: | Källfält | 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 ADDRESS är ett särskilt målfält som kallas merge field inom Mailchimp målgrupp. The Mailchimp dokumentation definierar nödvändiga nycklar som addr1, city, stateoch zipoch valfria tangenter addr2 och country. Värdena för dessa fält måste vara strängar. Om något av ADDRESS fältkopplingar finns, målet skickar ADDRESS objekt till Mailchimp API för uppdatering. Alla ADDRESS fält som inte är mappade har standardvärdet NULL förutom det land som har standardvärdet US.

    Tillgängliga mappningar för ADDRESS anges nedan:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Källfält 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, stateoch zip värden som 132, My Street, Kingston, New York, New York och 12401. Uppdatera country du måste skicka de befintliga värdena med ändringar (i förekommande fall) och det nya värdet för landet. Värdena i datauppsättningen bör alltså vara 132, My Street, Kingston, New York, New York, 12401och US. Om du bara skickar country och anger inga värden för addr1, city, stateoch zip de skrivs över av NULL.

    Ett exempel med de slutförda mappningarna visas nedan:
    Exempel på skärmbild för användargränssnittet för plattformen 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å Mailchimp konto. Navigera sedan till Audience sida. Utöka sedan Manage Contacts meny och välj Groups.

Skärmbild av gränssnittet för Mailchimp som visar sidan för målgruppsgruppen.

  • 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 Lägg till API för räntekategori. Om du skapar ett nytt mål och aktiverar samma målgrupper igen, Mailchimp lägger till ett suffix för att skilja mellan befintliga och nya segment.
  • 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 destinationerna är kompatibla med dataanvändningsprinciper när data hanteras. Detaljerad information om hur Adobe Experience Platform använder datastyrning, se Datastyrning - översikt.

Fel och felsökning errors-and-troubleshooting

Fel påträffades om Mailchimp API-nyckeln eller datacentervärdena är felaktiga incorrect-credentials-error

Om API-nyckeln som du angav i Password fält eller Data center värdet är felaktigt, gränssnittet visar 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 från Audience Name (Please select Data center first) fält.

Skärmbilden för användargränssnittet för plattformen visar ett fel om Mailchimp API-nyckeln eller datacentervärdena ä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 Mailchimp API-nyckel om du behöver vägledning.

Fel påträffades om Mailchimp gruppnamnsgränsen har överskridits 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 skyddsräcken -avsnitt. Kontrollera att du inte överskrider gruppnamnsgränsen i Mailchimp.

Mailchimp Status- och felkoder

Se Mailchimp felsida om du vill ha en omfattande lista över status- och felkoder med förklaringar.

Ytterligare resurser additional-resources

Ytterligare användbar information från Mailchimp dokumentationen nedan:

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