DokumentationExperience PlatformZielhandbuch

Mailchimp Interest Categories-Verbindung

Last update: Tue Jul 16 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, 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.

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

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.

Ziel-Identität
Beschreibung
Zu beachten
E-Mail
E-Mail-Adresse kontaktieren
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 Segmentstatus Mailchimp Interest Categories mit dem Zielgruppenstatus von Platform aktualisiert.
Exporthäufigkeit
Streaming
Streaming-Ziele sind „immer verfügbare“ API-basierte Verbindungen. Wenn ein Profil auf der Grundlage einer Zielgruppenbewertung im Experience Platform aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Lesen Sie mehr über Streaming-Ziele.

Herstellen einer Verbindung mit dem Ziel connect

IMPORTANT
Um eine Verbindung zum Ziel herzustellen, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen und Ziele verwalten .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 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.

Feld
Beschreibung
Benutzername
Ihr Mailchimp Interest Categories Benutzername.
Passwort
Ihr Mailchimp API-Schlüssel, den Sie im Abschnitt Anmeldedaten des Zusammenführers Mailchimp eingegeben haben notiert haben.
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.

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, mit dem Sie dieses Ziel in der Zukunft erkennen werden.
Beschreibung
Eine Beschreibung, die Ihnen bei der Identifizierung dieses Ziels in der Zukunft hilft.
Rechenzentrum
Ihr Mailchimp Konto data center. Eine Anleitung dazu finden Sie im Abschnitt Identifizieren Mailchimp des Rechenzentrums .
Zielgruppenname (Bitte wählen Sie zuerst Data Center aus)
Nachdem Sie Ihr Rechenzentrum ausgewählt haben, wird diese Dropdown-Liste automatisch mit den Zielgruppennamen aus Ihrem Mailchimp -Konto gefüllt. Wählen Sie die Zielgruppe aus, die mit Daten aus Platform aktualisiert werden soll.
Interessenkategorie (Bitte wählen Sie zuerst Data Center und Audience Name aus)
Nachdem Sie Ihren Zielgruppennamen ausgewählt haben, wird diese Dropdown-Liste 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 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, 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
  • 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 🔗.
    Wählen Sie den im Workflow hervorgehobenen Identitäts-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 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:

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

  2. 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.

  3. 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:
    | Source Field | Zielfeld | Hinweise |
    | — | — | — |
    |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 als merge field bezeichnet wird. Die Mailchimp Dokumentation definiert die erforderlichen Schlüssel als addr1, city, state und zip sowie die optionalen Schlüssel addr2 und country. Die Werte für diese Felder müssen Zeichenfolgen sein. Wenn eine der ADDRESS -Feldzuordnungen vorhanden ist, übergibt das Ziel das ADDRESS -Objekt zur Aktualisierung an die Mailchimp -API. Alle nicht zugeordneten ADDRESS -Felder haben den Standardwert NULL , außer für das Land, das standardmäßig auf US 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 Adressfeldern addr1, city, state und zip als 132, My Street, Kingston, New York, New York und 12401 aktualisieren. Um die country 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 also 132, My Street, Kingston, New York, New York, 12401 und US sein. Wenn Sie nur country übergeben und keine Werte für addr1, city, state und zip bereitstellen, werden diese von NULL überschrieben.

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

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.

Mailchimp UI-Screenshot mit der Seite Zielgruppe.

  • 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.

Mailchimp UI-Screenshot mit den Zielgruppen-Kategorien.

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.

Der Screenshot der Platform-Benutzeroberfläche zeigt einen Fehler, 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
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:

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