SendGrid ist eine beliebte Kundenkommunikationsplattform für Transaktions- und Marketing-E-Mails.
Diese Adobe Experience Platform Ziel nutzt die SendGrid Marketing Contacts API, mit dem Sie Ihre Erstanbieter-E-Mail-Profile exportieren und in einem neuen SendGrid-Segment 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.
Die folgenden Elemente sind erforderlich, bevor Sie mit der Konfiguration des Ziels beginnen.
Bevor Sie Daten für das SendGrid-Ziel aktivieren, müssen Sie über eine schema, Datensatzund Segmente erstellt in Experience Platform. Weitere Informationen finden Sie unter 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 aus Segmenten in Experience Platform entfernt werden.
SendGrid unterstützt die Aktivierung von Identitäten, die in der folgenden Tabelle beschrieben sind. Weitere Informationen identities.
Zielgruppenidentität | Beschreibung | Zu beachten |
---|---|---|
E-Mail Adresse | Beachten Sie, dass sowohl Nur-Text- als auch SHA256-Hash-E-Mail-Adressen von Adobe Experience Platform. Wenn das Quellfeld der Experience Platform ungehashte Attribute enthält, überprüfen Sie die Umwandlung anwenden -Option, um Platform die Daten bei Aktivierung automatisch hash. Beachten Sie Folgendes: SendGrid unterstützt keine Hash-E-Mail-Adressen, daher werden nur Textdaten ohne Umwandlung an das Ziel gesendet. |
Informationen zum Zielexporttyp und zur Häufigkeit finden Sie in der unten stehenden Tabelle.
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 Profilattribute im Zielaktivierungs-Workflow. |
Exporthäufigkeit | Streaming | Streaming-Ziele sind "immer auf"-API-basierte Verbindungen. Sobald ein Profil in Experience Platform auf der Grundlage einer Segmentbewertung aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Mehr dazu Streaming-Ziele. |
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 dies mithilfe dieses Ziels lösen.
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.
Um eine Verbindung zum Ziel herzustellen, benötigen Sie die Ziele verwalten Zugriffsberechtigung. 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 Abschnitt 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.
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.
Beim Einrichten dieses Ziels müssen Sie die folgenden Informationen angeben:
Sie können Warnhinweise aktivieren, um Benachrichtigungen über den Status des Datenflusses an Ihr 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 Warnungen finden Sie im Handbuch zu Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.
Wenn Sie alle Details für Ihre Zielverbindung angegeben haben, wählen Sie Nächste.
Um Daten zu aktivieren, benötigen Sie die Ziele verwalten, Ziele aktivieren, Profile anzeigen und Segmente anzeigen Zugriffssteuerungsberechtigungen. Lesen Sie die Zugriffskontrolle - Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.
Lesen Aktivieren von Profilen und Segmenten für Streaming-Segmentexportziele für Anweisungen zum Aktivieren von Zielgruppensegmenten für dieses Ziel.
Weitere Informationen zu diesem Ziel finden Sie in den folgenden Bildern.
Wählen Sie ein oder mehrere Segmente 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.
Nachdem Sie die Zuordnungen abgeschlossen haben, wählen Sie 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.
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: alternate_emails |
Zeichenfolgen-Array | Zusätzliche E-Mails, die mit dem Kontakt verknüpft sind. |
|
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: |
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_provin_region |
Zeichenfolge | Das Bundesland, die Provinz oder die Region des Kontakts. | Max. Länge: 50 Zeichen |
Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:
Auswählen Ziele > Durchsuchen um zur Liste der Ziele zu navigieren.
Wählen Sie das Ziel aus und überprüfen Sie, ob der Status enabled.
Wechseln Sie zu Activation data und wählen Sie einen Segmentnamen aus.
Überwachen Sie die Segmentzusammenfassung 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.
Alle Adobe Experience Platform-Ziele sind bei der Verarbeitung Ihrer Daten mit Datennutzungsrichtlinien konform. Detaillierte Informationen zur Adobe Experience Platform erzwingt Data Governance, siehe Data Governance - Übersicht.
Dieses SendGrid-Ziel nutzt die folgenden APIs: