Verbinden Ihres Salesforce-Kontos mit Experience Platform über die Benutzeroberfläche

Lesen Sie dieses Handbuch, um zu erfahren, wie Sie Ihr Salesforce-Konto verbinden und Ihre CRM-Daten über die Benutzeroberfläche von Experience Platform in Adobe Experience Platform importieren.

Erste Schritte

Dieses Tutorial setzt ein Grundverständnis der folgenden Komponenten von Experience Platform voraus:

  • Experience Data Model (XDM) System: Das standardisierte Framework, mit dem Experience Platform Kundenerlebnisdaten organisiert.

    • Grundlagen der Schemakomposition: Machen Sie sich mit den grundlegenden Bausteinen von XDM-Schemata vertraut, einschließlich der wichtigsten Prinzipien und Best Practices bei der Schemaerstellung.
    • Tutorial zum Schema-Editor: Erfahren Sie, wie Sie benutzerdefinierte Schemata mithilfe der Benutzeroberfläche des Schema-Editors erstellen können.
  • Real-Time Customer Profile: Bietet ein einheitliches Echtzeit-Kundenprofil, das auf aggregierten Daten aus verschiedenen Quellen basiert.

Wenn Sie bereits über ein authentifiziertes Salesforce-Konto verfügen, können Sie den Rest dieses Dokuments überspringen und mit dem Tutorial zum ​ eines Datenflusses für CRM-Daten ​.

Konfigurieren der Salesforce App

Bevor Sie Salesforce mit Adobe Experience Platform verbinden, stellen Sie sicher, dass die Salesforce verbundene Anwendung, die Sie für die Authentifizierung verwenden, den OAuth-Bereich Verwalten von Benutzerdaten über APIs enthält (api). Dieser Bereich ist erforderlich, damit Experience Platform auf Daten aus Salesforce zugreifen kann. Wenn dieser Bereich fehlt, kann die Authentifizierung fehlschlagen.

Sammeln erforderlicher Anmeldedaten gather-required-credentials

Die Salesforce-Quelle unterstützt die Authentifizierung über OAuth2-Client-Anmeldeinformationen.

Anmeldedaten
Beschreibung
Umgebungs-URL
Die URL der Salesforce Quellinstanz. Das Format für die Umgebungs-URL ist https://[domain].my.salesforce.com.
Client-ID
Die Client-ID wird im Rahmen der OAuth2-Authentifizierung zusammen mit dem Client-Geheimnis verwendet. Zusammen ermöglichen die Client-ID und das Client-Geheimnis, dass Ihre Anwendung im Namen Ihres Kontos betrieben wird, indem Sie Ihre Anwendung für die Salesforce identifizieren.
Client-Geheimnis
Das Client-Geheimnis wird zusammen mit der Client-ID als Teil der OAuth2-Authentifizierung verwendet. Zusammen ermöglichen die Client-ID und das Client-Geheimnis, dass Ihre Anwendung im Namen Ihres Kontos betrieben wird, indem Sie Ihre Anwendung für die Salesforce identifizieren.
API-Version
Die REST-API-Version der von Ihnen verwendeten Salesforce. Der Wert für die API-Version muss mit einer Dezimalzahl formatiert sein. Wenn Sie beispielsweise die API-Version 52 verwenden, müssen Sie den Wert als 52.0 eingeben. Wenn dieses Feld leer gelassen wird, verwendet Experience Platform automatisch die neueste verfügbare Version.
Gelöschte Objekte einschließen
Ein boolescher Wert, der bestimmt, ob vorläufig gelöschte Datensätze einbezogen werden sollen. Wenn dieser Wert auf „true“ festgelegt ist, können vorläufig gelöschte Datensätze in die Salesforce-Abfrage aufgenommen und aus Ihrem -Konto in Experience Platform aufgenommen werden. Wenn Sie Ihre Konfiguration nicht angeben, wird dieser Wert standardmäßig auf false festgelegt.

Weitere Informationen zur Verwendung von OAuth für Salesforce finden Sie im Salesforce Handbuch zu OAuth-Autorisierungsflüssen.

Verbinden Ihres Salesforce-Kontos

Navigieren Sie in der Experience Platform-Benutzeroberfläche linken Menü zu Quellen“, um den Arbeitsbereich Quellen zu öffnen. Verwenden Sie den Katalog auf der linken Seite, um Kategorien zu durchsuchen, oder verwenden Sie die Suchleiste, um schnell die Quelle zu finden, die Sie verbinden möchten.

Wählen Sie Salesforce unter der Kategorie CRM und dann Daten hinzufügen.

TIP
Im Quellkatalog wird "" angezeigt wenn kein Konto verbunden ist, oder "hinzufügen wenn ein Konto bereits authentifiziert ist.

Der Quellkatalog auf der Experience Platform-Benutzeroberfläche mit der ausgewählten Salesforce-Quellkarte.

Die Verbindung zu Salesforce herstellen wird angezeigt. Auf dieser Seite können Sie entweder neue oder vorhandene Anmeldedaten verwenden.

Vorhandenes Konto verwenden

Um ein vorhandenes Konto zu verwenden, wählen Sie Vorhandenes Konto und dann das Konto, das Sie verwenden möchten, aus der angezeigten Liste aus. Wenn Sie fertig sind, wählen Sie Weiter aus, um fortzufahren.

Eine Liste der authentifizierten Salesforce-Konten, die bereits in Ihrer Organisation vorhanden sind.

Neues Konto erstellen

Um ein neues Konto zu erstellen, wählen Sie Neues Konto und geben Sie einen Namen und eine Beschreibung für Ihr neues Salesforce Konto an.

Wählen Sie für Client-Anmeldeinformationen für OAuth 2 die Option Client-Anmeldeinformationen für OAuth2 und geben Sie dann Werte für die folgenden Anmeldeinformationen an:

  • Umgebungs-URL
  • Client-ID
  • Client-Geheimnis
  • API-Version
  • Objekte einschließen/löschen
IMPORTANT
Stellen Sie sicher, dass die für diese Verbindung verwendete Salesforce verbundene App den OAuth-Bereich Verwalten von Benutzerdaten über APIs (api) enthält. Wenn dieser Bereich fehlt, kann die Authentifizierung fehlschlagen, wenn Experience Platform versucht, Daten aus Salesforce zu lesen.

Wenn Sie fertig sind, wählen Mit Quelle verbinden.

Die Benutzeroberfläche, in der Sie ein neues Salesforce-Konto erstellen können, indem Sie die entsprechenden Authentifizierungsdaten angeben.

Verbinden mit Salesforce auf AWS aws

Gehen Sie wie folgt vor, um mithilfe der OAuth 2.0 JWT Bearer-Authentifizierung ein Salesforce-Konto in Amazon Web Services (AWS) zu verbinden.

AVAILABILITY
Dieser Abschnitt gilt für Implementierungen von Experience Platform, die auf Amazon Web Services (AWS) ausgeführt werden. Experience Platform, das auf AWS ausgeführt wird, steht derzeit einer begrenzten Anzahl von Kunden zur Verfügung. Weitere Informationen zur unterstützten Experience Platform-Infrastruktur finden Sie in der Übersicht zur Experience Platform Multi-Cloud.

Um ein neues Konto zu erstellen, wählen Sie Neues Konto und geben Sie einen Namen und eine Beschreibung für Ihr neues Salesforce Konto an. Geben Sie dann Werte für die folgenden Anmeldeinformationen an:

  • jwtToken
  • instanceUrl
  • Client-ID
  • Client-Geheimnis

Um eine Verbindung zu einer Sandbox-Organisation anstelle einer Produktions-Organisation herzustellen, wählen Sie SANDBOX aus der Dropdown-Liste environmentType aus. Wenn Sie keinen Wert auswählen, wird für Experience Platform standardmäßig PRODUCTION. Weitere Informationen zur Sandbox-Unterstützung finden Sie im Abschnitt Herstellen einer Verbindung zu einer Produktions- oder Sandbox-Organisation.

IMPORTANT
Stellen Sie sicher, dass der für diese Verbindung verwendete Salesforce Connected App in derselben Organisation autorisiert ist, auf die environmentType und instanceUrl verweisen. Informationen zum Einrichten einer Connected App in AWS finden Sie im Salesforce Einrichtungshandbuch für AWS.

Wenn Sie fertig sind, wählen Mit Quelle verbinden.

Der Salesforce AWS-Authentifizierungsschritt in Experience Platform, in dem Felder für jwtToken, instanceUrl, Client ID, Client Secret und das Dropdown-Menü environmentType auf PRODUCTION gesetzt angezeigt werden.

Vorschau der Beispieldaten überspringen skip-preview-of-sample-data

Während des Datenauswahlschritts kann es bei der Aufnahme großer Datentabellen oder -dateien zu einer Zeitüberschreitung kommen. Sie können die Datenvorschau überspringen, um die Zeitüberschreitung zu umgehen, und Ihr Schema dennoch anzeigen, wenn auch ohne Beispieldaten. Um die Datenvorschau zu überspringen, aktivieren Sie den Umschalter Vorschau von Beispieldaten überspringen.

Der Rest des Workflows bleibt unverändert. Der einzige Nachteil besteht darin, dass das Überspringen der Datenvorschau verhindert, dass berechnete und erforderliche Felder während des Zuordnungsschritts automatisch validiert werden. Diese Felder müssen dann während der Zuordnung manuell validiert werden.

Nächste Schritte

Mithilfe dieses Tutorials haben Sie eine Verbindung zu Ihrem Salesforce-Konto hergestellt. Sie können jetzt mit dem nächsten Tutorial fortfahren und einen Datenfluss konfigurieren, um Daten in zu importieren Experience Platform.

recommendation-more-help
experience-platform-help-sources