DokumentationExperience PlatformZielhandbuch

Mailchimp Interest Categories-Verbindung

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
  • Benutzende

Mailchimp ist eine beliebte Marketing-Automatisierungsplattform und ein E-Mail-Marketing-Service, der von Unternehmen verwendet wird, um Kontakte zu verwalten und mit (Kunden, Kunden oder anderen interessierten Parteien) mithilfe von Mailinglisten und E-Mail-Marketing-Kampagnen zu sprechen. 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 ist eine Liste von Interessenskategorien. Kontakte werden einer Interessenkategorie zugeordnet, wenn sie sich über ein Anmeldeformular auf Ihrer Website für eine oder mehrere Interessenkategorien anmelden. Innerhalb einer Audience können Sie die Kontakte auch in Gruppen organisieren und mit Interessenkategorien verknüpfen. Diese können dann verwendet werden, um Segmente zu erstellen. Sie können diese Zielgruppen verwenden, um zielgerichtete Kampagnen-E-Mails an die abonnierten 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 jeder der ausgewählten Platform-Zielgruppen in eine entsprechende Interessenkategorie einzufügen. Sie können neue Kontakte hinzufügen oder die Informationen vorhandener Mailchimp Kontakte aktualisieren und sie dann hinzufügen oder aus ihren gewünschten Gruppen entfernen innerhalb einer bestehenden Mailchimp-Zielgruppe, 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 Marketing-Kampagnen use-case-send-emails

Die Verkaufsabteilung einer Sportartikel-Website möchte eine E-Mail-basierte Marketing-Kampagne an eine Liste von Kontakten senden, die sich selbst als fußballinteressiert identifiziert haben. Die Kontaktlisten werden im Datenexport als Batches vom Entwicklungsteam der Website getrennt und müssen daher verfolgt werden. Das Team identifiziert eine vorhandene Mailchimp Zielgruppe und beginnt mit der Erstellung der Experience Platform-Zielgruppen, denen die Kontakte aus jeder Liste hinzugefügt werden. Wenn diese Zielgruppen nach dem Senden an Mailchimp Interest Categories in der ausgewählten Mailchimp Zielgruppe keine Kontakte vorhanden sind, werden sie zu einer Gruppe mit dem Zielgruppennamen hinzugefügt, zu dem der Kontakt gehört. Wenn in der Mailchimp Zielgruppe oder Gruppe bereits Kontakte vorhanden sind, werden deren Informationen aktualisiert. Sobald die Daten an Mailchimp Interest Categories gesendet wurden, kann das Vertriebsteam die E-Mail zur Marketing-Kampagne auswählen und innerhalb der Mailchimp Zielgruppe an die Interessengruppe Fußball senden.

Voraussetzungen prerequisites

In den folgenden Abschnitten finden Sie alle Voraussetzungen, die Sie für das Einrichten in Experience Platform und Mailchimp benötigen, sowie Informationen, die Sie vor der Arbeit mit dem Mailchimp Interest Categories-Ziel sammeln müssen.

Voraussetzungen in 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 verfügen. Wenn Sie noch kein Konto haben, besuchen Sie die Mailchimp Anmeldeseite um sich zu registrieren und Ihr Konto zu erstellen.

Erfassen Mailchimp API-Schlüssels 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 nicht über Ihren API-Schlüssel verfügen, melden Sie sich bei Ihrem Konto an und lesen Sie die Dokumentation Mailchimp API-Schlüssel generieren um einen zu erstellen.

Ein Beispiel für einen API-Schlüssel ist 0123456789abcdef0123456789abcde-us14.

IMPORTANT
Wenn Sie den API-Schlüssel generieren, schreiben Sie ihn auf, da Sie nach der Generierung nicht mehr darauf zugreifen können.

Identifizieren Mailchimp Rechenzentrums 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 Sie in Ihrem Browser sehen. Wenn die URL https://us14.mailchimp.com/account/api/ lautet, wird das Rechenzentrum us14.

Es wird auch an Ihren API-Schlüssel in der Form key-dc angehängt. Wenn Ihr API-Schlüssel 0123456789abcdef0123456789abcde-us14 ist, wird das Rechenzentrum us14.

Notieren Sie den des Rechenzentrums (us14 in diesem Beispiel) Sie benötigen diesen Wert, wenn Sie Zieldetails ausfüllen.

Weitere Anleitungen finden Sie in der Dokumentation zu Mailchimp Grundlagen.

Leitplanken guardrails

Jede Ihrer Mailchimp Zielgruppen kann bis zu 60 Gruppennamen (oder Interessenkategorien) in einer einzelnen Gruppe oder über mehrere Gruppen innerhalb derselben Zielgruppe hinweg enthalten. Unter MailchimpGruppen findenweitere Informationen. Wenn Sie dieses Limit erreichen, erhalten Sie von der Mailchimp-API eine 400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories) als Fehlerantwort.

Weitere Informationen zu den von der Mailchimp-API auferlegten Beschränkungen finden Mailchimp unterRatenbeschrä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.

Ziel-Identität
Beschreibung
Zu beachten
E-Mail
Kontakt-E-Mail-Adresse
Obligatorisch

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.

Element
Typ
Anmerkungen
Exporttyp
Profilbasiert
  • 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 Mailchimp Interest Categories Segmentstatus mit dem Zielgruppenstatus in Platform aktualisiert.
Exporthäufigkeit
Streaming
Streaming-Ziele sind „immer verfügbare“ API-basierte Verbindungen. Wenn ein Profil in Experience Platform auf der Grundlage einer Zielgruppenbewertung aktualisiert wird, sendet der Connector die Aktualisierung nachgelagert an die Zielplattform. Lesen Sie mehr über Streaming-Ziele.

Herstellen einer Verbindung mit dem Ziel connect

IMPORTANT
Um eine Verbindung mit dem Ziel herzustellen, benötigen Sie Ziele anzeigen und Ziele verwalten Zugriffssteuerungsberechtigungen. Lesen Sie die Zugriffskontrolle – Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

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 Ziele > Katalog nach Mailchimp Interest Categories. Alternativ können Sie es 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.

Feld
Beschreibung
Benutzername
Ihr Mailchimp Interest Categories.
Passwort
Ihr Mailchimp API-), den Sie im Abschnitt Sammeln Mailchimp Anmeldeinformationen notiert hatten.
Ihr API-Schlüssel hat die Form von {KEY}-{DC}, wobei der {KEY} Teil auf den Wert verweist, der im Abschnitt Mailchimp API-Schlüssel angegeben ist, und der {DC} Teil auf das Mailchimp Rechenzentrum.
Sie können entweder den {KEY} Teil oder das gesamte Formular angeben.
Wenn Ihr API-Schlüssel beispielsweise
*0123456789abcdef0123456789abcde-us14*ist, können
entweder *0123456789abcdef0123456789abcde*oder *0123456789abcdef0123456789abcde-us14*als Wert angeben.

Screenshot der Platform-Benutzeroberfläche, auf dem die Authentifizierung gezeigt wird.

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.

Screenshot der Platform-Benutzeroberfläche mit den Zieldetails.

Feld
Beschreibung
Name
Ein Name, durch den Sie dieses Ziel in Zukunft erkennen können.
Beschreibung
Eine Beschreibung, die Ihnen hilft, dieses Ziel in Zukunft zu identifizieren.
Rechenzentrum
Ihr Mailchimp-Konto data center. Eine Anleitung dazu finden im Abschnitt Mailchimp IdentifizierenDatenzentrum“.
Zielgruppenname (bitte zuerst Rechenzentrum auswählen)
Nachdem Sie Ihr Rechenzentrum ausgewählt haben, werden in dieser Dropdown-Liste automatisch die Zielgruppennamen aus Ihrem Mailchimp-Konto angezeigt. Wählen Sie die Zielgruppe aus, die Sie mit Daten aus Platform aktualisieren möchten.
Interessenkategorie (Bitte wählen Sie zuerst Datenzentrum und Zielgruppenname aus)
Nachdem Sie Ihren Zielgruppennamen ausgewählt haben, wird dieses Dropdown-Menü automatisch mit den Namen der Interessengruppen-Kategorien aus Ihrem Mailchimp-Konto gefüllt. Wählen Sie den Kategorienamen aus, den Sie mit Daten aus Platform aktualisieren möchten.
TIP
Wenn der von Ihnen im Feld Kennwort angegebene API-Schlüssel oder der Wert Rechenzentrum 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 zuerst Rechenzentrum auswählen) 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

IMPORTANT

  • Zum Aktivieren von Daten benötigen Sie die Berechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen ​Zugriffssteuerung. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.

  • Zum Exportieren Identitäten benötigen Sie die Berechtigung Identitätsdiagramm anzeigen Zugriffssteuerung.

    Wählen Sie einen im Workflow hervorgehobenen Identity-Namespace aus, um Zielgruppen für Ziele zu aktivieren. {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 ordnungsgemäß von Adobe Experience Platform an das Mailchimp Interest Categories Ziel zu senden, müssen Sie den Schritt zur Feldzuordnung durchlaufen. Die Zuordnung besteht darin, eine Verknüpfung zwischen den Schemafeldern Ihres Experience-Datenmodells (XDM) in Ihrem Platform-Konto und den entsprechenden Entsprechungen vom Ziel zu erstellen.

Gehen Sie wie folgt vor, um Ihre XDM-Felder den Mailchimp Interest Categories-Zielfeldern korrekt zuzuordnen:

  1. Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird nun eine neue Zuordnungszeile angezeigt.

  2. Wählen Sie im Fenster Quellfeld auswählen die Kategorie Attribute auswählen und wählen Sie das XDM-Attribut oder den Identity-Namespace auswählen und wählen Sie eine Identität aus.

  3. Wählen Sie im Fenster Zielfeld auswählen die Kategorie Identity-Namespace auswählen und wählen Sie eine Identität oder Attribute auswählen aus der Liste der Attribute aus, die von der Mailchimp-API ausgefüllt werden. Alle benutzerdefinierten Attribute, die Sie der ausgewählten Mailchimp-Zielgruppe hinzugefügt haben, stehen auch als Zielfelder zur Auswahl.

    Folgende Zuordnungen sind zwischen Ihrem XDM-Profilschema und Mailchimp Interest Categories verfügbar:

    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

    Darüber hinaus ist ADDRESS ein spezielles Zielfeld, das in Ihrer Mailchimp-Zielgruppe als merge field bezeichnet wird. In Mailchimp Dokumentation werden die erforderlichen Schlüssel wie addr1, city, state und zip sowie die optionalen Schlüssel addr2 und country definiert. Die Werte für diese Felder müssen Zeichenfolgen sein. Wenn eine der ADDRESS Feldzuordnungen vorhanden ist, übergibt das Ziel das ADDRESS zur Aktualisierung an die Mailchimp-API. Für alle ADDRESS Felder, die nicht zugeordnet werden, ist standardmäßig NULL festgelegt, mit Ausnahme des Landes, das standardmäßig US.

    Für das Feld ADDRESS sind die folgenden Zuordnungen verfügbar:

    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

    Sie möchten beispielsweise den Wert für country mit den vorhandenen Adressfeldwerten addr1, city, state und zip des Kontakts wie 132, My Street, Kingston, New York, New York und 12401 aktualisieren. Um die country zu aktualisieren, müssen Sie die vorhandenen Werte mit Änderungen (falls vorhanden) und den neuen Wert für Land übergeben. Daher sollten die Werte in Ihrem Datensatz 132, My Street, Kingston, New York, New York, 12401 und US sein. Um es noch einmal zu wiederholen: Wenn Sie nur country übergeben und keine Werte für addr1, city, state und zip angeben, werden diese von NULL überschrieben.

    Nachfolgend finden Sie ein Beispiel mit den abgeschlossenen Zuordnungen:
    Beispiel-Screenshot der Platform-Benutzeroberfläche mit Feldzuordnungen.

Wenn Sie mit dem Eingeben der Zuordnungen für Ihre Zielverbindung fertig sind, klicken Sie auf Weiter.

Ü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 an. Navigieren Sie dann zur Audience. Erweitern Sie anschließend das Manage Contacts und wählen Sie Groups aus.

Screenshot der Mailchimp-Benutzeroberfläche mit der Seite „Zielgruppe“.

  • Wählen Sie die Gruppe aus und überprüfen Sie, ob die ausgewählten Zielgruppen als Kategorien mit dem Zielgruppennamen aus Platform erstellt wurden, auf den möglicherweise ein automatisch generiertes Suffix folgt.
    • Dieses Ziel verwendet die Namen der ausgewählten Segmente, um die Interessenkategorie mithilfe der API Mailchimp Interessenkategorie hinzufügen“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.
  • Bei Kontakten, die bereits in der Gruppe vorhanden sind, werden die Attributfelddaten aktualisiert und der Kontakt zur neu erstellten Kategorie hinzugefügt.

Screenshot der Mailchimp-Benutzeroberfläche mit den Zielgruppenkategorien.

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 aufgetreten, wenn Mailchimp API-Schlüssel oder die Werte des Rechenzentrums falsch sind incorrect-credentials-error

Wenn der von Ihnen im Feld Kennwort angegebene API-Schlüssel oder der Wert Rechenzentrum 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 zuerst Rechenzentrum auswählen) auswählen.

Screenshot der Platform-Benutzeroberfläche mit einer Fehlermeldung, wenn der Mailchimp-API-Schlüssel oder die Werte des Rechenzentrums falsch sind.

Um diesen Fehler zu beheben und mit dem nächsten Schritt fortzufahren, müssen Sie die richtigen Werte angeben. Siehe Identifizieren Mailchimp Rechenzentrum und
Gather Mailchimp API key-Abschnitte, wenn Sie Anleitung benötigen.

Fehler beim Überschreiten Mailchimp Limits für Gruppennamen 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 hinweg innerhalb desselben Zielgruppen-Limits überschreiten, wie im Abschnitt Leitplanken beschrieben. Um diesen Fehler zu beheben, stellen Sie sicher, dass Sie das Limit für Gruppennamen in Mailchimp nicht überschreiten.

Mailchimp Status- und Fehlercodes

Auf der Mailchimp Fehlerseite finden Sie eine umfassende Liste von Status- und Fehler-Codes mit Erläuterungen.

Zusätzliche Ressourcen additional-resources

Weitere nützliche Informationen aus der Mailchimp Dokumentation finden Sie unten:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6