Salesforce CRM-Verbindung
Übersicht overview
Salesforce CRM ist eine beliebte CRM-Plattform (Customer Relationship Management) und unterstützt die unten beschriebenen Profiltypen:
- Leads - Ein Lead ist der Name einer Person oder Firma, die sich möglicherweise für die von Ihnen verkauften Produkte oder Dienstleistungen interessiert (oder nicht).
- Kontakte - Ein Kontakt ist eine Person, mit der einer Ihrer Vertreter eine Beziehung hergestellt hat und die als potenzieller Kunde qualifiziert wurde.
Dieses Adobe Experience Platform Ziel nutzt den Salesforce composite API, der beide oben beschriebenen Profiltypen unterstützt.
Beim Aktivieren von Segmenten können Sie zwischen Leads oder Kontakten wählen und Attribute und Zielgruppendaten in Salesforce CRM aktualisieren.
Salesforce CRM verwendet OAuth 2 mit Password Grant als Authentifizierungsmechanismus für die Kommunikation mit der Salesforce REST API. Anweisungen zur Authentifizierung bei Ihrer Salesforce CRM-Instanz sehen Sie weiter unten im Abschnitt Authentifizieren bei Ziel.
Anwendungsbeispiele use-cases
Als Marketing-Experte können Sie Ihren Benutzern personalisierte Erlebnisse auf der Basis von Attributen aus ihren Adobe Experience Platform-Profilen bereitstellen. Sie können Zielgruppen aus Ihren Offline-Daten erstellen und an Salesforce CRM senden, um die CRM-Mitgliedschaft zu aktualisieren, sobald Audiences und Profile in Adobe Experience Platform aktualisiert wurden.
Voraussetzungen prerequisites
Voraussetzungen für Experience Platform prerequisites-in-experience-platform
Bevor Sie Daten für das Salesforce CRM-Ziel aktivieren, müssen Sie über ein Schema, einen Datensatz und Segmente verfügen, die in Experience Platform erstellt wurden.
Voraussetzungen in Salesforce CRM prerequisites-destination
Beachten Sie die folgenden Voraussetzungen in Salesforce CRM, um Daten von Platform in Ihr Salesforce-Konto zu exportieren:
Sie benötigen ein Salesforce-Konto prerequisites-account
Rufen Sie die Seite Salesforce Testen auf, um sich zu registrieren und ein Salesforce -Konto zu erstellen, falls noch keines vorhanden ist.
Eine verbundene App mit Salesforce konfigurieren prerequisites-connected-app
Zunächst müssen Sie eine Salesforce verbundene App in Ihrem Salesforce-Konto konfigurieren, falls noch keine vorhanden ist. Salesforce CRM nutzt die verbundene App, um eine Verbindung zu Salesforce herzustellen.
Aktivieren Sie als Nächstes OAuth Settings for API Integration für den Salesforce connected app. Eine Anleitung finden Sie in der Dokumentation zu Salesforce .
Stellen Sie außerdem sicher, dass die unten erwähnten Bereiche für den Salesforce connected app ausgewählt sind.
chatter_api
lightning
visualforce
content
openid
full
api
web
refresh_token
offline_access
Stellen Sie schließlich sicher, dass der password
-Zuschuss in Ihrem Salesforce-Konto aktiviert ist. Weitere Informationen finden Sie in der Dokumentation Salesforce OAuth 2.0 Username-Password Flow for Special Scenarios , wenn Sie Anleitungen benötigen.
Benutzerdefinierte Felder in Salesforce erstellen prerequisites-custom-field
Beim Aktivieren von Zielgruppen für das Ziel Salesforce CRM müssen Sie im Schritt Zielgruppenplan im Feld Zuordnungs-ID einen Wert für jede aktivierte Zielgruppe eingeben.
Salesforce CRM erfordert diesen Wert, um von Experience Platform kommende Zielgruppen korrekt zu lesen und zu interpretieren und ihren Zielgruppenstatus innerhalb von Salesforce 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 CRM aktivieren, müssen Sie ein benutzerdefiniertes Feld vom Typ Text Area (Long)
in Salesforce erstellen. Sie können die Länge von Feldzeichen zwischen 256 und 131.072 Zeichen entsprechend Ihren Geschäftsanforderungen definieren. Weitere Informationen zu benutzerdefinierten Feldtypen finden Sie auf der Dokumentationsseite Salesforce Benutzerdefinierte Feldtypen . Weitere Informationen zum Erstellen benutzerdefinierter Felder finden Sie in der Dokumentation zu Salesforce unter Erstellen benutzerdefinierter Felder , wenn Sie Unterstützung bei der Felderstellung benötigen.
(_)
als Trennzeichen.Innerhalb von Salesforce müssen Sie benutzerdefinierte Felder mit einem Feldnamen erstellen, der genau mit dem in Zuordnungs-ID angegebenen Wert für jedes aktivierte Platform-Segment übereinstimmt. Der folgende Screenshot zeigt beispielsweise ein benutzerdefiniertes Feld mit dem Namen
crm_2_seg
. Fügen Sie beim Aktivieren einer Zielgruppe für dieses Ziel crm_2_seg
als Zuordnungs-ID hinzu, um Zielgruppen aus Experience Platform in dieses benutzerdefinierte Feld zu füllen.Nachfolgend finden Sie ein Beispiel für die Erstellung benutzerdefinierter Felder in Salesforce, Schritt 1 - Auswählen des Datentyps:
Ein Beispiel für die Erstellung eines benutzerdefinierten Felds in Salesforce, Schritt 2 - Geben Sie die Details für das benutzerdefinierte Feld ein:
- Um zwischen benutzerdefinierten Feldern, die für Platform-Zielgruppen verwendet werden, und anderen benutzerdefinierten Feldern in Salesforce zu unterscheiden, können Sie beim Erstellen des benutzerdefinierten Felds ein erkennbares Präfix oder Suffix einfügen. Verwenden Sie beispielsweise anstelle von
test_segment
Adobe_test_segment
odertest_segment_Adobe
. - Wenn Sie bereits andere benutzerdefinierte Felder in Salesforce erstellt haben, können Sie denselben Namen wie das Platform-Segment verwenden, um die Zielgruppe in Salesforce einfach zu identifizieren.
- Objekte in Salesforce sind auf 25 externe Felder beschränkt, siehe Benutzerdefinierte Feldattribute.
- Diese Einschränkung bedeutet, dass Sie immer nur maximal 25 Experience Platform-Zielgruppenmitgliedschaften aktiv sein können.
- Wenn Sie diese Grenze in Salesforce erreicht haben, müssen Sie die benutzerdefinierten Attribute aus Salesforce entfernen, die zum Speichern des Zielgruppenstatus für ältere Zielgruppen innerhalb von Experience Platform verwendet wurden, bevor eine neue Zuordnungs-ID verwendet werden kann.
Sammeln von Salesforce CRM-Anmeldedaten gather-credentials
Beachten Sie die folgenden Elemente, bevor Sie sich beim Salesforce CRM-Ziel authentifizieren:
Username
Password
Security Token
In der Dokumentation Salesforce erfahren Sie, wie Sie Ihr Sicherheits-Token zurücksetzen 🔗, indem Sie erfahren, wie Sie es über die Salesforce -Benutzeroberfläche neu generieren, wenn Sie nicht über das Sicherheits-Token verfügen.
Custom Domain
In der Salesforce Dokumentation erfahren Sie, wie Sie diesen Wert von der Salesforce -Oberfläche abrufen.
ist
d5i000000isb4eak-dev-ed
.my.salesforce.com,benötigen Sie
d5i000000isb4eak-dev-ed
als Wert.Client ID
Consumer Key
.In der Salesforce Dokumentation erfahren Sie, wie Sie diesen Wert aus der Salesforce -Oberfläche abrufen.
Client Secret
Consumer Secret
.In der Salesforce Dokumentation erfahren Sie, wie Sie diesen Wert aus der Salesforce -Oberfläche abrufen.
Leitplanken guardrails
Salesforce gleicht Transaktionslasten durch Auferlegung von Anforderungs-, Rate- und Timeout-Beschränkungen aus. Weitere Informationen finden Sie unter API-Anforderungsbeschränkungen und -Zuordnungen .
Wenn Ihr Salesforce -Kontoadministrator IP-Einschränkungen erzwungen hat, müssen Sie Experience Platform IP-Adressen zu den vertrauenswürdigen IP-Bereichen Ihrer Salesforce-Konten hinzufügen. Weitere Informationen finden Sie in der Dokumentation Salesforce Beschränken des Zugriffs auf vertrauenswürdige IP-Bereiche für eine Connected App .
Unterstützte Identitäten supported-identities
Salesforce CRM unterstützt die Aktualisierung von Identitäten, die in der folgenden Tabelle beschrieben werden. Erhalten Sie weitere Informationen zu Identitäten.
SalesforceId
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 Zielgruppenstatus in Salesforce CRM wird anhand des Werts Zuordnungs-ID aktualisiert, der während des Schritts Zielgruppenplanung angegeben wurde, und erhält den entsprechenden Zielgruppenstatus von Platform.
- Streaming-Ziele sind „immer verfügbare“ API-basierte Verbindungen. Sobald ein Profil in Experience Platform auf der Grundlage einer Zielgruppenauswertung aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Lesen Sie mehr über Streaming-Ziele.
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 Salesforce CRM. Alternativ können Sie es unter der CRM-Kategorie 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 CRM 2} .
Der verkettete Wert hat die Form "
{PASSWORD}{TOKEN}
".Beachten Sie, dass Sie keine geschweiften Klammern oder Leerzeichen verwenden.
Wenn Ihr Salesforce Kennwort beispielsweise
MyPa$$w0rd123
und Ihr Salesforce Sicherheitstoken TOKEN12345....0000
lautet, lautet der verkettete Wert, den Sie im Feld Kennwort verwenden, MyPa$$w0rd123TOKEN12345....0000
.Wenn Ihre Domäne beispielsweise
d5i000000isb4eak-dev-ed
.my.salesforce.com ist, müssen Sie als Wert d5i000000isb4eak-dev-ed
angeben.Consumer Key
.Consumer 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.
-
Salesforce ID Type:
- Wählen Sie Kontakt aus, wenn die Identitäten, die Sie exportieren oder aktualisieren möchten, vom Typ Kontakt sind.
- Wählen Sie Lead aus, wenn die Identitäten, die Sie exportieren oder aktualisieren möchten, vom Typ Lead sind.
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 Salesforce CRM-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.
Die im Feld Ziel angegebenen Attribute sollten genau wie in der Tabelle der Attributzuordnungen beschrieben benannt werden, da diese Attribute den Anfrageinhalt bilden.
Im Feld Source angegebene Attribute unterliegen keiner solchen Einschränkung. Sie können sie nach Bedarf zuordnen. Stellen Sie jedoch sicher, dass das Format der Eingabedaten gemäß der Salesforce Dokumentation gültig ist. Wenn die Eingabedaten nicht gültig sind, schlägt der Aktualisierungsaufruf an Salesforce fehl und Ihre Kontakte/Leads werden nicht aktualisiert.
Um Ihre XDM-Felder den (API) Salesforce CRM-Zielfeldern korrekt zuzuordnen, führen Sie die folgenden Schritte aus:
-
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 Benutzerdefinierte Attribute auswählen und wählen Sie ein Attribut aus oder definieren Sie eines mithilfe des Felds Attributname. Eine Anleitung zu unterstützten Attributen finden Sie in der Salesforce CRM Dokumentation .
- Wiederholen Sie diese Schritte, um die folgenden Zuordnungen zwischen Ihrem XDM-Profilschema und (API) Salesforce CRM hinzuzufügen:
Arbeiten mit Kontakten
-
Wenn Sie in Ihrem Segment mit Kontakten arbeiten, finden Sie in der Objektreferenz in Salesforce für Kontakt Informationen zum Definieren von Zuordnungen für die zu aktualisierenden Felder.
-
Sie können erforderliche Felder identifizieren, indem Sie nach dem Wort Erforderlich suchen, das in den Feldbeschreibungen im obigen Link erwähnt wird.
-
Je nach den Feldern, die Sie exportieren oder aktualisieren möchten, fügen Sie Zuordnungen zwischen Ihrem XDM-Profilschema und (API) Salesforce CRM hinzu:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Quellfeld Zielfeld Anmerkungen IdentityMap: crmID
Identity: SalesforceId
Mandatory
xdm: person.name.lastName
Attribute: LastName
Mandatory
. Nachname des Kontakts mit bis zu 80 Zeichen.xdm: person.name.firstName
Attribute: FirstName
Vorname des Kontakts mit bis zu 40 Zeichen. xdm: personalEmail.address
Attribute: Email
Die E-Mail-Adresse des Kontakts. -
Nachfolgend finden Sie ein Beispiel für die Verwendung dieser Zuordnungen:
Arbeiten mit Leads
-
Wenn Sie in Ihrem Segment mit Leads arbeiten, lesen Sie die Objektreferenz in Salesforce für Lead , um Zuordnungen für die zu aktualisierenden Felder zu definieren.
-
Sie können erforderliche Felder identifizieren, indem Sie nach dem Wort Erforderlich suchen, das in den Feldbeschreibungen im obigen Link erwähnt wird.
-
Je nach den Feldern, die Sie exportieren oder aktualisieren möchten, fügen Sie Zuordnungen zwischen Ihrem XDM-Profilschema und (API) Salesforce CRM hinzu:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Quellfeld Zielfeld Anmerkungen IdentityMap: crmID
Identity: SalesforceId
Mandatory
xdm: person.name.lastName
Attribute: LastName
Mandatory
. Nachname des Leads mit bis zu 80 Zeichen.xdm: b2b.companyName
Attribute: Company
Mandatory
. Die Führung ist dabei.xdm: personalEmail.address
Attribute: Email
Die E-Mail-Adresse des Leads. -
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 die von Platform aktivierten Zielgruppen manuell ihrem entsprechenden benutzerdefinierten Feld in Salesforce zuordnen.
Wählen Sie dazu jedes Segment aus und geben Sie dann den benutzerdefinierten Feldnamen aus Salesforce in das Feld Salesforce CRM Zuordnungs-ID ein. Anleitungen und Best Practices zum Erstellen benutzerdefinierter Felder in Salesforce finden Sie im Abschnitt Erstellen benutzerdefinierter Felder in Salesforce .
Wenn Ihr benutzerdefiniertes Salesforce -Feld beispielsweise crm_2_seg
ist, geben Sie diesen Wert in der Salesforce CRM Zuordnungs-ID an, um Zielgruppen aus Experience Platform in dieses benutzerdefinierte Feld zu füllen.
Nachfolgend finden Sie ein Beispiel für ein benutzerdefiniertes Feld von Salesforce:
Unten finden Sie ein Beispiel, das die Position der Salesforce CRM Zuordnungs-ID angibt:
Wie oben gezeigt, entspricht der Salesforce Feldname genau dem Wert, der in Salesforce CRM Zuordnungs-ID angegeben ist.
Je nach Anwendungsfall können alle aktivierten Zielgruppen demselben benutzerdefinierten Feld Salesforce oder unterschiedlichen Feldnamen in Salesforce CRM zugeordnet werden. Ein typisches Beispiel, das auf dem oben gezeigten Bild basiert, könnte sein.
crm_1_seg
crm_1_seg
crm_2_seg
crm_2_seg
Wiederholen Sie diesen Abschnitt für jedes aktivierte Platform-Segment.
Ü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 Aktivierungsdaten und wählen Sie dann 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 schließlich bei der Salesforce-Website an und überprüfen Sie, ob die Profile der Audience hinzugefügt oder aktualisiert wurden.
Arbeiten mit Kontakten
-
Wenn Sie in Ihrem Platform-Segment Kontakte ausgewählt haben, navigieren Sie zur Seite Apps > Contacts .
-
Wählen Sie einen Kontakt aus und überprüfen Sie, ob die Felder aktualisiert wurden. Sie können sehen, dass jeder Zielgruppenstatus in Salesforce CRM basierend auf dem Wert Zuordnungs-ID , der während der Zielgruppenplanung bereitgestellt wurde, mit dem entsprechenden Zielgruppenstatus von Platform aktualisiert wurde.
Arbeiten mit Leads
-
Wenn Sie in Ihrem Platform-Segment Leads ausgewählt haben, navigieren Sie zur Seite Apps > Leads .
-
Wählen Sie einen Lead aus und überprüfen Sie, ob die Felder aktualisiert wurden. Sie können sehen, dass jeder Zielgruppenstatus in Salesforce CRM basierend auf dem Wert Zuordnungs-ID , der während der Zielgruppenplanung bereitgestellt wurde, 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 Ziel 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 Salesforce CRM bereitgestellt haben, genau mit dem Wert des benutzerdefinierten Feldtyps übereinstimmt, den Sie in Salesforce erstellt haben. Eine Anleitung finden Sie im Abschnitt Benutzerdefinierte Felder in Salesforce 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 -Kontoadministrator, um Experience Platform IP-Adressen zu den vertrauenswürdigen IP-Bereichen Ihrer Salesforce-Konten hinzuzufügen. Weitere Informationen finden Sie in der Dokumentation Salesforce Beschränken des Zugriffs auf vertrauenswürdige IP-Bereiche für eine Connected App .
Zusätzliche Ressourcen additional-resources
Weitere nützliche Informationen aus dem Salesforce-Entwicklerportal finden Sie unten:
- Schnellstart
- Erstellen eines Datensatzes
- Benutzerspezifische Empfehlungszielgruppen
- Verwenden von Composite-Ressourcen
- Dieses Ziel nutzt die API Mehrere Datensätze hochladen anstelle des API-Aufrufs Einzeldatensatz hochladen .