Mailchimp Interest Categories-Verbindung
Mailchimp ist eine beliebte Marketing-Automatisierungsplattform und ein E-Mail-Marketing-Service, die von Unternehmen verwendet werden, um Kontakte zu verwalten (Kunden, Kunden oder sonstige interessierte Parteien) und diese über Mailinglisten und E-Mail-Marketing-Kampagnen zu erreichen. Verwenden Sie diesen Connector, um Ihre Kontakte nach deren Interessen und Präferenzen zu sortieren.
Mailchimp Interest Categories verwendet Zielgruppen, Gruppen und Interessenkategorien (auch als Gruppennamen oder Gruppentitel bezeichnet). Jede Mailchimp Gruppe ist eine Liste von Interessenskategorien. Kontakte werden einer Interessenkategorie zugeordnet, wenn sie über ein Anmeldeformular auf Ihrer Website eine oder mehrere Interessenskategorien abonnieren. Innerhalb einer Zielgruppe können Sie die Kontakte auch in Gruppen organisieren und sie Interessenkategorien zuordnen. Diese können dann zur Erstellung von Segmenten verwendet werden. Sie können diese Zielgruppen verwenden, um zielgerichtete Kampagnen-E-Mails an die angemeldeten Kontakte zu senden.
Dieses Adobe Experience Platform Ziel verwendet die Mailchimp batch subscribe or unsubscribe API-API, um Interessenkategorien zu erstellen und dann Kontakte aus den ausgewählten Platform-Audiences zu einer entsprechenden Interessenkategorie hinzuzufügen. Sie können neue Kontakte hinzufügen oder die Informationen vorhandener Mailchimp Kontakte aktualisieren und diese dann in einer vorhandenen Mailchimp-Zielgruppe durch Hinzufügen oder Entfernen aus den gewünschten Gruppen hinzufügen, nachdem Sie sie in einem neuen Segment aktiviert haben. Mailchimp Interest Groups verwendet die ausgewählten Zielgruppennamen aus Platform als Interessenkategorien in Mailchimp.
Anwendungsfälle use-cases
Damit Sie besser verstehen können, wie und wann Sie das Mailchimp Interest Categories-Ziel verwenden sollten, finden Sie hier ein Anwendungsbeispiel, das für Kundinnen und Kunden von Adobe Experience Platform mit diesem Ziel geeignet ist.
Senden von E-Mails an Kontakte für Marketingkampagnen use-case-send-emails
Die Verkaufsabteilung einer Sportartikelwebsite möchte eine E-Mail-basierte Marketing-Kampagne an eine Liste von Kontakten senden, die sich selbst als an Fußball interessiert identifiziert haben. Die Kontaktlisten werden als Batches im Datenexport getrennt, die vom Entwicklungsteam der Website empfangen wurden, und müssen daher verfolgt werden. Das Team identifiziert eine vorhandene Mailchimp -Zielgruppe und beginnt mit der Erstellung der Experience Platform-Zielgruppen, in die die Kontakte aus den einzelnen Listen aufgenommen werden. Nachdem diese Zielgruppen an Mailchimp Interest Categories gesendet wurden, werden Kontakte, die in der ausgewählten Mailchimp -Zielgruppe nicht vorhanden sind, zu einer Gruppe mit dem Zielgruppennamen hinzugefügt, zu der der Kontakt gehört. Wenn bereits Kontakte in der Mailchimp -Zielgruppe oder -Gruppe vorhanden sind, werden deren Informationen aktualisiert. Sobald die Daten an Mailchimp Interest Categories gesendet wurden, kann das Sales-Team die Marketing-Kampagnen-E-Mail auswählen und an die Fußball-Interessengruppe innerhalb der Mailchimp -Zielgruppe senden.
Voraussetzungen prerequisites
In den folgenden Abschnitten finden Sie alle Voraussetzungen, die Sie in Experience Platform und Mailchimp einrichten müssen, sowie Informationen, die Sie vor der Arbeit mit dem Mailchimp Interest Categories-Ziel erfassen müssen.
Voraussetzungen für Experience Platform prerequisites-in-experience-platform
Vor der Aktivierung der Daten für das Mailchimp Interest Categories-Ziel müssen Sie über ein Schema, einen Datensatz und Segmente verfügen, die in Experience Platform erstellt wurden.
Voraussetzungen für das Mailchimp Interest Categories-Ziel prerequisites-destination
Beachten Sie die folgenden Voraussetzungen, um Daten von Platform in Ihr Mailchimp -Konto zu exportieren:
Sie müssen über ein Mailchimp -Konto verfügen. prerequisites-account
Bevor Sie ein Mailchimp Interest Categories -Ziel erstellen können, müssen Sie zunächst sicherstellen, dass Sie über ein Mailchimp -Konto verfügen. Wenn Sie noch kein Konto haben, besuchen Sie die Mailchimp Anmeldeseite , um sich zu registrieren und Ihr Konto zu erstellen.
Sammeln von Mailchimp API-Schlüssel gather-credentials
Sie benötigen Ihren Mailchimp API-Schlüssel, um das Mailchimp Interest Categories-Ziel für Ihr Mailchimp-Konto zu authentifizieren. Der API-Schlüssel dient als Kennwort, wenn Sie das Ziel authentifizieren.
Wenn Sie Ihren API-Schlüssel nicht haben, melden Sie sich bei Ihrem Konto an und lesen Sie die Dokumentation zum Erstellen Ihres API-Schlüssels Mailchimp Generate your API key , um einen zu erstellen.
Ein Beispiel für einen API-Schlüssel ist 0123456789abcdef0123456789abcde-us14
.
Identifizieren Sie Mailchimp Rechenzentrum identify-data-center
Als Nächstes müssen Sie Ihr Mailchimp -Rechenzentrum identifizieren. Melden Sie sich dazu bei Ihrem Mailchimp -Konto an und navigieren Sie zum Abschnitt API-Schlüssel Ihres Kontos.
Der Wert ist der erste Teil der URL, die im Browser angezeigt wird. Wenn die URL https://us14
.mailchimp.com/account/api/ ist, ist das Rechenzentrum us14
.
Er wird auch im Format key-dc an Ihren API-Schlüssel angehängt. Wenn Ihr API-Schlüssel 0123456789abcdef0123456789abcde-us14
ist, ist das Rechenzentrum us14
.
Notieren Sie den Rechenzentrumswert (us14
in diesem Beispiel). Sie benötigen diesen Wert, wenn Sie Zieldetails ausfüllen.
Wenn Sie weitere Anleitungen benötigen, lesen Sie die Mailchimp Grundlagendokumentation.
Leitplanken guardrails
Jede Ihrer Mailchimp Zielgruppen kann bis zu 60 Gruppennamen (oder Interessenkategorien) in einer Gruppe oder über mehrere Gruppen innerhalb derselben Zielgruppe hinweg enthalten. Weitere Informationen finden Sie unter Mailchimp Gruppen . Wenn Sie diese Grenze erreichen, erhalten Sie eine 400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories)
-Meldung als Fehlerantwort von der Mailchimp -API.
Weitere Informationen zu den Beschränkungen, die durch die Mailchimp -API auferlegt werden, finden Sie unter Mailchimp Ratenbeschränkungen .
Unterstützte Identitäten supported-identities
Mailchimp unterstützt die Aktivierung von Identitäten, die in der folgenden Tabelle beschrieben sind. Erhalten Sie weitere Informationen zu Identitäten.
Exporttyp und -häufigkeit export-type-frequency
Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.
- Sie exportieren alle Mitglieder eines Segments zusammen mit den gewünschten Schemafeldern (z. B.: E-Mail-Adresse, Telefonnummer, Nachname), entsprechend Ihrer Feldzuordnung.
- Für jede ausgewählte Zielgruppe in Platform wird der entsprechende Segmentstatus Mailchimp Interest Categories mit dem Zielgruppenstatus von Platform aktualisiert.
Herstellen einer Verbindung mit dem Ziel connect
Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Füllen Sie im Workflow zum Konfigurieren des Ziels die Felder aus, die in den beiden folgenden Abschnitten aufgeführt sind.
Suchen Sie in Ziele > Katalog nach Mailchimp Interest Categories. Alternativ können Sie ihn unter der Kategorie E-Mail-Marketing finden.
Beim Ziel authentifizieren authenticate
Um sich beim Ziel zu authentifizieren, füllen Sie die erforderlichen Felder unten aus und wählen Sie Mit Ziel verbinden aus.
Ihr API-Schlüssel hat die Form "
{KEY}-{DC}
", wobei der "{KEY}
"-Teil auf den im Abschnitt "Mailchimp API-Schlüssel" verzeichneten Wert verweist und der "{DC}
"-Teil auf das "Mailchimp Rechenzentrum".Sie können entweder den Abschnitt
{KEY}
oder das gesamte Formular angeben.Wenn Ihr API-Schlüssel beispielsweise
0123456789abcdef0123456789abcde-us14
,ist, können Sie entweder *
0123456789abcdef0123456789abcde
*oder *0123456789abcdef0123456789abcde-us14
*als Wert angeben.
Wenn die angegebenen Details gültig sind, zeigt die Benutzeroberfläche den Status Verbunden mit einem grünen Häkchen an. Sie können dann mit dem nächsten Schritt fortfahren.
Ausfüllen der Zieldetails destination-details
Füllen Sie die folgenden erforderlichen und optionalen Felder aus, um Details für das Ziel zu konfigurieren. Ein Sternchen neben einem Feld in der Benutzeroberfläche zeigt an, dass das Feld erforderlich ist.
data center
. Eine Anleitung dazu finden Sie im Abschnitt Identifizieren Mailchimp des Rechenzentrums .No options are available. Please verify the values selected for the following dependent fields: dataCenter
, wie unten dargestellt. In diesem Fall können Sie keinen Wert aus dem Feld Zielgruppenname (Bitte wählen Sie zuerst Rechenzentrum aus) auswählen. Um diesen Fehler zu beheben, geben Sie die richtigen Werte an.Aktivieren von Warnhinweisen enable-alerts
Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem Ziel zu erhalten. Wählen Sie einen Warnhinweis aus der zu abonnierenden Liste aus, um Benachrichtigungen über den Status Ihres Datenflusses zu erhalten. Weitere Informationen zu Warnhinweisen finden Sie im Handbuch zum Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.
Wenn Sie alle Details für Ihre Zielverbindung eingegeben haben, klicken Sie auf Weiter.
Aktivieren von Zielgruppen für dieses Ziel activate
- Um Daten zu aktivieren, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen .Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
- Um identities zu exportieren, benötigen Sie die Zugriffssteuerungsberechtigung Identitätsdiagramm anzeigen 🔗.
{width="100" modal="regular"}
Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Profilen und Zielgruppen für Streaming-Zielgruppen-Exportziele.
Zuordnungsüberlegungen und Beispiel mapping-considerations-example
Um Ihre Zielgruppendaten korrekt von Adobe Experience Platform an das Ziel Mailchimp Interest Categories zu senden, müssen Sie den Schritt für die Feldzuordnung durchlaufen. Die Zuordnung besteht darin, eine Verknüpfung zwischen den Schemafeldern Ihres Experience-Datenmodell (XDM) in Ihrem Platform-Konto und den entsprechenden Entsprechungen vom Ziel zu erstellen.
Gehen Sie wie folgt vor, um Ihre XDM-Felder korrekt den Mailchimp Interest Categories -Zielfeldern zuzuordnen:
-
Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird jetzt eine neue Zuordnungszeile angezeigt.
-
Wählen Sie im Fenster Quellfeld auswählen die Kategorie Attribute auswählen aus, wählen Sie das XDM-Attribut aus oder wählen Sie den Eintrag Identitäts-Namespace auswählen und wählen Sie eine Identität aus.
-
Wählen Sie im Fenster Zielfeld auswählen den Eintrag Identitäts-Namespace auswählen aus, wählen Sie eine Identität aus oder wählen Sie die Kategorie Attribute auswählen und wählen Sie aus der Liste der Attribute aus, die in der API Mailchimp eingetragen sind. Alle benutzerdefinierten Attribute, die Sie der ausgewählten Mailchimp Zielgruppe hinzugefügt haben, stehen ebenfalls zur Auswahl als Zielfelder zur Verfügung.
Die zwischen Ihrem XDM-Profilschema und Mailchimp Interest Categories verfügbaren Zuordnungen sind wie folgt:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Quellfeld Zielfeld Anmerkungen IdentityMap: Email
Identity: email
Obligatorisch: ja xdm: person.name.firstName
Attribute: FNAME
xdm: person.name.lastName
Attribute: LNAME
xdm: person.birthDayAndMonth
Attribute: BIRTHDAY
Außerdem ist
ADDRESS
ein spezielles Zielfeld, das in Ihrer Mailchimp -Zielgruppe alsmerge field
bezeichnet wird. Die Mailchimp Dokumentation definiert die erforderlichen Schlüssel alsaddr1
,city
,state
undzip
sowie die optionalen Schlüsseladdr2
undcountry
. Die Werte für diese Felder müssen Zeichenfolgen sein. Wenn eine derADDRESS
-Feldzuordnungen vorhanden ist, übergibt das Ziel dasADDRESS
-Objekt zur Aktualisierung an die Mailchimp -API. Alle nicht zugeordnetenADDRESS
-Felder haben den StandardwertNULL
, außer für das Land, das standardmäßig aufUS
festgelegt ist.Die für das Feld
ADDRESS
verfügbaren Zuordnungen sind wie folgt:table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 Quellfeld Zielfeld 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
Beispielsweise möchten Sie den Wert für
country
mit den vorhandenen Adressfeldernaddr1
,city
,state
undzip
als132, My Street, Kingston
,New York
,New York
und12401
aktualisieren. Um diecountry
zu aktualisieren, müssen Sie die vorhandenen Werte mit den Änderungen (falls vorhanden) und dem neuen Wert für "country"übergeben. Die Werte in Ihrem Datensatz sollten also132, My Street, Kingston
,New York
,New York
,12401
undUS
sein. Wenn Sie nurcountry
übergeben und keine Werte füraddr1
,city
,state
undzip
bereitstellen, werden diese vonNULL
überschrieben.Nachfolgend finden Sie ein Beispiel mit den abgeschlossenen Zuordnungen:
Wenn Sie die Zuordnungen für Ihre Zielverbindung bereitgestellt haben, wählen Sie Weiter aus.
Überprüfen des Datenexports exported-data
Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:
- Melden Sie sich bei Ihrem Mailchimp -Konto an. Navigieren Sie dann zur Seite Audience . Erweitern Sie anschließend das Menü Manage Contacts und wählen Sie Groups aus.
- Wählen Sie die Gruppe aus und prüfen Sie, ob die ausgewählten Zielgruppen als Kategorien mit dem Zielgruppennamen aus Platform erstellt wurden. Dem können automatisch generierte Suffix folgen.
- Dieses Ziel verwendet die Namen der ausgewählten Segmente, um die Interessenkategorie mithilfe der API Mailchimp Interessenkategorie hinzufügen zu erstellen. Wenn Sie ein neues Ziel erstellen und dieselben Zielgruppen erneut aktivieren, fügt Mailchimp ein Suffix hinzu, um zwischen den vorhandenen und den neuen Segmenten zu unterscheiden.
- Kontakte, deren E-Mails nicht in der Gruppe vorhanden waren, werden der neu erstellten Kategorie hinzugefügt.
- Für Kontakte, die bereits in der Gruppe vorhanden sind, werden die Attributfelddaten aktualisiert und der Kontakt zur neu erstellten Kategorie hinzugefügt.
Datennutzung und -Governance data-usage-governance
Alle Adobe Experience Platform-Ziele sind bei der Verarbeitung Ihrer Daten mit Datennutzungsrichtlinien konform. Ausführliche Informationen darüber, wie Adobe Experience Platform Data Governance erzwingt, finden Sie unter Data Governance – Übersicht.
Fehler und Fehlerbehebung errors-and-troubleshooting
Fehler bei fehlerhafter Eingabe von Mailchimp API-Schlüssel oder Rechenzentrumswerten incorrect-credentials-error
Wenn der im Feld Kennwort angegebene API-Schlüssel oder der Wert Data Center falsch sind, zeigt die Benutzeroberfläche eine Mailchimp API-Fehlerantwort an: No options are available. Please verify the values selected for the following dependent fields: dataCenter
, wie unten dargestellt. In diesem Fall können Sie keinen Wert aus dem Feld Zielgruppenname (Bitte wählen Sie zuerst Rechenzentrum aus) auswählen.
Um diesen Fehler zu beheben und mit dem nächsten Schritt fortzufahren, müssen Sie die richtigen Werte angeben. Siehe Identifizieren Mailchimp Rechenzentrum und
Sammeln Sie Mailchimp API-Schlüssel, wenn Sie Anleitungen benötigen.
Fehler bei Überschreitung der Mailchimp Gruppennamengrenze group-name-limits-error
Beim Erstellen des Ziels erhalten Sie möglicherweise die folgenden Fehlermeldungen: Cannot have more than 60 interests per list (Across all categories)
oder 400 BAD_REQUEST
. Dies geschieht, wenn Sie die 60 Gruppennamen (oder Interessenkategorien) in einer einzelnen Gruppe oder über mehrere Gruppen innerhalb desselben Zielgruppenlimits überschreiten, wie im Abschnitt Limits beschrieben. Um diesen Fehler zu beheben, stellen Sie sicher, dass Sie die Gruppennamenbeschränkung in Mailchimp nicht überschreiten.
Mailchimp Status- und Fehlercodes
Eine umfassende Liste der Status- und Fehlercodes mit Erläuterungen finden Sie auf der Mailchimp Fehlerseite .
Zusätzliche Ressourcen additional-resources
Weitere nützliche Informationen aus der Mailchimp -Dokumentation finden Sie unten: