Übersicht über die Ereignisweiterleitungs-Erweiterung "Mailchimp"
Der Mailchimp Ereignisweiterleitung sendet Ereignisse an die Mailchimp Marketing-API, die E-Mails für Mailchimp-Marketingkampagnen, Journey oder Transaktionen per Trigger verschicken kann.
In diesem Dokument wird beschrieben, wie Sie die Erweiterung einrichten und Regeln mithilfe der Aktion Ereignis hinzufügen konfigurieren.
Voraussetzungen
In diesem Dokument wird davon ausgegangen, dass Sie mit den relevanten Mailchimp-Produkten vertraut sind, die von der -Erweiterung genutzt werden. Weitere Informationen finden Sie in der Mailchimp-Hilfedokumentation für Kampagnen, Journey, und Transaktionen.
Für die Verwendung dieser Erweiterung ist ein Mailchimp-Konto erforderlich. Sie können sich für ein Konto anmelden here. Notieren Sie sich im Dashboard des Mailchimp-Kontos die folgenden Werte, die in diesem Handbuch verwendet werden sollen:
- Ihr Mailchimp-Domänenpräfix
- Ihr API-Schlüssel
- Die Zielgruppen-ID
- Die standardmäßige E-Mail-Adresse "from"
Abhängig von Ihrem Mailchimp-Account-Plan haben Sie möglicherweise nur eingeschränkten Zugriff auf Mailchimp-Journey-Tools.
Domänenpräfix
Nach der Anmeldung bei Mailchimp und dem Landing in der Dashboard-Ansicht sollte die Adressleiste Ihres Browsers eine URL wie https://us11.admin.mailchimp.com
oder einfach us11.admin.mailchimp.com
. In diesem Beispiel wird das Präfix us11
ist nur ein Platzhalter und Ihr Wert wird anders sein. Zeichnen Sie Ihre URL mit Ihrem Präfix für einen späteren Schritt auf.
API-Schlüssel
Um den API-Schlüssel für Ihr Konto zu finden, wählen Sie Ihr Profilsymbol in der Benutzeroberfläche von Mailchimp aus und klicken Sie dann auf Profil. Sie sollten eine URL wie https://us11.admin.mailchimp.com/account/profile/
aber mit Ihre Präfix anstelle von us11
.
Auswählen Extras, dann API-Schlüssel:
under Ihre API-Schlüssel, können Sie einen vorhandenen Schlüssel auswählen oder Schlüssel erstellen , um eine neue zu erstellen. Sie können einen neuen Schlüssel erstellen, der speziell mit dieser Erweiterung verwendet werden soll. Kopieren Sie den API-Schlüssel und speichern Sie ihn für einen späteren Schritt. Weitere Informationen finden Sie in der Mailchimp-Dokumentation zum API-Schlüssel generieren.
Zielgruppen-ID und Absenderadresse
Auswählen Zielgruppe in der linken Navigation und Zielgruppen-Dashboard. Wählen Sie anschließend die Zielgruppe aus, die Sie mit dieser Erweiterung verwenden möchten. Weitere Informationen finden Sie im Dokument Mailchimp unter Erstellen einer Zielgruppe.
Wählen Sie bei der Erstellung und Auswahl der Audience die Zielgruppe verwalten Dropdown und wählen Sie Einstellungen. Auf diesem Bildschirm werden verschiedene Einstellungen für Ihre Zielgruppe angezeigt.
Am unteren Rand des Einstellungsbildschirms sollte Folgendes angezeigt werden: Unique id for audience [audience name]
where [audience name]
ist der Name Ihrer tatsächlichen Zielgruppe. Kopieren Sie die Zielgruppen-ID und speichern Sie sie für einen späteren Schritt.
Auswählen Zielgruppenname und Standardwerte und bestätigen Sie, dass Standard von E-Mail-Adresse hat den richtigen Wert für Ihre Kampagnen. Beachten Sie, dass die Zielgruppen-ID auch oben auf dieser Seite aufgeführt wird und der Wert ist, den Sie im letzten Schritt nach unten kopiert haben.
Postimp-Automatisierung
Abhängig von Ihrem Mailchimp-Plan und der Verwendung von Transaktions-E-Mails, Journey oder anderen Mailchimp-Automatisierungen können Ihre spezifischen Journey-Einstellungen variieren.
Installation und Konfiguration
In diesem Abschnitt werden die Schritte zum Installieren und Konfigurieren der Erweiterung aufgeführt. Um den Mailchimp-API-Schlüssel sicher zu speichern, müssen Sie die Ereignisweiterleitung verwenden Geheimnisse.
Erstellen eines geheimen und Datenelements
In einer Ereignisweiterleitungseigenschaft Erstellen Sie eine Token secret aufgerufen Mailchimp API Key
.
Als Nächstes Datenelement erstellen mithilfe der Core Erweiterung und Geheimnis Datenelementtyp zum Referenzieren der Mailchimp API Key
geheim, das Sie gerade erstellt haben. Eingabe Mailchimp Token
als Datenelementname.
Installieren und Konfigurieren der Erweiterung
Wählen Sie in derselben Ereignisweiterleitungseigenschaft die Option Erweiterungen, then Katalog , um die für die Installation verfügbaren Erweiterungen anzuzeigen. Suchen Sie von hier aus nach der Mailchimp-Erweiterung und wählen Sie Installieren.
Der Konfigurationsbildschirm wird angezeigt. under Mailchimp Server Prefix Domain Name Geben Sie die Domäne ein, die Sie zuvor aus Ihrem Mailchimp-Konto kopiert haben, einschließlich Ihres eindeutigen Domain-Präfixes.
http://
oder https://
in dieses Feld ein.
under Mailchimp-Token, wählen Sie das Datenelementsymbol und wählen Sie die Mailchimp Token
-Datenelement, das Sie zuvor erstellt haben. Wählen Sie Speichern aus, um die Änderungen zu speichern.
Die Erweiterung wird jetzt installiert und für die Verwendung in Ihrer Eigenschaft konfiguriert.
Datenerfassung
Wenn Sie diese Erweiterung in einer Regel, gibt es mehrere Datenwerte, die die Erweiterung mit jedem Ereignis an Mailchimp sendet. Für eine typische Implementierung können Sie die Adobe Experience Platform Web SDK-Erweiterung senden Sie diese Daten an Platform Edge Network für die Verwendung durch die Erweiterung in der Ereignisweiterleitungseigenschaft.
Die für diese Erweiterung erforderlichen Daten können vom Web SDK entweder als XDM-Daten gesendet werden (unter Verwendung der xdm
-Objekt) oder Nicht-XDM-Daten (mithilfe der data
-Objekt).
Wenn beispielsweise ein Kunde einen Kauf tätigt oder sich für ein Ereignis auf Ihrer Site registriert, können Sie eine Bestätigungs-E-Mail über Mailchimp mit dieser Erweiterung senden. Nachdem Sie die erforderlichen Informationen vom Web SDK an das Edge-Netzwerk gesendet haben, wird die E-Mail von der Erweiterung mit Mailchimp Trigger.
Datenelemente
Der Screenshot im vorherigen Abschnitt zeigt die Daten, die Sie mit jedem Ereignis von dieser Erweiterung an Mailchimp senden können. Nachdem Sie das Web SDK so konfiguriert haben, dass diese Daten an das Edge-Netzwerk gesendet werden, können Sie Datenelemente in der Ereignisweiterleitungseigenschaft erstellen, damit die Erweiterung auf diese Werte zugreifen kann.
Die nachstehende Tabelle enthält für jeden möglichen Wert detailliertere Informationen.
email
arc.event.xdm._tenant.emailId
oder
arc.event.data._tenant.emailId
listId
arc.event.xdm._tenant.listId
oder
arc.event.data._tenant.listid
name
arc.event.xdm._tenant.name
oder
arc.event.data._tenant.name
properties
arc.event.xdm._tenant.properties
oder
arc.event.data._tenant.properties
isSyncing
arc.event.xdm._tenant.isSyncing
oder
arc.event.data._tenant.isSyncing
is_syncing
auf true
nicht Automatisierung von TriggernoccurredAt
arc.event.xdm._tenant.occuredAt
oder
arc.event.data._tenant.occuredAt
In Ihrer Ereignisweiterleitungseigenschaft können Sie für jedes der oben genannten Felder ein Datenelement erstellen. Nach der Erstellung können Sie die Datenelemente im Ereignis hinzufügen Aktion dieser Erweiterung.
Sie können diese Erweiterung und die Aktion Ereignis hinzufügen für E-Mails von Trigger Mailchimp für Ihre Zielgruppen verwenden.
Datenvalidierung
Wenn Sie mit Erweiterungen für die Ereignisweiterleitung arbeiten, wird die Adobe Experience Platform Debugger ist sehr nützlich. Im Abschnitt Protokolle unter Edge-Protokolle können Sie die Anforderungen sehen, die von Ihren Ereignisweiterleitungsregeln gestellt wurden, nachdem sie ausgelöst wurden. Die folgenden Screenshots zeigen, wie eine Anfrage von der Erweiterung an die Mailchimp-API gesendet wird.
Im Dashboard "Mailchimp"in der Ansicht "Aktivitäts-Feed"Ihrer Audience oder Audience-Mitglieder wird eine Liste der Ereignisse für diese Audience oder dieses Audience-Mitglied bereitgestellt. Dies sollte mit den von der Erweiterung gesendeten Ereignissen übereinstimmen und die gesendeten optionalen Daten zusammen mit der E-Mail oder Kampagne anzeigen, die sie erhalten haben. Siehe Hilfshandbücher für die Postimpfautomatisierung für weitere Details.