SendGrid-Verbindung
Übersicht overview
SendGrid ist eine beliebte Kundenkommunikationsplattform für Transaktions- und Marketingnachrichten.
Diese Adobe Experience Platform Ziel nutzt die SendGrid Marketing Contacts API, mit dem Sie Ihre Erstanbieter-E-Mail-Profile exportieren und in einer neuen SendGrid-Zielgruppe für Ihre geschäftlichen Anforderungen aktivieren können.
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.
-
Sie benötigen ein SendGrid-Konto.
- Navigieren Sie zum SendGrid anmelden Seite, um sich zu registrieren und ein SendGrid-Konto zu erstellen, falls noch keines vorhanden ist.
-
Nach der Anmeldung beim SendGrid-Portal müssen Sie auch ein API-Token generieren.
-
Navigieren Sie zur SendGrid-Website und rufen Sie die Settings > API Keys Seite. Weitere Informationen finden Sie im Abschnitt SendGrid-Dokumentation , um auf den entsprechenden Abschnitt in der SendGrid-App zuzugreifen.
-
Wählen Sie abschließend die Create API Key Schaltfläche.
- Siehe Abschnitt SendGrid-Dokumentation, wenn Sie Anleitungen zu den auszuführenden Aktionen benötigen.
- Informationen zum programmgesteuerten Generieren Ihres API-Schlüssels finden Sie im Abschnitt SendGrid-Dokumentation.
Bevor Sie Daten für das SendGrid-Ziel aktivieren, müssen Sie über eine schema, a Datensatz, und Segmente erstellt in Experience Platform. Siehe auch Abschnitt limits weiter unten auf dieser Seite.
-
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 ist unabhängig davon, ob es als Wert für email oder alternative email. Da die SendGrid-Verbindung Zuordnungen für E-Mail- und alternative E-Mail-Werte unterstützt, müssen Sie sicherstellen, dass alle verwendeten E-Mail-Adressen innerhalb jedes Profils der Datensatz. 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.
Beachten Sie Folgendes: SendGrid unterstützt keine Hash-E-Mail-Adressen, daher werden nur Textdaten ohne Umwandlung an das Ziel gesendet.
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
Hier finden Sie Beispielanwendungsfälle, die Ihnen helfen, besser zu verstehen, wie und wann Sie das SendGrid-Ziel verwenden sollten. Experience Platform -Kunden können mit diesem Ziel eine Lösung finden.
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
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
-
Innerhalb der Adobe Experience Platform Konsole, navigieren Sie zu Ziele.
-
Wählen Sie die Katalog Registerkarte und suchen Sie nach SendGrid. Wählen Sie anschließend Einrichten. Nachdem Sie eine Verbindung zum Ziel hergestellt haben, ändert sich die Beschriftung 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 durch Auswahl von Neues Ziel konfigurieren.
-
Wählen Sie die Neues Konto und füllen Sie die Trägertoken -Wert. Dieser Wert ist das SendGrid API-Schlüssel zuvor in Abschnitt mit Voraussetzungen.
-
Auswählen Mit Ziel verbinden. Wenn das SendGrid API-Schlüssel Wenn Sie angegeben haben, dass gültig ist, zeigt die Benutzeroberfläche eine Verbunden mit einem grünen Häkchen angezeigt wird, können Sie 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
- Um Daten zu aktivieren, benötigen Sie die Ziele anzeigen, Ziele aktivieren, Anzeigen von Profilen, und Segmente anzeigen Zugriffssteuerungsberechtigungen. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
- Export identities, benötigen Sie die Identitätsdiagramm anzeigen Zugriffsberechtigung.
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.
-
Wählen Sie eine oder mehrere Zielgruppen aus, die in SendGrid exportiert werden sollen.
-
Im Zuordnung Schritt nach Auswahl Neues Mapping hinzufügen angezeigt, wird Ihnen die Zuordnungsseite angezeigt, um die Quell-XDM-Felder den SendGrid-API-Zielfeldern zuzuordnen. Die folgenden Abbildungen zeigen, wie Identitäts-Namespaces zwischen Experience Platform und SendGrid zugeordnet werden. Stellen Sie sicher, dass Quellfeld Email sollte der Zielfeld external_id wie unten dargestellt.
-
Ordnen Sie die gewünschte Adobe Experience Platform -Attribute, die Sie an das SendGrid-Ziel exportieren möchten.
-
Wählen Sie nach Abschluss der Zuordnungen Nächste , um zum Überprüfungsbildschirm zu gelangen.
-
Auswählen Beenden , um das Setup abzuschließen.
Die umfassende Liste der unterstützten Attributzuordnungen, die für die Marketing-Kontakte senden > Kontakt-API hinzufügen oder aktualisieren unten.
homeAddress.street1
address_line_1
100 Zeichen
homeAddress.street2
address_line_2
100 Zeichen
_extconndev.alternate_emails
alternate_emails
- Maximal 5 Elemente
- Min.: 0 Elemente
homeAddress.city
city
60 Zeichen
homeAddress.country
country
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_provin_region
50 Zeichen
Validieren 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 zu 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-Marketinglisten > Listen-API erstellen wird verwendet, um innerhalb von SendGrid eindeutige Kontaktlisten zu erstellen, indem der Wert der list_name und dem Zeitstempel des Datenexports. Navigieren Sie zur SendGrid-Site und überprüfen Sie, ob die neue Kontaktliste erstellt wurde, die dem Namensmuster entspricht.
-
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.
-
Ü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 Marketing-Kontakte senden > Kontakt-API hinzufügen oder aktualisieren kann 30.000 Kontakte aufnehmen oder 6 MB an Daten, je nachdem, welcher Wert niedriger ist.