(API) Salesforce Marketing Cloud-Verbindung
Übersicht overview
(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.
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 verwendet 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.
Anwendungsfälle use-cases
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.
Senden von E-Mails an Kontakte für Marketingkampagnen use-case-send-emails
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 Zielgruppen aus ihren eigenen Offline-Daten und senden Sie diese Zielgruppen an Salesforce Marketing Cloud, die dann zum Versand der E-Mail-Adresse der Marketing-Kampagne verwendet werden kann.
Voraussetzungen prerequisites
Voraussetzungen für Experience Platform prerequisites-in-experience-platform
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.
Voraussetzungen in (API) Salesforce Marketing Cloud prerequisites-destination
Beachten Sie die folgenden Voraussetzungen, um Daten von Platform in Ihre Salesforce Marketing Cloud Konto:
Sie benötigen ein Salesforce Marketing Cloud-Konto prerequisites-account
A Salesforce Marketing Cloud -Konto mit einem Abonnement für die 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 -Konto oder Ihr Konto fehlt die Marketing Cloud Engagement Produktabonnement.
Erstellen von Attributen in Salesforce Marketing Cloud prerequisites-attribute
Beim Aktivieren von Zielgruppen für die (API) Salesforce Marketing Cloud Ziel, müssen Sie einen Wert in die Zuordnungs-ID -Feld für jede aktivierte Zielgruppe im Zielgruppenplanung Schritt.
Salesforce benötigt diesen Wert, um Zielgruppen aus Experience Platform richtig zu lesen und zu interpretieren und ihren Zielgruppenstatus in Salesforce Marketing Cloud. Weitere Informationen finden Sie in der Experience Platform-Dokumentation für Feldergruppe Zielgruppenzugehörigkeitsdetails wenn Sie Anleitungen zum Zielgruppenstatus benötigen.
Für jede Zielgruppe, die Sie von Platform zu aktivieren Salesforce, müssen Sie über ein Attribut vom Typ Text
verknüpft mit Email Demographics Datenerweiterung in Salesforce Marketing Cloud. Verwenden Sie die Salesforce Marketing Cloud Contact Builder , um Attribute zu erstellen. Siehe Abschnitt Salesforce Marketing Cloud Dokumentation zu Attribute erstellen , wenn Sie Anleitungen zum Erstellen von Attributen benötigen.
Die Attributfeldnamen werden für die (API) Salesforce Marketing Cloud Zielfeld während der Zuordnung Schritt. Je nach Ihren Geschäftsanforderungen können Sie das Feldzeichen mit maximal 4000 Zeichen definieren. Siehe Salesforce Marketing Cloud Datenerweiterungstypen Dokumentationsseite für weitere Informationen zu Attributtypen.
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 einer Salesforce Marketing Cloud Email Data Attributgruppe mit Attributen, die dem Zielgruppenstatus innerhalb der Email Demographics Die Datenerweiterung ist unten dargestellt:
Die (API) Salesforce Marketing Cloud Das Ziel verwendet Salesforce Marketing Cloud Search Attribute-Set Definitions REST API dynamisch die Datenerweiterungen und die verknüpften Attribute abrufen, die in Salesforce Marketing Cloud.
Diese werden im Zielfeld Auswahlfenster bei der Einrichtung Mapping im Workflow zu Aktivieren von Zielgruppen für das Ziel.
salesforce_mc_segment_1
. Fügen Sie beim Aktivieren einer Zielgruppe für dieses Ziel hinzu salesforce_mc_segment_1
as Zuordnungs-ID , um Zielgruppen aus der Experience Platform in dieses Attribut zu füllen.Ein Beispiel für die Attributerstellung in Salesforce Marketing Cloud, wie unten gezeigt:
- Fügen Sie beim Erstellen des Attributs keine Leerzeichen in den Feldnamen ein. Verwenden Sie stattdessen den Unterstrich.
(_)
als Trennzeichen. - So unterscheiden Sie zwischen Attributen, die für Platform-Zielgruppen verwendet werden, und anderen Attributen in Salesforce Marketing Cloudkönnen Sie ein erkennbares Präfix oder Suffix für die Attribute einfügen, die für Adobe-Segmente verwendet werden. Beispiel: anstelle von
test_segment
, verwendenAdobe_test_segment
odertest_segment_Adobe
. - Wenn Sie bereits andere Attribute in erstellt haben Salesforce Marketing Cloudkönnen Sie denselben Namen wie das Platform-Segment verwenden, um die Zielgruppe in Salesforce Marketing Cloud.
Weisen Sie Benutzerrollen und Berechtigungen innerhalb von zu Salesforce Marketing Cloud prerequisites-roles-permissions
As Salesforce Marketing Cloud unterstützt benutzerdefinierte Rollen je nach Anwendungsfall. Ihrem Benutzer sollten die entsprechenden Rollen zugewiesen werden, um Ihre Attribute in Salesforce Marketing Cloud. 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 die Salesforce Marketing Cloud Datenerweiterung , die mit den zu aktualisierenden Feldern verknüpft ist.
Da dieses Ziel Zugriff auf die data extension
, müssen Sie sie zulassen. Beispiel für die Email
data extension müssen Sie wie unten gezeigt zulassen:
Um die Zugriffsebene zu beschränken, können Sie auch den individuellen Zugriff mithilfe granularer Berechtigungen überschreiben.
Siehe Abschnitt Marketing Cloud Roles und Marketing Cloud Roles and Permissions Seiten für ausführliche Anleitungen.
Sammeln von Salesforce Marketing Cloud-Anmeldeinformationen gather-credentials
Beachten Sie die folgenden Elemente, bevor Sie sich bei der (API) Salesforce Marketing Cloud Ziel.
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,Sie müssen
mcq4jrssqdlyc4lph19nnqgzzs84
als Wert.Leitplanken guardrails
-
Salesforce setzt bestimmte Grenzwerte.
- Siehe Abschnitt Salesforce Marketing Cloud Dokumentation , um alle möglichen Einschränkungen zu beheben, die bei der Ausführung auftreten könnten, und Fehler zu reduzieren.
- Siehe Abschnitt Salesforce Marketing Cloud Interaktionskosten Seite zu Vollständige Vergleichstabelle herunterladen als pdf , in dem die durch Ihren Plan festgelegten Grenzen beschrieben werden.
- Die API-Übersicht Seite enthält zusätzliche Einschränkungen.
- Siehe here für eine Seite, die diese Details sortiert.
-
Die Anzahl der Benutzerdefinierte Felder pro Objekt zulässig variiert je nach Salesforce Edition.
-
Siehe Abschnitt Salesforce Dokumentation für zusätzliche Leitlinien.
-
Wenn Sie die für Benutzerdefinierte Felder pro Objekt zulässig Innerhalb Salesforce Marketing Cloud Sie müssen
- Ältere Attribute vor dem Hinzufügen neuer Attribute in Salesforce Marketing Cloud.
- Aktualisieren oder entfernen Sie alle aktivierten Zielgruppen in Platform-Zielen, die diese älteren Attributnamen als Wert für Zuordnungs-ID während der Zielgruppenplanung Schritt.
-
Unterstützte Identitäten supported-identities
(API) Salesforce Marketing Cloud unterstützt die Aktivierung der in der folgenden Tabelle beschriebenen Identitäten. Erhalten Sie weitere Informationen zu Identitäten.
Unterstützte Zielgruppen supported-audiences
In diesem Abschnitt wird beschrieben, welche Zielgruppentypen Sie an dieses Ziel exportieren können.
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.
- Sie exportieren alle Mitglieder eines Segments zusammen mit den gewünschten Schemafeldern (z. B.: E-Mail-Adresse, Telefonnummer, Nachname), entsprechend Ihrer Feldzuordnung.
- Jeder Segmentstatus in Salesforce Marketing Cloud wird mit dem entsprechenden Zielgruppenstatus von Platform aktualisiert, basierend auf dem Zuordnungs-ID Wert, der während der Zielgruppenplanung Schritt.
Herstellen einer Verbindung mit dem Ziel 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.
Within Ziele > Katalog, suchen Sie nach (API) Salesforce Marketing Cloud. Alternativ können Sie sie unter der E-Mail-Marketing Kategorie.
Beim Ziel authentifizieren authenticate
Um sich beim Ziel zu authentifizieren, füllen Sie die erforderlichen Felder unten aus und wählen Sie Mit Ziel verbinden. Siehe Abschnitt Gather Salesforce Marketing Cloud Anmeldeinformationen für Hinweise.
Beispiel: Ihre Domäne
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,Sie müssen
mcq4jrssqdlyc4lph19nnqgzzs84
als Wert.Client ID
.Client Secret
.
Wenn die angegebenen Details gültig sind, zeigt die Benutzeroberfläche eine Verbunden Status mit einem grünen Häkchen angezeigt wird, können Sie dann mit dem nächsten Schritt fortfahren.
Ausfüllen der Zieldetails destination-details
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.
- Name: Ein Name, durch den Sie dieses Ziel in Zukunft erkennen können.
- Beschreibung: Eine 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
- 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.
Zuordnungsüberlegungen und Beispiel mapping-considerations-example
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-Datenmodell (XDM) in Ihrem Platform-Konto und den entsprechenden 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
undpersonalEmail.address
sind zwingend erforderlich. -
Die Integration mit der Salesforce Marketing Cloud Die API unterliegt einer Paginierungsgrenze dafür, wie viele Attribute Experience Platform aus Salesforce abrufen kann. Dies bedeutet, dass die Variable Zuordnung Schritt, kann das Zielfeldschema aus Ihrem Salesforce-Konto maximal 2000 Attribute anzeigen.
-
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 oder die Identitäts-Namespace auswählen und wählen Sie eine Identität.
-
Im Zielgruppenfeld auswählen Fenster, wählen Sie die Identitäts-Namespace auswählen und wählen Sie eine Identität oder Attribute auswählen und wählen Sie ein Attribut aus den Datenerweiterungen aus, die nach Bedarf angezeigt werden. Die (API) Salesforce Marketing Cloud Das Ziel verwendet Salesforce Marketing Cloud Search Attribute-Set Definitions REST API dynamisch die Datenerweiterungen und die verknüpften Attribute abrufen, die in Salesforce Marketing Cloud. Diese werden im Zielfeld Popup bei der Einrichtung der Mapping im Zielgruppen-Workflow aktivieren.
-
Wiederholen Sie diese Schritte, um die folgenden Zuordnungen zwischen Ihrem XDM-Profilschema und (API) Salesforce Marketing Cloud:
table 0-row-3 1-row-3 2-row-3 3-row-3 Quellfeld Zielfeld Obligatorisch IdentityMap: contactKey
Identity: salesforceContactKey
Mandatory
xdm: personalEmail.address
Attribute: Email Address
aus dem Salesforce Marketing Cloud Email Addresses Datenerweiterung.Mandatory
, wenn neue Kontakte hinzugefügt werden.xdm: person.name.firstName
Attribute: First Name
aus dem gewünschten Salesforce Marketing Cloud Datenerweiterung.– -
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.
Zielgruppenexport und Beispiel planen schedule-segment-export-example
Bei der Durchführung der Zielgruppenexport planen Schritt, müssen Sie Platform-Zielgruppen 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 Zielgruppen aus der 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.
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 audience 1 | salesforce_mc_segment_1
| salesforce_mc_segment_1
| | salesforce mc audience 2 | salesforce_mc_segment_2
| salesforce_mc_segment_2
|
Überprüfen des Datenexports exported-data
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 stellen Sie sicher, dass die Anzahl der Profile der im Segment erstellten Anzahl entspricht.
-
Melden Sie sich bei Salesforce Marketing Cloud Website. Navigieren Sie dann zum Audience Builder > Contact Builder > All contacts > Email und überprüfen Sie, ob die Profile aus der Audience 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 der Audience aktualisiert wurden. Bei erfolgreicher Ausführung können Sie sehen, dass jeder Zielgruppenstatus in Salesforce Marketing Cloud mit dem entsprechenden Zielgruppenstatus von Platform aktualisiert wurde, basierend auf dem Zuordnungs-ID Wert, der im Zielgruppenplanung Schritt.
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.
Fehler und Fehlerbehebung errors-and-troubleshooting
Unbekannte Fehler beim Senden von Ereignissen an das Salesforce-Marketing Cloud unknown-errors
-
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.
- Um diesen Fehler zu beheben, überprüfen Sie, ob die Variable Zuordnungs-ID die Sie im Aktivierungs-Workflow für das (API) Salesforce Marketing Cloud Das Ziel stimmt genau mit dem Namen des Attributs überein, das Sie in Salesforce Marketing Cloud. Siehe Abschnitt Attribut erstellen in Salesforce Marketing Cloud für Hinweise.
-
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...
- Wenden Sie sich zur Behebung dieses Fehlers an Ihren Salesforce Marketing Cloud Kontoadministrator zum Hinzufügen Experience Platform-IP-Adressen auf Salesforce Marketing Cloud Vertrauenswürdige IP-Bereiche der Konten. Siehe Abschnitt Salesforce Marketing Cloud IP-Adressen für die Einbindung in Zulassungslisten in Marketing Cloud Dokumentation, wenn Sie zusätzliche Anleitungen benötigen.
Zusätzliche Ressourcen additional-resources
- Salesforce Marketing Cloud API
- Salesforce Marketing Cloud Dokumentation Erläuterung der Aktualisierung von Kontakten mit den angegebenen Informationen.
Änderungsprotokoll changelog
In diesem Abschnitt werden aktualisierte Funktionen und wesentliche Dokumentationsänderungen für diesen Ziel-Connector erfasst.
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto | ||
---|---|---|
Veröffentlichungsmonat | Art der Aktualisierung | Beschreibung |
Oktober 2023 | Aktualisierung der Dokumentation |
|
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. |