Overzicht door:sturen van mailchimp-gebeurtenis
De gebeurtenis die van de Brievenchimp 🔗 uitbreiding door:sturen verzendt gebeurtenissen naar de Marketing API van Mailchimp die e-mails voor de marketing van Mailchimp campagnes, reizen, of transacties kan teweegbrengen.
In dit document wordt beschreven hoe u de extensie instelt en regels configureert met de handeling Gebeurtenis toevoegen.
Vereisten
In dit document wordt ervan uitgegaan dat u bekend bent met de relevante Mailchimp-producten die door de extensie zijn gebruikt. Voor meer informatie, te zien gelieve de de hulpdocumentatie van Mailchimp voor campagnes, reizen, en transacties.
Een rekening Mailchimp wordt vereist om deze uitbreiding te gebruiken. U kunt omhoog voor een rekening hierondertekenen. Noteer in het dashboard voor de Mailchimp-account de volgende waarden voor gebruik in deze handleiding:
- Uw Mailchimp-domeinvoorvoegsel
- Uw API-sleutel
- De publiek-id
- Het standaard e-mailadres 'van'
Afhankelijk van uw plan van de Rekening van Mailchimp, kunt u beperkte toegang tot de hulpmiddelen van de Reizen van de Klant van Mailchimp hebben.
Domeinvoorvoegsel
Nadat u zich hebt aangemeld bij Mailchimp en hebt gepost op de dashboardweergave, geeft de adresbalk van uw browser een URL weer zoals https://us11.admin.mailchimp.com
of alleen us11.admin.mailchimp.com
. In dit voorbeeld is het voorvoegsel us11
slechts een plaatsaanduiding en is de waarde anders. Neem de URL op met het voorvoegsel voor een latere stap.
API-sleutel
Om de API sleutel voor uw rekening te vinden, selecteer uw profielpictogram in Mailchimp UI, dan uitgezocht Profiel. U zou een URL als https://us11.admin.mailchimp.com/account/profile/
maar met moeten zien uw prefix in plaats van us11
.
Selecteer Extra's, toen API sleutels:
Onder Uw API sleutels, kunt u een bestaande sleutel kiezen of u kunt selecteren een Sleutel creëren om nieuwe tot stand te brengen. U kunt een nieuwe sleutel tot stand brengen om specifiek met deze uitbreiding te gebruiken. Kopieer de API-sleutel en sla deze op voor een latere stap. Voor meer details, zie de documentatie van Mailchimp op hoe te uw API sleutelproduceren.
Auditie-id en Van adres
Selecteer Publiek in de linkernavigatie, toen het dashboard van de Publiek. Selecteer vervolgens het publiek dat u wilt gebruiken met deze extensie. Om meer te leren, zie het document van de Brievenbus op creërend een publiek.
Met uw die publiek wordt gecreeerd en wordt geselecteerd, selecteer leiden Publiek dropdown en kies Montages. In dit scherm ziet u verschillende instellingen voor uw publiek.
Onder aan het scherm Instellingen ziet u Unique id for audience [audience name]
waar [audience name]
de naam van het werkelijke publiek is. Kopieer de publiek-id en sla deze voor een latere stap op.
Selecteer {de naam en de gebreken van het publiek 0} publiek en bevestig dat Gebrek van e-mailadres de correcte waarde voor uw campagnes heeft. De publiek-id wordt ook boven aan deze pagina vermeld en is dezelfde waarde die u in de laatste stap hebt gekopieerd.
Mailchimp-automatisering
Afhankelijk van uw plan Mailchimp en of u transactiemails, de Reizen van de Klant, of andere automatiseringen van Mailchimp gebruikt, kunnen uw specifieke reismontages variëren.
Installatie en configuratie
In deze sectie worden de stappen beschreven voor het installeren en configureren van de extensie. Om veilig de sleutel van de Brievenchimp API te bewaren, moet u gebeurtenis gebruiken door:sturen geheimen.
Een geheim en gegevenselement maken
In een gebeurtenis die bezit door:sturen, creeer a Token geheimgeroepen Mailchimp API Key
.
Daarna, creeer een gegevenselementgebruikend de Core uitbreiding en een Secret type van gegevenselement om naar het Mailchimp API Key
geheim te verwijzen u enkel creeerde. Voer Mailchimp Token
in als de naam van het gegevenselement.
De extensie installeren en configureren
In de zelfde gebeurtenis die bezit door:sturen, uitgezocht Extensions, toen Catalog om de uitbreidingen te tonen beschikbaar voor installatie. Van hier, onderzoek naar de uitbreiding Mailchimp en selecteer Install.
Het configuratiescherm wordt weergegeven. Voer onder Mailchimp Server Prefix Domain Name het domein in dat u eerder van uw Mailchimp-account hebt gekopieerd, inclusief het unieke domeinvoorvoegsel.
http://
of https://
niet op in dit veld.
Selecteer onder Mailchimp token het pictogram voor het gegevenselement en kies het Mailchimp Token
-gegevenselement dat u eerder hebt gemaakt. Selecteer Save om de wijzigingen op te slaan.
De extensie is nu geïnstalleerd en geconfigureerd voor gebruik in uw eigenschap.
Dataverzameling
Wanneer het gebruiken van deze uitbreiding in a regel, zijn er verscheidene gegevenswaarden die de uitbreiding naar Mailchimp met elke gebeurtenis verzendt. Voor een typische implementatie, kunt u de uitbreiding van SDK van het Web van Adobe Experience Platformvormen om die gegevens naar Experience Platform Edge Network voor gebruik door de uitbreiding in de gebeurtenis te verzenden die bezit door:sturen.
De gegevens die door deze extensie worden vereist, kunnen vanuit Web SDK worden verzonden als XDM-gegevens (met behulp van het xdm
-object) of als niet-XDM-gegevens (met behulp van het data
-object).
Als een klant bijvoorbeeld een aankoop doet of zich registreert voor een gebeurtenis op uw site, kunt u een bevestigingsbericht verzenden via Mailchimp met deze extensie. Zodra u de vereiste informatie van Web SDK naar Edge Network verzendt, teweegbrengt de uitbreiding e-mail met Mailchimp in werking.
Gegevenselementen
Het schermafbeelding in de vorige sectie toont de gegevens die u met elke gebeurtenis van deze extensie naar Mailchimp kunt verzenden. Zodra u SDK van het Web vormt om deze gegevens naar Edge Network te verzenden, kunt u gegevenselementen in de gebeurtenis tot stand brengen die bezit door:sturen zodat kan de uitbreiding tot die waarden toegang hebben.
In de onderstaande tabel vindt u meer details voor elke mogelijke waarde.
email
arc.event.xdm._tenant.emailId
of
arc.event.data._tenant.emailId
listId
arc.event.xdm._tenant.listId
of
arc.event.data._tenant.listid
name
arc.event.xdm._tenant.name
of
arc.event.data._tenant.name
properties
arc.event.xdm._tenant.properties
of
arc.event.data._tenant.properties
isSyncing
arc.event.xdm._tenant.isSyncing
of
arc.event.data._tenant.isSyncing
is_syncing
ingesteld op true
, activeren geen signaalautomatiseringoccurredAt
arc.event.xdm._tenant.occuredAt
of
arc.event.data._tenant.occuredAt
In uw gebeurtenis die bezit door:sturen, kunt u een gegevenselement voor elk van de hierboven geschetste gebieden tot stand brengen. Nadat u een extensie hebt gemaakt, kunt u verwijzen naar de gegevenselementen in de handeling Add Event van deze extensie.
U kunt deze extensie en de handeling Gebeurtenis toevoegen nu gebruiken om mailchimp-e-mails voor uw publiek te activeren.
Gegevensvalidatie
Wanneer het werken met gebeurtenis die uitbreidingen door:sturen, is Adobe Experience Platform Debuggerzeer nuttig. In de sectie Logs, onder de logboeken van Edge kunt u de verzoeken zien die door uw gebeurtenis door:sturen regels worden gemaakt nadat zij worden teweeggebracht. De volgende schermafbeeldingen tonen een verzoek dat aan Mailchimp API door de uitbreiding wordt gedaan.
In het dashboard van Mailchimp, op de mening van de Voeding van de Activiteit van uw Publiek of Lid van het Publiek, wordt een lijst van gebeurtenissen voor dat Publiek of Lid van het Publiek verstrekt. Dit moet overeenkomen met de gebeurtenissen die door de extensie zijn verzonden en met eventuele optionele gegevens die samen met de e-mail of campagne zijn verzonden die ze hebben ontvangen. Zie de gidsen van de Hulp van de Automatisering van de Brievenjakimpvoor meer details.