(API) Salesforce Marketing Cloud (früher bekannt als ExactTarget) ist eine Digital Marketing Suite, mit der Sie Journey für Besucher und Kunden erstellen und anpassen können, um deren Erlebnis zu personalisieren.
Beachten Sie den Unterschied zwischen dieser Verbindung und der anderen Salesforce Marketing Cloud connection , die im Abschnitt E-Mail-Marketing-Katalog vorhanden ist. Mit der anderen Salesforce-Marketing Cloud-Verbindung können Sie Dateien an einen bestimmten Speicherort exportieren, während es sich hierbei um eine API-basierte Streaming-Verbindung handelt.
Im Vergleich zu Salesforce Marketing Cloud Account Engagement die stärker auf B2B Marketing, (API) Salesforce Marketing Cloud Das Ziel ist ideal für B2C Anwendungsfälle mit kürzeren Transaktionsentscheidungen-Zyklen. Sie können größere Datensätze, die das Verhalten Ihrer Zielgruppe repräsentieren, zusammenfassen, um Marketing-Kampagnen anzupassen und zu verbessern, indem Sie Kontakte priorisieren und segmentieren, insbesondere aus Datensätzen außerhalb von Salesforce. Beachten Sie, dass Experience Platform auch eine Verbindung für die Salesforce Marketing Cloud Account Engagement.
Diese Adobe Experience Platform Ziel nutzt die Salesforce Marketing Cloud Kontakte aktualisieren API, mit der Sie Hinzufügen von Kontakten und Aktualisieren von Kontaktdaten für Ihre Geschäftsanforderungen, nachdem Sie sie in einer neuen Salesforce Marketing Cloud Segment.
Salesforce Marketing Cloud verwendet OAuth 2 mit Client-Anmeldeinformationen als Authentifizierungsmechanismus für die Kommunikation mit dem Salesforce Marketing Cloud API. Anweisungen zur Authentifizierung bei Ihrer Salesforce Marketing Cloud-Instanz sehen Sie weiter unten im Abschnitt Authentifizieren bei Ziel.
Damit Sie besser verstehen können, wie und wann Sie das (API) Salesforce Marketing Cloud-Ziel verwenden sollten, finden Sie hier ein Anwendungsbeispiel, das für Kundinnen und Kunden von Adobe Experience Platform mit diesem Ziel geeignet ist.
Die Vertriebsabteilung einer Heimmiet-Plattform möchte eine Marketing-E-Mail an eine zielgerichtete Kundenzielgruppe senden. Das Marketing-Team der Plattform kann neue Kontakte hinzufügen/vorhandene Kontakte aktualisieren (und ihre E-Mail-Adressen) Erstellen Sie über Adobe Experience Platform Segmente aus eigenen Offline-Daten und senden Sie diese Segmente an Salesforce Marketing Cloud, die dann zum Versand der E-Mail-Adresse der Marketing-Kampagne verwendet werden kann.
Vor der Aktivierung der Daten für das (API) Salesforce Marketing Cloud-Ziel müssen Sie über ein Schema, einen Datensatz und Segmente verfügen, die in Experience Platform erstellt wurden.
Beachten Sie die folgenden Voraussetzungen, um Daten von Platform in Ihre Salesforce Marketing Cloud Konto:
A Salesforce Marketing Cloud -Konto mit einem Abonnement für Marketing Cloud Engagement Das Produkt ist für den Fortgang des Verfahrens obligatorisch.
Wenden Sie sich an Salesforce Support wenn Sie keine Salesforce Marketing Cloud oder Ihr Konto fehlt, Marketing Cloud Engagement Produktabonnement.
Beim Aktivieren von Segmenten für (API) Salesforce Marketing Cloud Ziel, müssen Sie einen Wert in die Zuordnungs-ID -Feld für jedes aktivierte Segment im Segmentplan Schritt.
Salesforce erfordert, dass dieser Wert Segmente aus Experience Platform korrekt liest und interpretiert und ihr Segmentstatus in Salesforce Marketing Cloud. Weitere Informationen finden Sie in der Dokumentation zur Experience Platform für Feldergruppe Segmentzugehörigkeitsdetails , wenn Sie Anleitungen zum Segmentstatus benötigen.
Für jedes Segment, das Sie von Platform in aktivieren Salesforce Marketing Cloud, müssen Sie ein Attribut des Typs Text
Innerhalb Salesforce. Verwenden Sie die Salesforce Marketing Cloud Contact Builder , um Attribute zu erstellen. Die Attributfeldnamen werden für die (API) Salesforce Marketing Cloud Zielfeld und sollte unter dem Email Demographics system attribute-set
. Je nach Ihren Geschäftsanforderungen können Sie das Feldzeichen mit maximal 4000 Zeichen definieren. Siehe Salesforce Marketing Cloud Datentypen für Datenerweiterungen Dokumentationsseite für weitere Informationen zu Attributtypen.
Siehe Abschnitt Salesforce Marketing Cloud Dokumentation zu Attribute erstellen , wenn Sie Anleitungen zum Erstellen von Attributen benötigen.
Ein Beispiel für den Data Designer-Bildschirm in Salesforce Marketing Cloud, zu dem Sie das Attribut hinzufügen werden, sehen Sie wie folgt:
Ansicht der Salesforce Marketing Cloud Email Demographics attribute-set ist unten dargestellt:
Die (API) Salesforce Marketing Cloud Das Ziel verwendet Salesforce Marketing Cloud Search Attribute-Set Definitions REST API dynamisch die Attribute und ihre Attribute-Sets abrufen, die in Salesforce Marketing Cloud.
Diese werden im Zielfeld Auswahlfenster bei der Einrichtung Mapping im Workflow zu Aktivieren von Segmenten für das Ziel. Beachten Sie, dass nur Zuordnungen für die Attribute erstellt werden, die innerhalb der Variablen Salesforce Marketing Cloud Email Demographics
-Attributsätze unterstützt.
Within Salesforce Marketing Cloudmüssen Sie Attribute mit einer FELDNAME genau mit dem Wert übereinstimmt, der in Zuordnungs-ID für jedes aktivierte Platform-Segment. Der folgende Screenshot zeigt beispielsweise ein Attribut mit dem Namen salesforce_mc_segment_1
. Fügen Sie bei der Aktivierung eines Segments für dieses Ziel hinzu salesforce_mc_segment_1
as Zuordnungs-ID , um Segmentzielgruppen aus Experience Platform in dieses Attribut zu füllen.
Ein Beispiel für die Attributerstellung in Salesforce Marketing Cloud, wie unten gezeigt:
(_)
als Trennzeichen.test_segment
, verwenden Adobe_test_segment
oder test_segment_Adobe
.As Salesforce Marketing Cloud unterstützt benutzerdefinierte Rollen je nach Anwendungsfall. Ihrem Benutzer sollten die entsprechenden Rollen zugewiesen werden, um Ihre Attribute in Ihren Salesforce Marketing Cloud Attributsätzen. Nachfolgend finden Sie ein Beispiel für Benutzerrollen:
Welche Rollen Ihre Salesforce Marketing Cloud Benutzer zugewiesen wurde, müssen Sie außerdem Berechtigungen für Salesforce Marketing Cloud -Attributsätzen, die die zu aktualisierenden Felder enthalten.
Da dieses Ziel Zugriff auf die Email Demographics system attribute-set
, müssen Sie Email
wie unten gezeigt:
Um die Zugriffsebene zu beschränken, können Sie auch einzelne Zugriffe durch Verwendung granularer Berechtigungen überschreiben.
Siehe Abschnitt Marketing Cloud Roles und Marketing Cloud Roles and Permissions Seiten für ausführliche Anleitungen.
Beachten Sie die folgenden Elemente, bevor Sie sich bei der (API) Salesforce Marketing Cloud Ziel.
Anmeldedaten | Beschreibung | Beispiel |
---|---|---|
Subdomain | Siehe Salesforce Marketing Cloud domain prefix , um zu erfahren, wie Sie diesen Wert aus dem Salesforce Marketing Cloud -Schnittstelle. | Wenn Salesforce Marketing Cloud Domäne istmcq4jrssqdlyc4lph19nnqgzzs84 .login.executeTarget.com, Sie müssen mcq4jrssqdlyc4lph19nnqgzzs84 als Wert. |
Client-ID | Siehe Salesforce Marketing Cloud Dokumentation , um zu erfahren, wie Sie diesen Wert aus dem Salesforce Marketing Cloud -Schnittstelle. | r23kxxxxxxxx0z05xxxxxx |
Client-Geheimnis | Siehe Salesforce Marketing Cloud Dokumentation , um zu erfahren, wie Sie diesen Wert aus dem Salesforce Marketing Cloud -Schnittstelle. | ipxxxxxxxxxxT4xxxxxxxxxx |
(API) Salesforce Marketing Cloud unterstützt die Aktualisierung von Identitäten, die in der folgenden Tabelle beschrieben werden. Erhalten Sie weitere Informationen zu Identitäten.
Ziel-Identität | Beschreibung | Zu beachten |
---|---|---|
contactKey | Salesforce Marketing Cloud Kontaktschlüssel. Siehe Abschnitt Salesforce Marketing Cloud Dokumentation wenn Sie zusätzliche Anleitungen benötigen. | Obligatorisch |
Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.
Element | Typ | Anmerkungen |
---|---|---|
Exporttyp | Profilbasiert |
|
Exporthäufigkeit | Streaming | Streaming-Ziele sind „immer verfügbare“ 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. Lesen Sie mehr über Streaming-Ziele. |
Um eine Verbindung zum Ziel herzustellen, benötigen Sie die Zugriffsberechtigung 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.
Within Ziele > Katalog, suchen Sie nach (API) Salesforce Marketing Cloud. Alternativ können Sie sie unter der E-Mail-Marketing Kategorie.
Um sich beim Ziel zu authentifizieren, füllen Sie die erforderlichen Felder unten aus und wählen Sie Mit Ziel verbinden. Eine Anleitung dazu finden Sie im Abschnitt Salesforce Marketing Cloud Sammeln von -Anmeldeinformationen.
(API) Salesforce Marketing Cloud Ziel | Salesforce Marketing Cloud |
---|---|
Subdomain | Ihre Salesforce Marketing Cloud Domänen-Präfix. Beispiel: Ihre Domäne mcq4jrssqdlyc4lph19nnqgzzs84 .login.executeTarget.com, Sie müssen mcq4jrssqdlyc4lph19nnqgzzs84 als Wert. |
Client-ID | Ihre Salesforce Marketing Cloud Client ID . |
Client-Geheimnis | Ihre Salesforce Marketing Cloud Client Secret . |
Wenn die angegebenen Details gültig sind, zeigt die Benutzeroberfläche eine Verbunden Status mit einem grünen Häkchen anzeigen, können Sie mit dem nächsten Schritt fortfahren.
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.
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 mit dem Eingeben der Details für Ihre Zielverbindung fertig sind, klicken Sie auf Weiter.
Um Daten zu aktivieren, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele verwalten, Ziele aktivieren, Profile anzeigen und Segmente anzeigen. Lesen Sie die Zugriffssteuerung – Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.
Anweisungen zum Aktivieren von Zielgruppensegmenten für dieses Ziel finden Sie unter Aktivieren von Profilen und Segmenten für Streaming-Segmentexportziele.
Um Ihre Zielgruppendaten ordnungsgemäß von Adobe Experience Platform an das (API) Salesforce Marketing Cloud-Ziel zu senden, müssen Sie den Schritt zur Feldzuordnung durchlaufen. Die Zuordnung besteht darin, eine Verknüpfung zwischen den Schemafeldern Ihres Experience-Datenmodells (XDM) in Ihrem Platform-Konto und den jeweiligen Entsprechungen vom Ziel zu erstellen.
So ordnen Sie Ihre XDM-Felder korrekt der (API) Salesforce Marketing Cloud Gehen Sie wie folgt vor:
Auch wenn Ihre Attributnamen gemäß Ihrer Salesforce Marketing Cloud -Konto, die Zuordnungen für beide contactKey
und personalEmail.address
sind zwingend erforderlich. Beim Zuordnen von Attributen werden nur Attribute aus der Experience Platform Email Demographics
sollte in den Zielfeldern verwendet werden.
Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.
Im Quellfeld auswählen Fenster, wählen Sie die Attribute auswählen und wählen Sie das XDM-Attribut aus oder wählen Sie die Identitäts-Namespace auswählen und wählen Sie eine Identität aus.
Im Zielgruppenfeld auswählen Fenster, wählen Sie die Identitäts-Namespace auswählen und wählen Sie eine Identität oder Benutzerdefinierte Attribute auswählen und wählen Sie ein Attribut aus der Email Demographics
-Attribute nach Bedarf angezeigt werden. Die (API) Salesforce Marketing Cloud Das Ziel verwendet Salesforce Marketing Cloud Search Attribute-Set Definitions REST API dynamisch die Attribute und ihre in Salesforce Marketing Cloud. Diese werden im Zielfeld Popup bei der Einrichtung der Mapping im Aktivieren von Segmenten für den Workflow. Beachten Sie, dass nur Zuordnungen für die Attribute erstellt werden, die innerhalb der Variablen Salesforce Marketing Cloud Email Demographics
-Attributsätze unterstützt.
Wiederholen Sie diese Schritte, um die folgenden Zuordnungen zwischen Ihrem XDM-Profilschema und (API) Salesforce Marketing Cloud: |Quellfeld|Zielfeld| Erforderlich| |—|—|—| |IdentityMap: contactKey
|Identity: salesforceContactKey
| Mandatory
|\
|xdm: person.name.firstName
|Attribute: Email Demographics.First Name
| - |
|xdm: personalEmail.address
|Attribute: Email Addresses.Email Address
| - |
Nachfolgend finden Sie ein Beispiel für die Verwendung dieser Zuordnungen:
Wenn Sie die Zuordnungen für Ihre Zielverbindung bereitgestellt haben, wählen Sie Nächste.
Bei der Durchführung der Segmentexport planen Schritt: Sie müssen Platform-Segmente manuell dem attributes in Salesforce Marketing Cloud.
Wählen Sie dazu jedes Segment aus und geben Sie dann den Namen des Attributs aus Salesforce Marketing Cloud im (API) Salesforce Marketing Cloud Zuordnungs-ID -Feld. Siehe Abschnitt Attribut erstellen in Salesforce Marketing Cloud Abschnitt mit Anleitungen und Best Practices zum Erstellen von Attributen in Salesforce Marketing Cloud.
Wenn beispielsweise Ihre Salesforce Marketing Cloud Attribut ist salesforce_mc_segment_1
, geben Sie diesen Wert in der (API) Salesforce Marketing Cloud Zuordnungs-ID , um Segmentzielgruppen aus Experience Platform in dieses Attribut zu füllen.
Ein Beispielattribut aus Salesforce Marketing Cloud ist unten dargestellt:
Ein Beispiel, das die Position der (API) Salesforce Marketing Cloud Zuordnungs-ID ist unten dargestellt:
Wie gezeigt, (API) Salesforce Marketing Cloud Zuordnungs-ID sollte genau mit dem Wert übereinstimmen, der in Salesforce Marketing Cloud FELDNAME.
Wiederholen Sie diesen Abschnitt für jedes aktivierte Platform-Segment.
Je nach Anwendungsfall können alle aktivierten Segmente demselben Salesforce Marketing Cloud FELDNAME oder anderen FELDNAME in (API) Salesforce Marketing Cloud. Ein typisches Beispiel, das auf dem oben gezeigten Bild basiert, könnte sein.
| (API) Salesforce Marketing Cloud Segmentname | Salesforce Marketing Cloud FELDNAME | (API) Salesforce Marketing Cloud Zuordnungs-ID | | — | — | — | | Salesforce mc Segment 1 | salesforce_mc_segment_1
| salesforce_mc_segment_1
| | Salesforce mc Segment 2 | salesforce_mc_segment_2
| salesforce_mc_segment_2
|
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 Segmentnamen aus.
Überwachen Sie die Segmentzusammenfassung und stellen Sie sicher, dass die Anzahl der Profile der im Segment erstellten Anzahl entspricht.
Melden Sie sich bei der Salesforce Marketing Cloud Website. Navigieren Sie dann zum Audience Builder > Contact Builder > All contacts > Email und überprüfen Sie, ob die Profile aus dem Segment hinzugefügt wurden.
Um zu überprüfen, ob Profile aktualisiert wurden, navigieren Sie zum Email und überprüfen Sie, ob die Attributwerte für das Profil aus dem Segment aktualisiert wurden. Bei Erfolg können Sie sehen, dass jeder Segmentstatus in Salesforce Marketing Cloud mit dem entsprechenden Segmentstatus von Platform aktualisiert wurde, basierend auf dem Zuordnungs-ID Wert, der im Segmentplanung Schritt.
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.
Beim Überprüfen eines Datenfluss-Ablaufs wird möglicherweise die folgende Fehlermeldung angezeigt: Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
Beim Aktivieren eines Segments erhalten Sie möglicherweise eine Fehlermeldung: The client's IP address is unauthorized for this account. Allowlist the client's IP address...
In diesem Abschnitt werden die Funktionen und wesentlichen Aktualisierungen der Dokumentation an diesem Ziel-Connector erfasst.
Veröffentlichungsmonat | Aktualisierungstyp | Beschreibung |
---|---|---|
April 2023 | Aktualisierung der Dokumentation |
|
Februar 2023 | Aktualisierung der Dokumentation | Wir haben die Voraussetzungen im Salesforce-Marketing Cloud (API) -Abschnitt, um einen Verweis-Link einzuschließen, der Folgendes aufruft: Salesforce Marketing Cloud Engagement ist ein obligatorisches Abonnement zur Verwendung dieses Ziels. |
Februar 2023 | Funktionsaktualisierung | Es wurde ein Problem behoben, bei dem eine falsche Konfiguration im Ziel dazu führte, dass eine fehlerhafte JSON an Salesforce gesendet wurde. Dies führte dazu, dass bei einigen Benutzern bei der Aktivierung eine hohe Anzahl von Identitäten fehlschlug. (PLATIR-26299) |
Januar 2023 | Aktualisierung der Dokumentation |
|
Oktober 2022 | Erstmalige Veröffentlichung | Erste Zielversion und Veröffentlichung der Dokumentation. |