Mailchimp Interest Categories-Verbindung

Mailchimp ist eine beliebte Marketing-Automatisierungsplattform und ein E-Mail-Marketing-Service, der von Unternehmen zur Verwaltung und Kommunikation von Kontakten verwendet wird. (Kunden, Kunden oder sonstige interessierte Parteien) Verwendung von Mailinglisten und E-Mail-Marketing-Kampagnen. Verwenden Sie diesen Connector, um Ihre Kontakte nach deren Interessen und Präferenzen zu sortieren.

Mailchimp Interest Categories uses Zielgruppen, Gruppen, Interessenkategorien (auch als Gruppennamen oder Gruppentitel bezeichnet). Jeder Mailchimp -Gruppe ist eine Liste von Interessenkategorien. 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.

Diese Adobe Experience Platform Ziel verwendet die Mailchimp batch subscribe or unsubscribe API API zum Erstellen Interessenkategorien und fügen dann Kontakte aus den ausgewählten Platform-Audiences in eine entsprechende Interessenkategorie ein. Sie können neue Kontakte hinzufügen oder Aktualisierung vorhandener Informationen Mailchimp contact, dann sie zu den gewünschten Gruppen hinzufügen oder daraus entfernen innerhalb eines vorhandenen Mailchimp Zielgruppe, nachdem sie in einem neuen Segment aktiviert wurden. 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 ein vorhandenes Mailchimp und beginnt mit der Erstellung der Experience Platform-Audiences, in die die Kontakte aus den einzelnen Listen aufgenommen werden. Nach dem Senden dieser Zielgruppen an Mailchimp Interest Categories, wenn in der ausgewählten Option keine Kontakte vorhanden sind Mailchimp Zielgruppe hinzugefügt werden, wird sie einer Gruppe mit dem Zielgruppennamen hinzugefügt, zu dem der Kontakt gehört. Wenn bereits Kontakte im Mailchimp Zielgruppe oder Gruppe erstellen, werden deren Informationen aktualisiert. Sobald die Daten an Mailchimp Interest Categorieskann das Sales-Team die Marketing-Kampagnen-E-Mail auswählen und an die Fußball-Interessengruppe innerhalb der Mailchimp Zielgruppe.

Voraussetzungen prerequisites

In den folgenden Abschnitten finden Sie alle Voraussetzungen, die Sie unter Experience Platform einrichten müssen. Mailchimp und für Informationen, die Sie vor der Arbeit mit dem Mailchimp Interest Categories Ziel.

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 die Mailchimp Interest Categories Ziel prerequisites-destination

Beachten Sie die folgenden Voraussetzungen, um Daten von Platform in Ihre Mailchimp Konto:

Sie müssen über eine Mailchimp account prerequisites-account

Bevor Sie eine Mailchimp Interest Categories Ziel müssen Sie zunächst sicherstellen, dass Sie über eine Mailchimp -Konto. Wenn Sie noch keine haben, rufen Sie die Seite Mailchimp Anmeldeseite , um sich zu registrieren und Ihr Konto zu erstellen.

Gather Mailchimp API-Schlüssel gather-credentials

Sie benötigen Ihre Mailchimp API-Schlüssel zum Authentifizieren der Mailchimp Interest Categories Ziel gegen Mailchimp -Konto. Die API-Schlüssel dient als Passwort wenn Sie das Ziel authentifizieren.

Wenn Sie Ihre API-Schlüssel, Melden Sie sich bei Ihrem Konto an und lesen Sie den Abschnitt Mailchimp API-Schlüssel generieren Dokumentation zu erstellen.

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

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

Identifizieren Mailchimp Rechenzentrum identify-data-center

Als Nächstes müssen Sie Ihre Mailchimp Rechenzentrum. Melden Sie sich dazu bei Ihrem Mailchimp -Konto und navigieren Sie zum API-Schlüsselabschnitt Ihres Kontos.

Der Wert ist der erste Teil der URL, die im Browser angezeigt wird. Wenn die URL https://us14.mailchimp.com/account/api/, dann ist das Rechenzentrum us14.

Er wird auch an Ihren API-Schlüssel im Formular angehängt key-dc; wenn Ihr API-Schlüssel 0123456789abcdef0123456789abcde-us14, dann ist das Rechenzentrum us14.

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

Weitere Informationen finden Sie im Abschnitt Mailchimp Dokumentation zu Grundlagen.

Leitplanken guardrails

Jeder Ihrer Mailchimp Zielgruppen können bis zu 60 Gruppennamen (oder Interessenkategorien) in einer einzelnen Gruppe oder über mehrere Gruppen innerhalb derselben Zielgruppe hinweg enthalten. Siehe Abschnitt Mailchimp Gruppen für alle erforderlichen Klarstellungen. 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 Mailchimp API.

Weitere Informationen finden Sie im Abschnitt Mailchimp Grenzwerte für ausführliche Informationen über die durch die Mailchimp API.

Unterstützte Identitäten supported-identities

Mailchimp unterstützt die Aktivierung der in der folgenden Tabelle beschriebenen Identitäten. 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 die entsprechende Mailchimp Interest Categories Der Segmentstatus wird 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 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.

Within Ziele > Katalog, suchen Sie nach Mailchimp Interest Categories. Alternativ können Sie sie unter der E-Mail-Marketing Kategorie.

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
Ihre Mailchimp Interest Categories Benutzername.
Passwort
Ihre Mailchimp API-Schlüssel, die Sie im Abschnitt Gather Mailchimp Anmeldeinformationen Abschnitt.
Ihr API-Schlüssel hat die Form {KEY}-{DC}, wobei {KEY} Der Teil bezieht sich auf den im Mailchimp API-Schlüssel und {DC} -Teil auf Mailchimp Rechenzentrum.
Sie können entweder {KEY} oder das gesamte Formular.
Wenn Ihr API-Schlüssel beispielsweise
0123456789abcdef0123456789abcde-us14,
Sie können *0123456789abcdef0123456789abcde*oder *0123456789abcdef0123456789abcde-us14*als Wert.

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
Ihre Mailchimp account data center. Siehe Abschnitt Identifizieren Mailchimp Rechenzentrum für Hinweise.
Zielgruppenname (Bitte wählen Sie zuerst Data Center aus)
Nachdem Sie die Rechenzentrum enthalten, wird diese Dropdown-Liste automatisch mit den Zielgruppennamen aus Ihren Mailchimp -Konto. Wählen Sie die Zielgruppe aus, die mit Daten aus Platform aktualisiert werden soll.
Interessenkategorie (Bitte wählen Sie zuerst Data Center und Zielgruppenname aus)
Nachdem Sie die Zielgruppenname enthält, wird diese Dropdown-Liste automatisch mit den Namen der Interessengruppen-Kategorien aus Ihrem Mailchimp -Konto. Wählen Sie den Kategorienamen aus, den Sie mit Daten aus Platform aktualisieren möchten.
TIP
Wenn der API-Schlüssel, den Sie im Passwort oder Rechenzentrum -Wert falsch ist, zeigt die Benutzeroberfläche eine Mailchimp API-Fehlerantwort: 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 der Zielgruppenname (Bitte wählen Sie zuerst Data Center aus) -Feld. 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

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

So senden Sie Ihre Zielgruppendaten ordnungsgemäß von Adobe Experience Platform an die Mailchimp Interest Categories Ziel, müssen Sie den Schritt zur 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.

So ordnen Sie Ihre XDM-Felder korrekt der Mailchimp Interest Categories Gehen Sie wie folgt vor:

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

  2. Im Quellfeld auswählen Fenster, wählen Sie die Attribute auswählen und wählen Sie das XDM-Attribut oder die Identitäts-Namespace auswählen und wählen Sie eine Identität.

  3. Im Zielgruppenfeld auswählen Fenster, wählen Sie die Identitäts-Namespace auswählen und wählen Sie eine Identität oder Attribute auswählen und wählen Sie aus der Liste der Attribute aus, die aus der Mailchimp API. Alle benutzerdefinierten Attribute, die Sie der ausgewählten Mailchimp Die Zielgruppe kann auch als Zielfelder ausgewählt werden.

    Die Zuordnungen, die zwischen Ihrem XDM-Profilschema und Mailchimp Interest Categories wie folgt aussehen: | Quellfeld | 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| |

    Zusätzlich ADDRESS ist ein spezielles Zielfeld, das als merge field in Mailchimp Zielgruppe. Die Mailchimp Dokumentation definiert die erforderlichen Schlüssel als addr1, city, state, und zipund die optionalen Schlüssel addr2 und country. Die Werte für diese Felder müssen Zeichenfolgen sein. Wenn einer der ADDRESS Feldzuordnungen vorhanden sind, übergibt das Ziel die ADDRESS -Objekt Mailchimp API zur Aktualisierung. Alle ADDRESS Felder, die nicht zugeordnet sind, haben den Standardwert NULL mit Ausnahme des Landes, in dem der Standardwert US.

    Die für die ADDRESS wie folgt aussehen:

    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 dem vorhandenen Adressfeld des Kontakts addr1, city, state, und zip Werte als 132, My Street, Kingston, New York, New York und 12401. So aktualisieren Sie die country Sie müssen die vorhandenen Werte mit Änderungen übergeben (falls vorhanden) und den neuen Wert für "country". Daher sollten die Werte in Ihrem Datensatz 132, My Street, Kingston, New York, New York, 12401, und US. So wiederholen Sie, wenn Sie nur country und stellen keine Werte für addr1, city, state, und zip werden sie von NULL.

    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 Nächste.

Ü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 Ihrer Mailchimp -Konto. Navigieren Sie dann zum Audience Seite. Erweitern Sie anschließend die Manage Contacts Menü und wählen Sie Groups.

Screenshot der Benutzeroberfläche von Mailchimp 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 mithilfe der Mailchimp Interessenkategorie-API hinzufügen. Wenn Sie ein neues Ziel erstellen und dieselben Zielgruppen erneut aktivieren, Mailchimp fügt 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.

Screenshot der Benutzeroberfläche von Mailchimp mit den Kategorien der Zielgruppe.

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 Mailchimp API-Schlüssel oder Werte im Rechenzentrum sind falsch incorrect-credentials-error

Wenn der API-Schlüssel, den Sie im Passwort oder Rechenzentrum -Wert falsch ist, zeigt die Benutzeroberfläche eine Mailchimp API-Fehlerantwort: 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 der Zielgruppenname (Bitte wählen Sie zuerst Data Center aus) -Feld.

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 Abschnitt Identifizieren Mailchimp Rechenzentrum und
Gather Mailchimp API-Schlüssel Abschnitte, wenn Sie Anleitungen benötigen.

Fehler bei Mailchimp Gruppennamenlimit überschritten 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 Abschnitt. Um diesen Fehler zu beheben, dürfen Sie die Gruppennamengrenze in Mailchimp.

Mailchimp Status- und Fehlercodes

Siehe Abschnitt Mailchimp Fehlerseite für eine umfassende Liste von Status- und Fehlercodes mit Erläuterungen.

Zusätzliche Ressourcen additional-resources

Zusätzliche nützliche Informationen aus dem Mailchimp Die Dokumentation finden Sie unten:

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