(API) Salesforce Marketing Cloud-Verbindung
Übersicht overview
(API) Salesforce Marketing Cloud (ehemals 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 , das stärker auf das Marketing von B2B ausgerichtet ist, ist das Ziel (API) Salesforce Marketing Cloud ideal für Anwendungsfälle mit B2C und kürzeren Entscheidungszyklen für Transaktionen. 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 den Salesforce Marketing Cloud Account Engagement hat.
Dieses Adobe Experience Platform Ziel verwendet die Salesforce Marketing Cloud Kontaktaktualisierung -API, mit der Sie Kontakte hinzufügen und Kontaktdaten aktualisieren können, nachdem Sie diese 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 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 (und ihre E-Mail-Adressen) über Adobe Experience Platform aktualisieren, Zielgruppen aus eigenen Offline-Daten erstellen und diese Zielgruppen an Salesforce Marketing Cloud senden, die dann zum Senden der E-Mail-Adresse für Marketingkampagnen verwendet werden können.
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 Ihr Salesforce Marketing Cloud -Konto zu exportieren:
Sie benötigen ein Salesforce Marketing Cloud-Konto prerequisites-account
Um fortzufahren, ist ein Salesforce Marketing Cloud -Konto mit einem Abonnement für das Produkt Marketing Cloud Engagement erforderlich.
Wenden Sie sich an den Salesforce Support , wenn Sie kein Salesforce Marketing Cloud -Konto haben oder Ihr Konto das Marketing Cloud Engagement -Produktabonnement fehlt.
Erstellen von Attributen innerhalb von Salesforce Marketing Cloud prerequisites-attribute
Beim Aktivieren von Zielgruppen für das Ziel (API) Salesforce Marketing Cloud müssen Sie im Schritt Zielgruppenplan im Feld Zuordnungs-ID einen Wert für jede aktivierte Zielgruppe eingeben.
Salesforce erfordert diesen Wert, um von Experience Platform kommende Zielgruppen korrekt zu lesen und zu interpretieren und ihren Zielgruppenstatus innerhalb von Salesforce Marketing Cloud zu aktualisieren. Informationen zum Zielgruppenstatus finden Sie in der Experience Platform-Dokumentation für die Schemafeldergruppe Zielgruppenzugehörigkeitsdetails .
Für jede Zielgruppe, die Sie von Platform bis Salesforce aktivieren, muss das Attribut des Typs Text
mit der Datenerweiterung Email Demographics innerhalb von Salesforce Marketing Cloud verknüpft sein. Verwenden Sie die Salesforce Marketing Cloud Contact Builder, um Attribute zu erstellen. Informationen zum Erstellen von Attributen finden Sie in der Dokumentation zu Salesforce Marketing Cloud in Attribut erstellen .
Die Attributfeldnamen werden für das Zielfeld (API) Salesforce Marketing Cloud während des Schritts Zuordnung verwendet. Je nach Ihren Geschäftsanforderungen können Sie das Feldzeichen mit maximal 4000 Zeichen definieren. Weitere Informationen zu Attributtypen finden Sie auf der Dokumentationsseite Salesforce Marketing Cloud Datenerweiterungsdatentypen .
Nachfolgend finden Sie ein Beispiel für den Bildschirm "Data Designer"in Salesforce Marketing Cloud, dem Sie das Attribut hinzufügen werden:
Eine Ansicht einer Attributgruppe mit dem Wert Salesforce Marketing Cloud Email Data mit Attributen, die dem Zielgruppenstatus innerhalb der Datenerweiterung Email Demographics entsprechen, ist unten dargestellt:
Das Ziel (API) Salesforce Marketing Cloud verwendet die Salesforce Marketing Cloud Search Attribute-Set Definitions REST API, um die Datenerweiterungen und die zugehörigen verknüpften Attribute dynamisch abzurufen, die in Salesforce Marketing Cloud definiert sind.
Diese werden im Auswahlfenster Zielfeld angezeigt, wenn Sie die Zuordnung im Workflow zu Zielgruppen aktivieren eingerichtet haben.
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 aus Experience Platform in dieses Attribut zu füllen.Nachfolgend finden Sie ein Beispiel für die Attributerstellung in Salesforce Marketing Cloud:
- Fügen Sie beim Erstellen des Attributs keine Leerzeichen in den Feldnamen ein. Verwenden Sie stattdessen den Unterstrich
(_)
als Trennzeichen. - Um zwischen Attributen, 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 Adobe-Segmente 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 innerhalb von Salesforce Marketing Cloud prerequisites-roles-permissions
Da Salesforce Marketing Cloud benutzerdefinierte Rollen je nach Anwendungsfall unterstützt, sollte Ihrem Benutzer die entsprechenden Rollen zugewiesen werden, um Ihre Attribute in Salesforce Marketing Cloud zu aktualisieren. Nachfolgend finden Sie ein Beispiel für Benutzerrollen:
Je nachdem, welchen Rollen Ihr Salesforce Marketing Cloud -Benutzer zugewiesen wurde, müssen Sie auch der Salesforce Marketing Cloud -Datenerweiterung Berechtigungen zuweisen, die mit den Feldern verknüpft sind, die Sie aktualisieren möchten.
Da für dieses Ziel der Zugriff auf die data extension
erforderlich ist, müssen Sie sie zulassen. Beispielsweise müssen Sie für die Email
data extension Folgendes zulassen:
Um die Zugriffsebene zu beschränken, können Sie auch den individuellen Zugriff mithilfe granularer Berechtigungen überschreiben.
Detaillierte 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 Elemente, bevor Sie sich beim (API) Salesforce Marketing Cloud-Ziel authentifizieren.
ist
mcq4jrssqdlyc4lph19nnqgzzs84
.login.executeTarget.com,Sie müssen
mcq4jrssqdlyc4lph19nnqgzzs84
als Wert angeben.Leitplanken guardrails
-
Salesforce legt bestimmte Ratenbeschränkungen fest.
- In der Dokumentation Salesforce Marketing Cloud Dokumentation finden Sie Informationen zu möglichen Beschränkungen, die bei der Ausführung auftreten könnten, sowie zur Reduzierung von Fehlern bei der Ausführung.
- Auf der Seite Salesforce Marketing Cloud Interaktionspreise finden Sie die Informationen unter Vergleichstabelle für die Vollversion herunterladen als pdf, in dem die durch Ihren Plan festgelegten Beschränkungen beschrieben werden.
- Auf der Seite API-Übersicht sind zusätzliche Einschränkungen aufgeführt.
- Eine Seite mit diesen Details finden Sie unter hier .
-
Die Anzahl der pro Objekt zulässigen benutzerdefinierten Felder variiert je nach Salesforce Edition.
-
Weitere Anleitungen finden Sie in der Dokumentation zu Salesforce Dokumentation .
-
Wenn Sie die für benutzerdefinierte Felder, die pro Objekt innerhalb von Salesforce Marketing Cloud zulässig sind, definierte Grenze erreicht haben, müssen Sie
- Entfernen Sie ältere Attribute, bevor Sie neue Attribute in Salesforce Marketing Cloud hinzufügen.
- Aktualisieren oder entfernen Sie aktivierte Zielgruppen in Platform-Zielen, die diese älteren Attributnamen als Wert verwenden, der während des Schritts Zielgruppenplanung für die Zuordnungs-ID angegeben wurde.
-
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 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 Wert Zuordnungs-ID , der während des Schritts Zielgruppenplanung 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 in Ziele > Katalog nach (API) Salesforce Marketing Cloud. Alternativ können Sie ihn 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 aus. Eine Anleitung finden Sie im Abschnitt Anmeldedaten sammeln Salesforce Marketing Cloud 2} .
Wenn Ihre Domäne beispielsweise
ist
mcq4jrssqdlyc4lph19nnqgzzs84
.login.executeTarget.com,Sie müssen als Wert
mcq4jrssqdlyc4lph19nnqgzzs84
angeben.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
-
Um Daten zu aktivieren, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen .Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
-
Um identities zu exportieren, benötigen Sie die Zugriffssteuerungsberechtigung Identitätsdiagramm anzeigen 🔗.
{width="100" modal="regular"}
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.
Gehen Sie wie folgt vor, um Ihre XDM-Felder korrekt den (API) Salesforce Marketing Cloud -Zielfeldern zuzuordnen.
-
Obwohl Ihre Attributnamen gemäß Ihrem Salesforce Marketing Cloud -Konto angegeben werden, sind die Zuordnungen für sowohl
contactKey
als auchpersonalEmail.address
obligatorisch. -
Die Integration mit der Salesforce Marketing Cloud -API unterliegt einer Paginierungsbegrenzung dahingehend, wie viele Attribute Experience Platform aus Salesforce abrufen kann. Das bedeutet, dass im Schritt Zuordnung das Zielfeldschema maximal 2000 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 aus, wählen Sie das XDM-Attribut aus oder wählen Sie den Eintrag Identitäts-Namespace auswählen und wählen Sie eine Identität aus.
-
Wählen Sie im Fenster Zielfeld auswählen den Eintrag Identitäts-Namespace auswählen aus, wählen Sie eine Identität aus oder wählen Sie die Kategorie Attribute auswählen und wählen Sie ein Attribut aus den angezeigten Datenerweiterungen nach Bedarf aus. Das Ziel (API) Salesforce Marketing Cloud verwendet die Salesforce Marketing Cloud Search Attribute-Set Definitions REST API, um die Datenerweiterungen und die zugehörigen verknüpften Attribute dynamisch abzurufen, die in Salesforce Marketing Cloud definiert sind. Diese werden im Popup-Fenster 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 Datenerweiterung 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 -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 Weiter aus.
Zielgruppenexport und Beispiel planen schedule-segment-export-example
Beim Ausführen des Schritts Zielgruppenexport planen müssen Sie Platform-Zielgruppen den Attributen in Salesforce Marketing Cloud manuell zuordnen.
Wählen Sie dazu jedes Segment aus und geben Sie dann im Feld (API) Salesforce Marketing Cloud Zuordnungs-ID den Namen des Attributs von Salesforce Marketing Cloud ein. Anleitungen und Best Practices zum Erstellen von Attributen in Salesforce Marketing Cloud finden Sie im Abschnitt Attribut in Salesforce Marketing Cloud erstellen .
Wenn Ihr Salesforce Marketing Cloud -Attribut beispielsweise salesforce_mc_segment_1
ist, geben Sie diesen Wert in der (API) Salesforce Marketing Cloud Zuordnungs-ID an, um Zielgruppen aus Experience Platform in dieses Attribut einzufügen.
Nachfolgend finden Sie ein Beispielattribut von Salesforce Marketing Cloud:
Unten finden Sie ein Beispiel, das die Position der (API) Salesforce Marketing Cloud Zuordnungs-ID angibt:
Wie gezeigt, sollte die (API) Salesforce Marketing Cloud 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, das auf dem oben gezeigten Bild basiert, könnte sein.
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 Website Salesforce Marketing Cloud 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 zu überprüfen, ob Profile aktualisiert wurden, navigieren Sie zur Seite E-Mail und überprüfen Sie, ob die Attributwerte für das Profil aus der Zielgruppe aktualisiert wurden. Bei erfolgreicher Ausführung können Sie sehen, dass jeder Zielgruppenstatus in Salesforce Marketing Cloud basierend auf dem im Schritt Zielgruppenplanung angegebenen Wert für die Zuordnungs-ID mit dem entsprechenden Zielgruppenstatus von Platform aktualisiert 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 Senden von Ereignissen an das Salesforce-Marketing Cloud unknown-errors
-
Beim Überprüfen eines Datenfluss-Ablaufs wird möglicherweise die folgende Fehlermeldung ausgegeben:
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 Zuordnungs-ID, die Sie im Aktivierungs-Workflow für das Ziel (API) Salesforce Marketing Cloud angegeben haben, genau mit dem Namen des Attributs übereinstimmt, das Sie in Salesforce Marketing Cloud erstellt haben. Eine Anleitung dazu finden Sie im Abschnitt Attribut in Salesforce Marketing Cloud erstellen .
-
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...
- Um diesen Fehler zu beheben, wenden Sie sich an Ihren Salesforce Marketing Cloud -Kontoadministrator, um Experience Platform IP-Adressen zu den vertrauenswürdigen IP-Bereichen Ihrer Salesforce Marketing Cloud-Konten hinzuzufügen. Weitere Informationen zu Zulassungslisten in Marketing Cloud🔗 finden Sie in der Dokumentation Salesforce Marketing Cloud IP-Adressen für die Aufnahme .
Zusätzliche Ressourcen additional-resources
- Salesforce Marketing Cloud API
- Salesforce Marketing Cloud Dokumentation, die erklärt, 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 | Aktualisierung der Dokumentation |
|
April 2023 | Aktualisierung der Dokumentation |
|
Februar 2023 | Aktualisierung der Dokumentation | Wir haben den Abschnitt Voraussetzungen im Salesforce-Marketing Cloud (API)aktualisiert, um einen Verweis-Link aufzunehmen, der angibt, dass Salesforce Marketing Cloud Engagement ein obligatorisches Abonnement für die Verwendung dieses Ziels ist. |
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. |