SendGrid-Verbindung
Übersicht overview
SendGrid ist eine beliebte Kundenkommunikationsplattform für Transaktions- und Marketing-E-Mails.
Dieses Adobe Experience Platform Ziel nutzt die SendGrid Marketing Contacts API, mit der Sie Ihre Erstanbieter-E-Mail-Profile exportieren und in einer neuen SendGrid-Zielgruppe für Ihre Geschäftsanforderungen aktivieren können.
SendGrid verwendet API-Bearer-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.
-
Sie benötigen ein SendGrid-Konto.
- Navigieren Sie zur SendGridAnmeldeseiteregistrieren Sie sich und erstellen Sie ein SendGrid-Konto, falls Sie noch keines haben.
-
Nach der Anmeldung beim SendGrid-Portal müssen Sie auch ein API-Token generieren.
-
Navigieren Sie zur SendGrid-Website und rufen Sie die Seite Settings > API Keys auf. Alternativ finden Sie in der SendGrid-Dokumentation Informationen zum Zugriff auf den entsprechenden Abschnitt in der SendGrid-App.
-
Klicken Sie abschließend auf die Schaltfläche Create API Key .
- Weitere Informationen zu den auszuführenden Aktionen Sie in derzu SendGrid .
- Wenn Sie Ihren API-Schlüssel programmgesteuert generieren möchten, lesen Sie die SendGrid-Dokumentation.
Bevor Sie Daten für das SendGrid-Ziel aktivieren, müssen Sie ein Schema, einen Datensatz und Segmente in Experience Platform erstellt haben. Weitere Informationen finden Sie AbschnittBeschränkungen“ weiter unten auf dieser Seite.
-
Für die SendGrid-API, die zum Erstellen der Mailing-Liste aus E-Mail-Profilen verwendet wird, müssen in jedem Profil eindeutige E-Mail-Adressen angegeben werden. Dies gilt unabhängig davon, ob es als Wert für (E Mail oder alternative E-Mail verwendet wird. Da die SendGrid-Verbindung Zuordnungen sowohl für E-Mail- als auch für alternative E-Mail-Werte unterstützt, stellen Sie sicher, dass alle verwendeten E-Mail-Adressen in jedem Profil des Datensatzes) eindeutig. Andernfalls führt das Senden der E-Mail-Profile an SendGrid zu einem Fehler, und dieses E-Mail-Profil ist nicht im Datenexport vorhanden.
-
Derzeit gibt es keine Funktion zum Entfernen von Profilen aus SendGrid, wenn sie aus Zielgruppen im Experience Platform entfernt werden.
Unterstützte Identitäten supported-identities
SendGrid unterstützt die Aktivierung von Identitäten, die in der folgenden Tabelle beschrieben werden. Erhalten Sie weitere Informationen zu Identitäten.
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.
Anwendungsfälle use-cases
Damit Sie besser verstehen können, wie und wann Sie das SendGrid-Ziel verwenden sollten, finden Sie hier einige Beispielanwendungsfälle, die Experience Platform Kunden mit diesem Ziel bewältigen können.
Erstellen einer Marketing-Liste für mehrere Marketing-Aktivitäten
Marketing-Teams, die SendGrid verwenden, können in SendGrid eine Mailing-Liste erstellen und mit E-Mail-Adressen füllen. Die nun in SendGrid erstellte Mailing-Liste kann anschließend für mehrere Marketing-Aktivitäten verwendet werden.
Mit Ziel verbinden 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.
Beim Ziel authentifizieren authenticate
-
Navigieren Sie in der Adobe Experience Platform-Konsole zu Ziele.
-
Wählen Sie die Katalog aus und suchen Sie nach SendGrid. Wählen Sie dann Einrichten aus. Nachdem Sie eine Verbindung zum Ziel hergestellt haben, ändert sich die Bezeichnung der Benutzeroberfläche in Segmente aktivieren.
-
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.
-
Wählen Sie die Option Neues Konto und geben Sie den Wert Bearer-Token ein. Dieser Wert ist der SendGrid-API-Schlüssel der zuvor im Abschnitt Voraussetzungen erwähnt wurde.
-
Wählen Sie Mit Ziel verbinden aus. Wenn der angegebene SendGrid API Schlüssel gültig ist, zeigt die Benutzeroberfläche den Status Verbunden 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, durch den Sie dieses Ziel in Zukunft erkennen können.
- Beschreibung: Eine optionale Beschreibung, die Ihnen hilft, dieses Ziel in Zukunft zu identifizieren.
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
-
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.
Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Profilen und Zielgruppen für Streaming-Zielgruppen-Exportziele.
Auf den folgenden Bildern finden Sie Details, die speziell für dieses Ziel gelten.
-
Wählen Sie eine oder mehrere Zielgruppen für den Export in SendGrid aus.
-
Im Schritt Zuordnung wird nach der Auswahl von Neue Zuordnung hinzufügen die Zuordnungsseite angezeigt, auf der die Quell-XDM-Felder den SendGrid-API-Zielfeldern zugeordnet werden. Die folgenden Bilder zeigen, wie Identitäts-Namespaces zwischen Experience Platform und SendGrid zugeordnet werden. Stellen Sie sicher, dass das Feld Source email wie unten gezeigt dem Feld Target external_id zugeordnet werden sollte.
-
Ordnen Sie auf ähnliche Weise die gewünschten Adobe Experience Platform-Attribute, die Sie exportieren möchten, dem SendGrid-Ziel zu.
-
Klicken Sie nach Abschluss der Zuordnungen auf Weiter, um zum Bildschirm „Überprüfung“ zu gelangen.
-
Wählen Sie Beenden aus, um die Einrichtung abzuschließen.
Die umfassende Liste der unterstützten Attributzuordnungen, die für die SendGrid-Marketing-Kontakte > Kontakt-API hinzufügen oder aktualisieren) eingerichtetkönnen, finden Sie unten.
homeAddress.street1
address_line_1
100 Zeichen
homeAddress.street2
address_line_2
100 Zeichen
_extconndev.alternate_emails
alternative_emails
- Max.: 5 Elemente
- Min.: 0 Elemente
homeAddress.city
city
60 Zeichen
homeAddress.country
Land
50 Zeichen
external_id
254 Zeichen
person.name.firstName
first_name
50 Zeichen
person.name.lastName
last_name
50 Zeichen
homeAddress.postalCode
Postal_Code
homeAddress.stateProvince
state_Province_region
50 Zeichen
Überprüfen des Datenexports in SendGrid validate
Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:
-
Wählen Sie Ziele > Durchsuchen aus, um zur Liste der Ziele zu navigieren.
-
Wählen Sie das Ziel aus und überprüfen Sie, ob der Status aktiviert ist.
-
Wechseln Sie zur Registerkarte Activation data und wählen Sie einen Zielgruppennamen aus.
-
Überwachen Sie die Zielgruppenzusammenfassung und überprüfen Sie, ob die Anzahl der Profile der im Datensatz erstellten Anzahl entspricht.
-
Die SendGrid Marketing Lists > Create List API wird verwendet, um innerhalb von SendGrid eindeutige Kontaktlisten zu erstellen, indem der Wert des list_name-Attributs mit dem Zeitstempel des Datenexports verbunden wird. Navigieren Sie zur SendGrid-Site und überprüfen Sie, ob die neue Kontaktliste entsprechend dem Namensmuster erstellt wurde.
-
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 ausgefüllt wird.
-
Ü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
- Die SendGrid-Marketing-Kontakte > Kontakt-API hinzufügen oderKontakt aktualisieren) kann 30.000 Kontakte oder 6 MB Daten akzeptieren, je nachdem, welcher Wert niedriger ist.