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 eines Unternehmens, die bzw. das möglicherweise nicht an den von Ihnen verkauften Produkten oder Services interessiert ist.
- Kontakte - Ein Kontakt ist eine Person, mit der einer Ihrer Mitarbeiter eine Beziehung aufgebaut hat und die als potenzieller Kunde qualifiziert wurde.
Dieses Adobe Experience Platform Ziel nutzt die Salesforce composite API, die beide oben beschriebenen Profiltypen unterstützt.
Beim Aktivieren von Segmenten können Sie entweder zwischen Leads oder Kontakten wählen und Attribute und Zielgruppendaten in Salesforce CRM aktualisieren.
Salesforce CRM verwendet OAuth 2 mit Passwortgewährung 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 diese Zielgruppen an Salesforce CRM senden, um die CRM-Mitgliedschaft zu aktualisieren, sobald Zielgruppen und Profile in Adobe Experience Platform aktualisiert werden.
Voraussetzungen prerequisites
Voraussetzungen in Experience Platform prerequisites-in-experience-platform
Bevor Sie Daten für das Salesforce CRM-Ziel aktivieren, müssen Sie ein Schema, einen Datensatz und Segmente in Experience Platform erstellt haben.
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
Navigieren Sie zur Salesforce Testversion-Seite, um sich zu registrieren und ein Salesforce Konto zu erstellen, falls Sie noch keines haben.
Konfigurieren einer verbundenen App in Salesforce prerequisites-connected-app
Zunächst müssen Sie eine Salesforce verbundene App in Ihrem Salesforce-Konto konfigurieren, falls Sie noch keine haben. Salesforce CRM nutzt die verbundene App, um eine Verbindung zu Salesforce herzustellen.
Aktivieren Sie als Nächstes OAuth Settings for API Integration für die Salesforce connected app. Eine Anleitung dazu finden Sie in der Salesforce Dokumentation .
Stellen Sie außerdem sicher dass die untenBereiche“ für die Salesforce connected app ausgewählt sind.
chatter_api
lightning
visualforce
content
openid
full
api
web
refresh_token
offline_access
Stellen Sie abschließend sicher, dass die password
in Ihrem Salesforce-Konto aktiviert ist. Weitere Informationen finden Sie in der Salesforce OAuth 2.0 Benutzername-Kennwort-Fluss für-Szenarien“.
Erstellen benutzerdefinierter Felder in Salesforce prerequisites-custom-field
Beim Aktivieren von Zielgruppen für das Salesforce CRM-Ziel müssen Sie für jede aktivierte Zielgruppe im Schritt Zielgruppen einen Wert in das Feld Zuordnungs-ID eingeben.
Salesforce CRM erfordert diesen Wert, um Zielgruppen, die von Experience Platform eingehen, korrekt zu lesen und zu interpretieren und ihren Zielgruppenstatus in Salesforce 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 CRM aktivieren, müssen Sie ein benutzerdefiniertes Feld des Typs Text Area (Long)
in Salesforce erstellen. Sie können die Feldzeichenlänge beliebiger Größe zwischen 256 und 131.072 Zeichen entsprechend Ihren Geschäftsanforderungen definieren. Weitere Informationen zu benutzerdefinierten Feldtypen finden Salesforce auf DokumentationsseiteBenutzerdefinierte Feldtypen“. Weitere Informationen finden Sie auch in der Salesforce-Dokumentation Erstellen benutzerdefinierter Felder , wenn Sie Hilfe bei der Felderstellung benötigen.
(_)
als Trennzeichen.In Salesforce müssen Sie benutzerdefinierte Felder mit einem Feldnamen“ erstellen der für jedes aktivierte Platform-Segment genau mit dem in Zuordnungs angegebenen Wert ü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 vom Experience Platform in dieses benutzerdefinierte Feld einzufügen.Ein Beispiel für die Erstellung benutzerdefinierter Felder in Salesforce, Schritt 1 - Wählen Sie den Datentyp aus, wird unten angezeigt:
Ein Beispiel für die Erstellung benutzerdefinierter Felder in Salesforce, Schritt 2: Geben Sie die Details für das benutzerdefinierte Feld ein, wird unten angezeigt:
- 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 haben können.
- Wenn Sie dieses Limit in Salesforce erreicht haben, müssen Sie die benutzerdefinierten Attribute aus Salesforce entfernen, die zum Speichern des Zielgruppenstatus für ältere Zielgruppen in Experience Platform verwendet wurden, bevor eine neue Zuordnungs-ID verwendet werden kann.
Sammeln von Salesforce CRM-Anmeldedaten gather-credentials
Beachten Sie die folgenden Punkte, bevor Sie sich beim Salesforce CRM-Ziel authentifizieren:
Username
Password
Security Token
Informationen zum Zurücksetzen Ihres Sicherheits-Tokens finden in der Salesforce-Dokumentation um zu erfahren, wie Sie es über die Salesforce-Oberfläche neu generieren, wenn Sie das Sicherheits-Token nicht haben.
Custom Domain
Informationen zum Abrufen dieses Werts aus der Salesforce-🔗 finden Sie in der Salesforce Dokumentation.
d5i000000isb4eak-dev-ed
.my.salesforce.com,Sie
d5i000000isb4eak-dev-ed
als Wert benötigen.Client ID
Consumer Key
.Informationen zum Abrufen dieses Werts aus der Salesforce-🔗 finden Sie in der Salesforce Dokumentation.
Client Secret
Consumer Secret
.Informationen zum Abrufen dieses Werts aus der Salesforce-🔗 finden Sie in der Salesforce Dokumentation.
Leitplanken guardrails
Salesforce gleicht Transaktionslasten ab, indem Sie Limits für Anfragen, Raten und Zeitüberschreitungen festlegen. Weitere Informationen finden Sie unter API-Anfrage-Limits und".
Wenn der Administrator Ihres Salesforce-Kontos IP-Einschränkungen durchgesetzt hat, müssen Sie Experience Platform-IP- zu den vertrauenswürdigen IP-Bereichen Ihrer Salesforce-Konten hinzufügen. Weitere Anleitungen finden Sie in der Salesforce Zugriff auf vertrauenswürdige IP-Bereiche für eineApp beschränken“.
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 mit dem entsprechenden Zielgruppenstatus von Platform aktualisiert, basierend auf dem Wert Zuordnungs-ID, der im Schritt Zielgruppen-Planung angegeben wurde.
- 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. Eine Anleitung dazu finden im Abschnitt Salesforce CRM SammelnAnmeldeinformationen“.
Der verkettete Wert hat die Form von
{PASSWORD}{TOKEN}
.Hinweis: Verwenden Sie keine Klammern oder Leerzeichen.
Wenn Ihr Salesforce-Kennwort beispielsweise
MyPa$$w0rd123
und Salesforce Sicherheits-Token TOKEN12345....0000
ist, wird der verkettete Wert, den Sie im Feld Kennwort verwenden, MyPa$$w0rd123TOKEN12345....0000
.Wenn Ihre Domain beispielsweise
d5i000000isb4eak-dev-ed
.my.salesforce.com lautet müssen Sie d5i000000isb4eak-dev-ed
als Wert 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-Typ:
- 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 exportiert oder aktualisiert werden sollen, 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
-
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 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-Datenmodells (XDM) in Ihrem Platform-Konto und den entsprechenden Entsprechungen vom Ziel zu erstellen.
Die im Feld Ziel“ angegebenen Attribute genau wie in der Tabelle der Attributzuordnungen beschrieben benannt werden, da diese Attribute den Anfragetext bilden.
Im Feld Source angegebene Attribute folgen keiner dieser Einschränkungen. Sie können sie nach Bedarf zuordnen, stellen jedoch sicher, dass das Format der Eingabedaten gemäß der Salesforce Dokumentation) gültig. Wenn die Eingabedaten ungü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 Schritt Zuordnung“ 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 aus oder wählen Sie Benutzerdefinierte Attribute auswählen und wählen Sie ein Attribut aus oder definieren Sie eines mithilfe des Felds Attributname nach Bedarf. Anleitungen zu unterstützten Attributen finden Salesforce CRM in derDokumentation).
- 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 Kontakte arbeiten, definieren Sie in der Objektreferenz in Salesforce für Kontakt Zuordnungen für die zu aktualisierenden Felder.
-
Sie können Pflichtfelder identifizieren, indem Sie nach dem Wort Erforderlich suchen, das in den Feldbeschreibungen im obigen Link erwähnt wird.
-
Fügen Sie je nach den Feldern, die Sie exportieren oder aktualisieren möchten, 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
Der Vorname des Kontakts kann bis zu 40 Zeichen lang sein. 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, definieren Sie in der Objektreferenz in Salesforce für Lead Zuordnungen für die zu aktualisierenden Felder.
-
Sie können Pflichtfelder identifizieren, indem Sie nach dem Wort Erforderlich suchen, das in den Feldbeschreibungen im obigen Link erwähnt wird.
-
Fügen Sie je nach den Feldern, die Sie exportieren oder aktualisieren möchten, 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 Firma des Leads.xdm: personalEmail.address
Attribute: Email
Die E-Mail-Adresse des Leads. -
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
Beim Schritt Planen des Zielgruppenexports müssen Sie die in Platform aktivierten Zielgruppen manuell dem 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 CRMZuordnungs ein. Anleitungen und Best Practices Erstellen benutzerdefinierter Felder in Salesforce finden Sie im Abschnitt zum Erstellen benutzerdefinierter Felder in Salesforce.
Wenn Ihr Salesforce benutzerdefiniertes Feld beispielsweise crm_2_seg
ist, geben Sie diesen Wert im Salesforce CRM (Zuordnungs ID), um Zielgruppen vom Experience Platform in dieses benutzerdefinierte Feld einzufügen.
Ein Beispiel für ein benutzerdefiniertes Feld aus Salesforce sehen Sie unten:
Screenshot der
Nachfolgend finden Sie ein Beispiel, das den Speicherort der Salesforce CRM Zuordnungs ID“ angibt:
Wie oben gezeigt, entspricht Salesforce Feldname genau dem in Salesforce CRMZuordnungs-ID angegebenen Wert.
Je nach Anwendungsfall können alle aktivierten Zielgruppen demselben Salesforce benutzerdefinierten Feld oder unterschiedlichen Feldnamen“ in Salesforce CRM zugeordnet. Ein typisches Beispiel auf der Grundlage des oben gezeigten Bildes könnte wie folgt aussehen.
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 abschließend bei der Salesforce-Website an und überprüfen Sie, ob die Profile aus der Zielgruppe hinzugefügt oder aktualisiert wurden.
Arbeiten mit Kontakten
-
Wenn Sie in Platform-Segment "" 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 mit dem entsprechenden Zielgruppenstatus von Platform aktualisiert wurde, basierend auf dem Wert Zuordnungs-ID, der während der Zielgruppen-Planung angegeben wurde.
Arbeiten mit Leads
-
Wenn Sie Leads innerhalb Ihres Platform-Segments 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 mit dem entsprechenden Zielgruppenstatus von Platform aktualisiert wurde, basierend auf dem Wert Zuordnungs-ID, der während der 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
Beim Pushen von Ereignissen an das Ziel sind unbekannte Fehler aufgetreten 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 die „Zuordnungs ID“, die Sie im Aktivierungs-Workflow für das Salesforce CRM-Ziel angegeben haben, genau mit dem Wert des benutzerdefinierten Feldtyps übereinstimmt, den Sie in Salesforce erstellt haben. Eine Anleitung finden im Abschnitt Erstellen Salesforce benutzerdefinierten Feldern 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-Kontoadministrator, um Experience Platform-IP- zu den vertrauenswürdigen IP-Bereichen Ihrer Salesforce hinzuzufügen. Weitere Anleitungen finden Sie in der Salesforce Zugriff auf vertrauenswürdige IP-Bereiche für eineApp beschränken“.
Zusätzliche Ressourcen additional-resources
Weitere nützliche Informationen vom Salesforce-Entwicklerportal finden Sie unten:
- Schnellstart
- Datensatz erstellen
- Benutzerdefinierte Recommendations-Zielgruppen
- Verwenden von zusammengesetzten Ressourcen
- Dieses Ziel nutzt die API Upsert Multiple Records anstelle des API-Aufrufs Upsert Single Record.