(API) Salesforce Marketing Cloud-Verbindung
Übersicht overview
(API) Salesforce Marketing Cloud (früher als ExactTarget bezeichnet) ist eine Digital Marketing-Suite, mit der Sie Journey erstellen und anpassen können, damit Besuchende und Kunden ihr Erlebnis personalisieren können.
Im Vergleich zu Salesforce Marketing Cloud Account Engagement, das stärker auf B2B-Marketing ausgerichtet ist, ist das (API) Salesforce Marketing Cloud-Ziel ideal für B2C-Anwendungsfälle mit kürzeren Entscheidungszyklen bei Transaktionen. Sie können größere Datensätze konsolidieren, die das Verhalten Ihrer Zielgruppe widerspiegeln, um Marketing-Kampagnen anzupassen und zu verbessern, indem Sie Kontakte priorisieren und segmentieren, insbesondere aus Datensätzen außerhalb von Salesforce. Hinweis: Experience Platform hat auch einen Anschluss für die Salesforce Marketing Cloud Account Engagement.
Dieses Adobe Experience Platform Ziel verwendet die Salesforce Marketing Cloud Kontakte aktualisieren-API, mit der Sie Kontakte hinzufügen und Kontaktdaten aktualisieren für Ihre Geschäftsanforderungen können, nachdem Sie sie in einem neuen Salesforce Marketing Cloud-Segment aktiviert haben.
Salesforce Marketing Cloud verwendet OAuth 2 mit Client-Anmeldeinformationen als Authentifizierungsmechanismus für die Kommunikation mit der 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 Marketing-Kampagnen use-case-send-emails
Die Verkaufsabteilung einer Wohnungsvermietungsplattform möchte eine Marketing-E-Mail an eine Zielgruppe senden. Das Marketing-Team der Plattform kann über Adobe Experience Platform neue Kontakte hinzufügen/bestehende (und ihre E-Mail-Adressen), Zielgruppen aus eigenen Offline-Daten erstellen und diese Zielgruppen an Salesforce Marketing Cloud senden, die dann zum Senden der E-Mail-Adresse der Marketing-Kampagne verwendet werden können.
Voraussetzungen prerequisites
Voraussetzungen in 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 Ihr Salesforce Marketing Cloud-Konto zu exportieren:
Sie benötigen ein Salesforce Marketing Cloud-Konto prerequisites-account
Ein Salesforce Marketing Cloud mit einem Abonnement für das Marketing Cloud Engagement Produkt ist erforderlich, um fortzufahren.
Wenden Sie sich an Salesforce Support, wenn Sie kein Salesforce Marketing Cloud haben oder Ihrem Konto das Marketing Cloud Engagement Produktabonnement fehlt.
Erstellen von Attributen in Salesforce Marketing Cloud prerequisites-attribute
Beim Aktivieren von Zielgruppen für das (API) Salesforce Marketing Cloud-Ziel müssen Sie für jede aktivierte Zielgruppe im Schritt Zielgruppen einen Wert in das Feld Zuordnungs-ID eingeben.
Salesforce erfordert diesen Wert, um Zielgruppen, die von Experience Platform eingehen, korrekt zu lesen und zu interpretieren und ihren Zielgruppenstatus in Salesforce Marketing Cloud zu aktualisieren. Weitere Informationen finden Sie in der Experience PlatformDokumentation zur Schemafeldgruppe „Details zur Zielgruppenzugehörigkeit wenn Sie Anleitung zu Zielgruppenstatus benötigen.
Für jede Zielgruppe, die Sie von Platform aus für Salesforce aktivieren, muss ein Attribut des Typs Text
mit der Email Demographics in Salesforce Marketing Cloud verknüpft sein. Verwenden Sie die Salesforce Marketing Cloud-Contact Builder, um Attribute zu erstellen. Weitere Informationen zum Erstellen von Attributen finden in der Salesforce Marketing Cloud- unter „Attribute erstellen“.
Die Attributfeldnamen werden für das (API) Salesforce Marketing Cloud Zielfeld während des Schritts Zuordnung verwendet. Sie können das Feldzeichen entsprechend Ihren Geschäftsanforderungen mit maximal 4.000 Zeichen definieren. Weitere Informationen zu Attributtypen finden Salesforce Marketing Cloud auf der Dokumentationsseite Datenerweiterungen .
Nachfolgend finden Sie ein Beispiel für den Bildschirm „Daten-Designer“ in Salesforce Marketing Cloud, dem Sie das Attribut hinzufügen:
Nachfolgend finden Sie eine Ansicht einer Salesforce Marketing Cloud Email Data Attributgruppe mit Attributen, die dem Zielgruppenstatus in der Email Demographics entsprechen:
Das (API) Salesforce Marketing Cloud-Ziel verwendet die Salesforce Marketing Cloud Search Attribute-Set Definitions REST API, um die in Salesforce Marketing Cloud definierten Datenerweiterungen und deren verknüpfte Attribute dynamisch abzurufen.
Diese werden im Auswahlfenster Zielfeld angezeigt, wenn Sie die Zuordnung im Workflow einrichten, um Zielgruppen für das Ziel zu aktivieren.
salesforce_mc_segment_1
. Fügen Sie beim Aktivieren einer Zielgruppe für dieses Ziel salesforce_mc_segment_1
als Zuordnungs-ID hinzu, um Zielgruppen vom Experience Platform in dieses Attribut einzufügen.Ein Beispiel für die Erstellung von Attributen in Salesforce Marketing Cloud finden Sie unten:
Screenshot der
- Fügen Sie beim Erstellen des Attributs keine Leerzeichen in den Feldnamen ein. Verwenden Sie stattdessen den Unterstrich
(_)
als Trennzeichen. - Um zwischen Attributen zu unterscheiden, die für Platform-Zielgruppen verwendet werden, und anderen Attributen innerhalb von Salesforce Marketing Cloud zu unterscheiden, können Sie ein erkennbares Präfix oder Suffix für die Attribute einfügen, die für das Adobe von Segmenten verwendet werden. Verwenden Sie beispielsweise anstelle von
test_segment
Adobe_test_segment
odertest_segment_Adobe
. - Wenn Sie bereits andere Attribute in Salesforce Marketing Cloud erstellt haben, können Sie denselben Namen wie das Platform-Segment verwenden, um die Zielgruppe in Salesforce Marketing Cloud einfach zu identifizieren.
Zuweisen von Benutzerrollen und Berechtigungen in Salesforce Marketing Cloud prerequisites-roles-permissions
Da Salesforce Marketing Cloud benutzerdefinierte Rollen je nach Anwendungsfall unterstützt, sollten Ihrem Benutzer die entsprechenden Rollen zugewiesen werden, um Ihre Attribute in Salesforce Marketing Cloud zu aktualisieren. Ein Beispiel für einem Benutzer zugewiesene Rollen finden Sie unten:
Je nachdem, welche Rollen Ihrem Salesforce Marketing Cloud Benutzer zugewiesen wurden, müssen Sie auch der Salesforce Marketing Cloud-Datenerweiterung Berechtigungen zuweisen, die mit den Feldern verknüpft sind, die Sie aktualisieren möchten.
Da dieses Ziel Zugriff auf die data extension
erfordert, müssen Sie es zulassen. Für die Email
data extension müssen Sie beispielsweise Folgendes zulassen:
Um die Zugriffsebene einzuschränken, können Sie auch den individuellen Zugriff mithilfe von granularen Berechtigungen überschreiben.
Ausführliche Anleitungen finden Sie auf den Seiten Marketing Cloud Roles und Marketing Cloud Roles and Permissions .
Sammeln von Salesforce Marketing Cloud-Anmeldedaten gather-credentials
Beachten Sie die folgenden Punkte, bevor Sie sich beim (API) Salesforce Marketing Cloud-Ziel authentifizieren.
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.,Sie müssen
mcq4jrssqdlyc4lph19nnqgzzs84
als Wert angeben.Leitplanken guardrails
-
Salesforce setzt bestimmte Sätze.
- Informationen zu möglichen BeschränkungenSalesforce Marketing Cloud auf die Sie stoßen könnten undSie Fehler bei der Ausführung verringern, finden Sie in der Dokumentation.
- Konsultieren Sie die Seite Salesforce Marketing Cloud Interaktionspreise, um die Vergleichstabelle für die vollständige Ausgabe herunterzuladen als PDF, die die von Ihrem Plan auferlegten Beschränkungen detailliert beschreibt.
- Auf der API-Übersicht finden Sie zusätzliche Beschränkungen.
- Siehe hier für eine Seite, die diese Details sortiert.
-
Die Anzahl der benutzerdefinierten Felder, die pro Objekt zulässig sind variiert je nach Salesforce Edition.
-
Weitere Anleitungen finden Sie in der Salesforce Dokumentation .
-
Wenn Sie das für (benutzerdefinierte Felder pro ) definierte Limit innerhalb Salesforce Marketing Cloud erreicht haben, müssen Sie Folgendes tun
- Entfernen Sie ältere Attribute, bevor Sie neue Attribute in Salesforce Marketing Cloud hinzufügen.
- Aktualisieren oder entfernen Sie alle aktivierten Zielgruppen in Platform-Zielen, die diese älteren Attributnamen als den für die Zuordnungs-ID) Schritt Zielgruppen-Planung bereitgestellten Wert verwenden.
-
Unterstützte Identitäten supported-identities
(API) Salesforce Marketing Cloud unterstützt die Aktivierung von Identitäten, die in der folgenden Tabelle beschrieben sind. Erhalten Sie weitere Informationen zu Identitäten.
Unterstützte Zielgruppen supported-audiences
In diesem Abschnitt wird beschrieben, welche Arten von Zielgruppen 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 Wert Zuordnungs-ID, der im Schritt Zielgruppen-Planung angegeben wurde.
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.
Suchen Sie Ziele > Katalog nach (API) Salesforce Marketing Cloud. Alternativ können Sie es unter der Kategorie E-Mail-Marketing finden.
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. Eine Anleitung dazu finden im Abschnitt Salesforce Marketing Cloud SammelnAnmeldeinformationen“.
Wenn Ihre Domain beispielsweise
ist
mcq4jrssqdlyc4lph19nnqgzzs84
.login.ExactTarget. com),Sie
mcq4jrssqdlyc4lph19nnqgzzs84
als Wert angeben müssen.Client ID
.Client Secret
.
Wenn die angegebenen Details gültig sind, zeigt die Benutzeroberfläche den Status Verbunden mit einem grünen Häkchen an. Sie können 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
-
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.
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-Datenmodells (XDM) in Ihrem Platform-Konto und den entsprechenden Entsprechungen vom Ziel zu erstellen.
Gehen Sie wie folgt vor, um Ihre XDM-Felder den (API) Salesforce Marketing Cloud-Zielfeldern korrekt zuzuordnen.
-
Obwohl Ihre Attributnamen Ihrem Salesforce Marketing Cloud-Konto entsprechen, sind die Zuordnungen für
contactKey
undpersonalEmail.address
obligatorisch. -
Für die Integration mit der Salesforce Marketing Cloud-API gilt ein Paginierungslimit für die Anzahl der Attribute, die Experience Platform von Salesforce abrufen kann. Das bedeutet, dass Zielfeldschema Schritt „Zuordnung“ maximal 2.000 Attribute aus Ihrem Salesforce-Konto anzeigen kann.
-
Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.
-
Wählen Sie im Fenster Quellfeld auswählen die Kategorie Attribute auswählen und wählen Sie das XDM-Attribut oder den Identity-Namespace auswählen und wählen Sie eine Identität aus.
-
Wählen Sie im Fenster Zielfeld auswählen die Kategorie Identity-Namespace auswählen und wählen Sie eine Identität oder Attribute auswählen aus und wählen Sie ein Attribut aus den angezeigten Datenerweiterungen nach Bedarf aus. Das (API) Salesforce Marketing Cloud-Ziel verwendet die Salesforce Marketing Cloud Search Attribute-Set Definitions REST API, um die in Salesforce Marketing Cloud definierten Datenerweiterungen und deren verknüpfte Attribute dynamisch abzurufen. Diese werden im Popup Zielfeld angezeigt, wenn Sie die Zuordnung im Workflow Zielgruppen aktivieren einrichten.
-
Wiederholen Sie diese Schritte, um die folgenden Zuordnungen zwischen Ihrem XDM-Profilschema und (API) Salesforce Marketing Cloud hinzuzufügen:
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 der Salesforce Marketing Cloud Email Addresses.Mandatory
beim Hinzufügen neuer Kontakte.xdm: person.name.firstName
Attribute: First Name
aus der gewünschten Salesforce Marketing Cloud.– -
Nachfolgend finden Sie ein Beispiel für die Verwendung dieser Zuordnungen:
-
Wenn Sie mit dem Eingeben der Zuordnungen für Ihre Zielverbindung fertig sind, klicken Sie auf Weiter.
Planen des Zielgruppenexports und Beispiel schedule-segment-export-example
Bei der Durchführung des Schritts Planen des-Exports) müssen Sie Platform-Zielgruppen manuell den Attributen in Salesforce Marketing Cloud zuordnen.
Wählen Sie dazu jedes Segment aus und geben Sie dann den Namen des Attributs aus Salesforce Marketing Cloud in das Feld (API) Salesforce Marketing CloudZuordnungs ID ein. Anleitungen und Best zum Erstellen von Attributen in Salesforce Marketing Cloud finden Sie im Abschnitt zum Erstellen von Attributen in Salesforce Marketing Cloud.
Wenn Ihr Salesforce Marketing Cloud beispielsweise salesforce_mc_segment_1
ist, geben Sie diesen Wert im (API) Salesforce Marketing Cloud (Zuordnungs ID), um Zielgruppen vom Experience Platform in dieses Attribut einzufügen.
Ein Beispielattribut aus Salesforce Marketing Cloud wird unten angezeigt:
Screenshot der
Nachfolgend finden Sie ein Beispiel, das den Speicherort der (API) Salesforce Marketing Cloud Zuordnungs ID“ angibt:
Wie gezeigt(API) Salesforce Marketing Cloud sollte Zuordnungs-ID genau mit dem in Salesforce Marketing Cloud FELDNAME angegebenen Wert übereinstimmen.
Wiederholen Sie diesen Abschnitt für jedes aktivierte Platform-Segment.
Ein typisches Beispiel auf der Grundlage des oben gezeigten Bildes könnte wie folgt aussehen.
salesforce_mc_segment_1
salesforce_mc_segment_1
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 zur Registerkarte 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 der Salesforce Marketing Cloud-Website an. Navigieren Sie dann zur Seite Audience Builder > Contact Builder > All contacts > Email und überprüfen Sie, ob die Profile aus der Audience hinzugefügt wurden.
-
Um festzustellen, ob Profile aktualisiert wurden, navigieren Sie zur Seite E-Mail und überprüfen Sie, ob die Attributwerte für das Profil aus der Audience aktualisiert wurden. Bei Erfolg können Sie sehen, dass jeder Zielgruppenstatus in Salesforce Marketing Cloud mit dem entsprechenden Zielgruppenstatus von Platform aktualisiert wurde, basierend auf dem Wert Zuordnungs-ID, der im Schritt Zielgruppen-Planung angegeben wurde.
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 Pushen von Ereignissen an das Salesforce-Marketing Cloud unknown-errors
-
Beim Überprüfen einer Datenflussausführung kann die folgende Fehlermeldung auftreten:
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 Zuordnungs-ID, die Sie im Aktivierungs-Workflow für das (API) Salesforce Marketing Cloud-Ziel angegeben haben, genau mit dem Namen des Attributs übereinstimmt, das Sie in Salesforce Marketing Cloud erstellt haben. Eine Anleitung finden im Abschnitt Salesforce Marketing CloudAttribut erstellen in“.
-
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, um Experience Platform-IP- zu den vertrauenswürdigen IP-Bereichen Ihrer Salesforce Marketing Cloud hinzuzufügen. Auf die Zulassungsliste setzen Weitere Anleitungen finden Sie in der Salesforce Marketing Cloud IP-Adressen für die AufnahmeMarketing Cloud".
Zusätzliche Ressourcen additional-resources
- Salesforce Marketing Cloud API
- Salesforce Marketing Cloud Dokumentation Erläuterung, wie Kontakte mit den angegebenen Informationen aktualisiert werden.
Ä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 | Dokumentation aktualisieren |
|
April 2023 | Dokumentation aktualisieren |
|
Februar 2023 | Dokumentation aktualisieren | Der Abschnitt Voraussetzungen in (API) Salesforce-Marketing Cloudwurde aktualisiert und enthält jetzt einen Referenzlink, der darauf verweist, dass Salesforce Marketing Cloud Engagement für die Verwendung dieses Ziels ein Pflichtabonnement ist. |
Februar 2023 | Funktionsaktualisierung | Es wurde ein Problem behoben, bei dem eine falsche Konfiguration im Ziel dazu führte, dass eine falsch formatierte JSON an Salesforce gesendet wurde. Dies führte dazu, dass einige Benutzende feststellten, dass bei der Aktivierung eine hohe Anzahl von Identitäten fehlgeschlagen war. (PLATIR-26299) |
Januar 2023 | Dokumentation aktualisieren |
|
Oktober 2022 | Erstmalige Veröffentlichung | Erstmalige Zielveröffentlichung und Dokumentation. |