Översikt över vidarebefordringstillägg för Mailchimp-händelse
Mailchimp-tillägget för händelsevidarebefordran skickar händelser till Mailchimp Marketing API som kan utlösa e-postmeddelanden för marknadsföringskampanjer, resor eller transaktioner för Mailchimp.
Det här dokumentet beskriver hur du konfigurerar tillägget och konfigurerar regler med åtgärden Lägg till händelse.
Förhandskrav
I det här dokumentet förutsätts att du känner till de relevanta Mailchimp-produkter som används av tillägget. Mer information finns i hjälpdokumentationen för Mailchimp om kampanjer, resor och transaktioner.
Det krävs ett Mailchimp-konto för att kunna använda det här tillägget. Du kan registrera dig för ett konto här. Observera följande värden som kan användas i den här handboken på kontrollpanelen för Mailchimp-kontot:
- Ditt prefix för Mailchimp-domänen
- Din API-nyckel
- Målgrupps-ID
- Standarde-postadressen"från"
Beroende på din plan för Mailchimp-kontot kan du ha begränsad tillgång till kundreseverktygen för Mailchimp.
Domänprefix
När du har loggat in på Mailchimp och landat i vyn Kontrollpanel bör webbläsarens adressfält visa en URL som https://us11.admin.mailchimp.com
eller bara us11.admin.mailchimp.com
. I det här exemplet är prefixet us11
bara en platshållare och ditt värde kommer att vara ett annat. Registrera din URL med ditt prefix för ett senare steg.
API-nyckel
Om du vill hitta API-nyckeln för ditt konto väljer du din profilikon i Mailchimp-gränssnittet och sedan Profil. Du bör se en URL som https://us11.admin.mailchimp.com/account/profile/
men med prefixet your i stället för us11
.
Välj Extras och sedan API-nycklar:
Under Dina API-nycklar kan du välja en befintlig nyckel eller välja Skapa en nyckel för att skapa en ny. Du kan skapa en ny nyckel som ska användas specifikt med det här tillägget. Kopiera API-nyckeln och spara den i ett senare steg. Mer information finns i dokumentationen för Mailchimp om hur du genererar API-nyckeln.
Audience ID och From address
Välj Målgrupp i den vänstra navigeringen och sedan Målkontrollpanelen. Välj sedan den målgrupp du tänker använda med det här tillägget. Mer information finns i Mailchimp-dokumentet om att skapa en målgrupp.
Markera målgruppen och välj Hantera målgrupp och välj Inställningar. På den här skärmen visas olika inställningar för din målgrupp.
Längst ned på inställningsskärmen ska du se Unique id for audience [audience name]
där [audience name]
är namnet på din faktiska målgrupp. Kopiera publikens ID och spara det för ett senare steg.
Välj Målgruppsnamn och standardvärden och bekräfta att Standard från e-postadress har rätt värde för dina kampanjer. Observera att Audience ID även finns i listan överst på den här sidan och är samma värde som du kopierade ned i det sista steget.
Automatisering av e-postmeddelanden
Beroende på din Mailchimp-plan och om du använder transaktionsbaserade e-postmeddelanden, kundresor eller andra Mailchimp-automatiseringar kan dina specifika reseinställningar variera.
Installation och konfigurering
I det här avsnittet beskrivs stegen för hur du installerar och konfigurerar tillägget. Om du vill spara API-nyckeln för Mailchimp på ett säkert sätt måste du använda händelsevidarebefordran av hemligheter.
Skapa en hemlighet och ett dataelement
I en egenskap för vidarebefordran av händelser skapar en Token hemlighet med namnet Mailchimp API Key
.
Sedan skapar du ett dataelement med tillägget Core och dataelementtypen Secret som refererar till den Mailchimp API Key
-hemlighet som du nyss skapade. Ange Mailchimp Token
som dataelementnamn.
Installera och konfigurera tillägget
I samma händelsevidarebefordringsegenskap väljer du Extensions, och Catalog för att visa de tillägg som är tillgängliga för installation. Här söker du efter Mailchimp-tillägget och väljer Install.
Konfigurationsskärmen visas. Under Mailchimp Server Prefix Domain Name anger du domänen som du kopierade tidigare från ditt Mailchimp-konto, inklusive ditt unika domänprefix.
http://
eller https://
i det här fältet.
Under Mailchimp token markerar du dataelementsikonen och väljer dataelementet Mailchimp Token
som du skapade tidigare. Välj Save om du vill spara ändringarna.
Tillägget är nu installerat och konfigurerat för att användas i din egenskap.
Datainsamling
När du använder det här tillägget i en regel finns det flera datavärden som tillägget skickar till Mailchimp för varje händelse. För en typisk implementering kan du konfigurera Adobe Experience Platform Web SDK-tillägget så att data skickas till Platform Edge Network för användning av tillägget i egenskapen för händelsevidarebefordran.
De data som krävs för det här tillägget kan skickas från Web SDK som antingen XDM-data (med objektet xdm
) eller data som inte är XDM (med objektet data
).
Om en kund till exempel gör ett köp eller registrerar sig för en händelse på din webbplats, kan du skicka ett bekräftelsemeddelande via Mailchimp med det här tillägget. När du har skickat den obligatoriska informationen från Web SDK till Edge Network utlöser tillägget e-postmeddelandet med Mailchimp.
Dataelement
Skärmbilden i föregående avsnitt visar de data som du kan skicka med varje händelse från det här tillägget till Mailchimp. När du har konfigurerat Web SDK att skicka dessa data till Edge Network kan du skapa dataelement i händelsevidarebefordringsegenskapen så att tillägget kan komma åt dessa värden.
Tabellen nedan innehåller mer information om varje möjligt värde.
email
arc.event.xdm._tenant.emailId
eller
arc.event.data._tenant.emailId
listId
arc.event.xdm._tenant.listId
eller
arc.event.data._tenant.listid
name
arc.event.xdm._tenant.name
eller
arc.event.data._tenant.name
properties
arc.event.xdm._tenant.properties
eller
arc.event.data._tenant.properties
isSyncing
arc.event.xdm._tenant.isSyncing
eller
arc.event.data._tenant.isSyncing
is_syncing
inställda på true
utlöser inte automatiseringaroccurredAt
arc.event.xdm._tenant.occuredAt
eller
arc.event.data._tenant.occuredAt
I egenskapen för vidarebefordran av händelser kan du skapa ett dataelement för vart och ett av de fält som beskrivs ovan. När du har skapat det kan du referera till dataelementen i Add Event-åtgärden för det här tillägget.
Du kan nu använda det här tillägget och åtgärden Lägg till händelse för att utlösa e-postmeddelanden från Mailchimp för dina målgrupper.
Dataverifiering
När du arbetar med tillägg för händelsevidarebefordran är Adobe Experience Platform Debugger mycket användbar. I avsnittet Loggar, under Edge loggar, kan du se de begäranden som har gjorts av reglerna för vidarebefordran av händelser när de har utlösts. På följande skärmbilder visas en begäran som görs till Mailchimp API av tillägget.
På Mailchimp-kontrollpanelen i vyn Activity Feed (Aktivitetsfeed) för din publik eller målmedlem visas en lista med händelser för den målgruppen eller målgruppsmedlemmen. Detta bör matcha de händelser som skickas av tillägget och visa alla valfria data som skickas, tillsammans med e-postmeddelandet eller kampanjen som de fick. Mer information finns i Hjälpguiderna för Mailchimp Automation.