Overzicht door:sturen van mailchimp-gebeurtenis
Mailchimp gebeurtenis doorsturen De extensie verzendt gebeurtenissen naar de Mailchimp Marketing-API die e-mails voor Mailchimp-marketingcampagnes, -reizen of -transacties kan activeren.
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, gelieve te zien de de hulpdocumentatie van Mailchimp voor campagnes, reizen, en transacties.
Een rekening Mailchimp wordt vereist om deze uitbreiding te gebruiken. U kunt zich aanmelden voor een account hier. 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
Na het aanmelden bij Mailchimp en het landen op de mening van het Dashboard, zou de adresbar van uw browser URL als moeten tonen https://us11.admin.mailchimp.com
of alleen us11.admin.mailchimp.com
. In dit voorbeeld wordt het voorvoegsel us11
is slechts een placeholder en uw waarde zal verschillend zijn. 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 moet een URL zien zoals https://us11.admin.mailchimp.com/account/profile/
maar met uw prefix in plaats van us11
.
Selecteren Extra's vervolgens API-sleutels:
Onder Uw API-sleutels, kunt u een bestaande toets kiezen of Een sleutel maken om een nieuwe te maken. 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 over hoe te API-sleutel genereren.
Auditie-id en Van adres
Selecteren Publiek in de linkernavigatie, dan Publiek-dashboard. Selecteer vervolgens het publiek dat u wilt gebruiken met deze extensie. Om meer te leren, zie het document van de Brievenbus op een publiek maken.
Selecteer de doelgroep Publiek beheren vervolgkeuzelijst en kies Instellingen. 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]
Dit is de naam van het werkelijke publiek. Kopieer de publiek-id en sla deze voor een latere stap op.
Selecteren Auditienaam en standaardwaarden en bevestigt dat Standaard van e-mailadres heeft de juiste waarde voor uw campagnes. 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 de sleutel van de Mailchimp API veilig te bewaren, moet u gebeurtenis gebruiken door:sturen geheimen.
Een geheim en gegevenselement maken
In een gebeurtenis die bezit door:sturen, een Token geheim gebeld Mailchimp API Key
.
Volgende, een gegevenselement maken met de Core en Secret het elementtype van gegevens om naar Mailchimp API Key
geheim dat je zojuist hebt gemaakt. Enter Mailchimp Token
als naam voor gegevenselement.
De extensie installeren en configureren
In de zelfde gebeurtenis die bezit door:sturen, uitgezocht Extensions, dan Catalog om de extensies weer te geven die beschikbaar zijn voor installatie. Van hier, onderzoek naar de uitbreiding Mailchimp en selecteer Install.
Het configuratiescherm wordt weergegeven. Onder Mailchimp Server Prefix Domain Name, ga het domein in u vroeger van uw rekening Mailchimp, met inbegrip van uw uniek domeinprefix kopieerde.
http://
of https://
op dit gebied.
Onder Mailchimp token, selecteert u het pictogram van het gegevenselement en kiest u de optie Mailchimp Token
gegevenselement dat u eerder hebt gemaakt. Selecteren Save om de wijzigingen op te slaan
De extensie is nu geïnstalleerd en geconfigureerd voor gebruik in uw eigenschap.
Gegevensverzameling
Wanneer u deze extensie in een regel, zijn er verscheidene gegevenswaarden die de uitbreiding naar Mailchimp met elke gebeurtenis verzendt. Voor een typische implementatie, kunt u vormen Adobe Experience Platform Web SDK-extensie om die gegevens te verzenden naar Platform Edge Network voor gebruik door de uitbreiding in de gebeurtenis die bezit door:sturen.
De gegevens die door deze uitbreiding worden vereist kunnen van SDK van het Web als of gegevens XDM (het gebruiken van xdm
object) of niet-XDM-gegevens (met de 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 SDK van het Web naar het Netwerk van de Rand verzendt, teweegbrengt de uitbreiding e-mail met Mailchimp.
Gegevenselementen
Het schermafbeelding in de vorige sectie toont de gegevens die u met elke gebeurtenis van deze extensie naar Mailchimp kunt verzenden. Zodra u het Web SDK vormt om deze gegevens naar het Netwerk van de Rand te verzenden, kunt u gegevenselementen in het gebeurtenis creëren door:sturen bezit 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
instellen op true
niet triggerautomatiseringoccurredAt
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 de gegevenselementen hebt gemaakt, kunt u verwijzen naar de gegevenselementen in de Add Event actie van deze verlenging.
U kunt deze extensie en de handeling Gebeurtenis toevoegen nu gebruiken om mailchimp-e-mails voor uw publiek te activeren.
Gegevensvalidatie
Wanneer u werkt met het doorsturen van extensies voor gebeurtenissen, Adobe Experience Platform Debugger is zeer nuttig. In de sectie Logs, onder de logboeken van de Rand 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 Hulplijnen voor Help bij Mailchimp Automation voor meer informatie .