SendGrid-Verbindung

Übersicht overview

SendGrid ist eine beliebte Kundenkommunikationsplattform für Transaktions- und Marketing-E-Mails.

Dieses Adobe Experience Platform Ziel nutzt den SendGrid Marketing Contacts API, mit dem Sie Ihre Erstanbieter-E-Mail-Profile exportieren und in einer neuen SendGrid-Zielgruppe aktivieren können, um Ihre geschäftlichen Anforderungen zu erfüllen.

SendGrid verwendet API-Träger-Token als Authentifizierungsmechanismus für die Kommunikation mit der SendGrid-API.

Voraussetzungen prerequisites

Die folgenden Elemente sind erforderlich, bevor Sie mit der Konfiguration des Ziels beginnen.

  1. Sie benötigen ein SendGrid-Konto.

    • Rufen Sie die Seite SendGrid Sign-up auf, um sich zu registrieren und ein SendGrid-Konto zu erstellen, sofern noch keines vorhanden ist.
  2. Nach der Anmeldung beim SendGrid-Portal müssen Sie auch ein API-Token generieren.

  3. Navigieren Sie zur SendGrid-Website und rufen Sie die Seite Settings > API Keys auf. Alternativ können Sie in der SendGrid-Dokumentation auf den entsprechenden Abschnitt in der SendGrid-App zugreifen.

  4. Wählen Sie abschließend die Schaltfläche Create API Key aus.

Bevor Sie Daten für das SendGrid-Ziel aktivieren, müssen Sie über ein Schema, einen Datensatz und Segmente verfügen, die in Experience Platform erstellt wurden. Siehe auch den Abschnitt limits weiter unten auf dieser Seite.

IMPORTANT
  • Für die SendGrid-API, die zum Erstellen der Mailing-Liste aus E-Mail-Profilen verwendet wird, müssen innerhalb jedes Profils eindeutige E-Mail-Adressen angegeben werden. Dies gilt unabhängig davon, ob es als Wert für email oder alternative email verwendet wird. Da die SendGrid-Verbindung Zuordnungen für E-Mail- und alternative E-Mail-Werte unterstützt, stellen Sie sicher, dass alle verwendeten E-Mail-Adressen in jedem Profil des Datensatzes eindeutig sein sollten. Andernfalls tritt beim Senden der E-Mail-Profile an SendGrid ein Fehler auf, und dieses E-Mail-Profil ist im Datenexport nicht vorhanden.

  • Derzeit gibt es keine Funktion zum Entfernen von Profilen aus SendGrid, wenn sie in Experience Platform aus Zielgruppen entfernt werden.

Unterstützte Identitäten supported-identities

SendGrid 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
Beachten Sie, dass sowohl Nur-Text- als auch SHA256-Hash-E-Mail-Adressen von Adobe Experience Platform unterstützt werden. Wenn das Quellfeld der Experience Platform ungehashte Attribute enthält, aktivieren Sie die Option Transformation anwenden , damit Platform die Daten bei Aktivierung automatisch hasst.

Beachten Sie, dass SendGrid keine Hash-E-Mail-Adressen unterstützt, sodass nur Textdaten ohne Umwandlung an das Ziel gesendet werden.

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), wie im Bildschirm „Auswählen der Profilattribute“ im Zielaktivierungs-Workflow festgelegt.
Exporthäufigkeit
Streaming
Streaming-Ziele sind „immer verfügbare“ API-basierte Verbindungen. Sobald ein Profil in Experience Platform auf der Grundlage einer Zielgruppenauswertung aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Lesen Sie mehr über Streaming-Ziele.

Anwendungsfälle use-cases

Um Ihnen zu helfen, besser zu verstehen, wie und wann Sie das SendGrid-Ziel verwenden sollten, finden Sie hier Beispielanwendungsfälle, die Experience Platform -Kunden mit diesem Ziel lösen können.

Erstellen einer Marketingliste für mehrere Marketingaktivitäten

Marketingteams, die SendGrid verwenden, können eine Mailingliste in SendGrid erstellen und diese mit E-Mail-Adressen füllen. Die jetzt in SendGrid erstellte Mailingliste kann später für mehrere Marketing-Aktivitäten verwendet werden.

Mit Ziel verbinden 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.

Beim Ziel authentifizieren authenticate

  1. Navigieren Sie in der Konsole Adobe Experience Platform zu Ziele.

  2. Wählen Sie die Registerkarte Katalog aus und suchen Sie nach SendGrid. Wählen Sie dann Einrichten aus. Nachdem Sie eine Verbindung zum Ziel hergestellt haben, ändert sich die Beschriftung der Benutzeroberfläche in Segmente aktivieren.

  3. Ihnen wird ein Assistent angezeigt, der Sie bei der Konfiguration des SendGrid-Ziels unterstützt. Erstellen Sie das neue Ziel, indem Sie Neues Ziel konfigurieren auswählen.

  4. Wählen Sie die Option Neues Konto aus und geben Sie den Wert Trägertoken ein. Dieser Wert ist der SendGrid API-Schlüssel , der zuvor im Abschnitt Voraussetzungenerwähnt wurde.

  5. Wählen Sie Mit Ziel verbinden aus. Wenn der von Ihnen angegebene SendGrid API-Schlüssel gültig ist, zeigt die Benutzeroberfläche den Status Connected mit einem grünen Häkchen an. Sie können dann mit dem nächsten Schritt fortfahren, um zusätzliche Informationsfelder auszufüllen.

Ausfüllen der Zieldetails destination-details

Beim Einrichten dieses Ziels müssen Sie die folgenden Informationen angeben:

  • Name: Der Name, mit dem Sie dieses Ziel in der Zukunft erkennen werden.
  • Beschreibung: Eine optionale Beschreibung, die Ihnen bei der Identifizierung dieses Ziels in der Zukunft hilft.

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.

Weitere Informationen zu diesem Ziel finden Sie in den folgenden Bildern.

  1. Wählen Sie eine oder mehrere Zielgruppen aus, die in SendGrid exportiert werden sollen.

  2. Im Schritt Mapping wird nach Auswahl von Neues Mapping hinzufügen die Zuordnungsseite angezeigt, auf der die Quell-XDM-Felder den SendGrid-API-Zielfeldern zugeordnet werden. Die folgenden Abbildungen zeigen, wie Identitäts-Namespaces zwischen Experience Platform und SendGrid zugeordnet werden. Stellen Sie sicher, dass das Feld Source E-Mail dem Feld Ziel external_id zugeordnet werden sollte, wie unten dargestellt.



  3. Ordnen Sie die gewünschten Adobe Experience Platform -Attribute, die Sie exportieren möchten, dem SendGrid-Ziel zu.

  4. Wählen Sie nach Abschluss der Zuordnungen Weiter aus, um zum Überprüfungsbildschirm zu gelangen.

  5. Wählen Sie Beenden aus, um das Setup abzuschließen.

Nachfolgend finden Sie eine umfassende Liste der unterstützten Attributzuordnungen, die für die Marketing-Kontakte mit dem Namen SendGrid > Kontakt-API hinzufügen oder aktualisieren eingerichtet werden können.

Quellfeld
Zielfeld
Typ
Beschreibung
Beschränkungen
xdm:
homeAddress.street1
xdm:
address_line_1
Zeichenfolge
Die erste Zeile der Adresse.
Max. Länge:
100 Zeichen
xdm:
homeAddress.street2
xdm:
address_line_2
Zeichenfolge
Eine optionale zweite Zeile für die Adresse.
Max. Länge:
100 Zeichen
xdm:
_extconndev.alternate_emails
xdm:
alternative_emails
Array of String
Zusätzliche E-Mails, die mit dem Kontakt verknüpft sind.
  • Maximal 5 Elemente
  • Min.: 0 Elemente
xdm:
homeAddress.city
xdm:
city
Zeichenfolge
Die Stadt des Kontakts.
Max. Länge:
60 Zeichen
xdm:
homeAddress.country
xdm:
country
Zeichenfolge
Das Land des Kontakts. Kann ein vollständiger Name oder eine Abkürzung sein.
Max. Länge:
50 Zeichen
identityMap:
Email
Identität:
external_id
Zeichenfolge
Die primäre E-Mail des Kontakts. Dies muss eine gültige E-Mail sein.
Max. Länge:
254 Zeichen
xdm:
person.name.firstName
xdm:
first_name
Zeichenfolge
Name des Kontakts
Max. Länge:
50 Zeichen
xdm:
person.name.lastName
xdm:
last_name
Zeichenfolge
Familienname des Kontakts
Max. Länge:
50 Zeichen
xdm:
homeAddress.postalCode
xdm:
postal_code
Zeichenfolge
Postleitzahl des Kontakts oder andere Postleitzahlen.
xdm:
homeAddress.stateProvince
xdm:
state_Province_region
Zeichenfolge
Das Bundesland, die Provinz oder die Region des Kontakts.
Max. Länge:
50 Zeichen

Validieren des Datenexports in SendGrid validate

Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:

  1. Wählen Sie Ziele > Durchsuchen aus, um zur Liste der Ziele zu navigieren.

  2. Wählen Sie das Ziel aus und überprüfen Sie, ob der Status aktiviert ist.

  3. Wechseln Sie zur Registerkarte Activation data und wählen Sie einen Zielgruppennamen aus.

  4. Überwachen Sie die Zielgruppenzusammenfassung und überprüfen Sie, ob die Anzahl der Profile der im Datensatz erstellten Anzahl entspricht.

  5. Die Marketing-Listen SendGrid > Liste erstellen-API wird verwendet, um innerhalb von SendGrid eindeutige Kontaktlisten zu erstellen, indem der Wert des Attributs list_name und der Zeitstempel des Datenexports hinzugefügt werden. Navigieren Sie zur SendGrid-Site und überprüfen Sie, ob die neue Kontaktliste erstellt wurde, die dem Namensmuster entspricht.

  6. Wählen Sie die neu erstellte Kontaktliste aus und überprüfen Sie, ob der neue E-Mail-Datensatz aus dem von Ihnen erstellten Datensatz in der neuen Kontaktliste eingetragen wird.

  7. Überprüfen Sie außerdem einige E-Mails, um zu überprüfen, ob die Feldzuordnung korrekt ist.

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.

Zusätzliche Ressourcen additional-resources

Dieses SendGrid-Ziel nutzt die folgenden APIs:

Beschränkungen limits

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