Salesforce CRM-Verbindung

Übersicht

Salesforce CRM ist eine beliebte CRM-Plattform (Customer Relationship Management) und unterstützt Folgendes:

  • Leads - Ein Lead ist der Name einer Person oder Firma, die an den von Ihnen verkauften Produkten oder Dienstleistungen interessiert sein kann (oder nicht).
  • Kontakte - Ein Kontakt ist eine Person, mit der einer Ihrer Mitarbeiter eine Beziehung aufgebaut und als potenzieller Kunde qualifiziert hat.

Diese Adobe Experience Platform Ziel nutzt die Salesforce composite APIunterstützt, die beide oben beschriebenen Profiltypen unterstützt.

Wann Aktivieren von Segmentenkönnen Sie zwischen Leads oder Kontakten wählen und Attribute und Segmentdaten in aktualisieren. Salesforce CRM.

Salesforce CRM verwendet OAuth 2 mit Password Grant als Authentifizierungsmechanismus für die Kommunikation mit der Salesforce REST API. Anweisungen zur Authentifizierung bei Ihrem Salesforce CRM -Instanz weiter unten im An Ziel authentifizieren Abschnitt.

Anwendungsbeispiele

Als Marketer können Sie Ihren Benutzern personalisierte Erlebnisse auf der Basis von Attributen aus ihren Adobe Experience Platform-Profilen bereitstellen. Sie können Segmente aus Ihren Offline-Daten erstellen und an Salesforce CRM senden, um sie in den Feeds der Benutzer anzuzeigen, sobald Segmente und Profile in Adobe Experience Platform aktualisiert wurden.

Voraussetzungen

Voraussetzungen für die Experience Platform

Bevor Sie Daten für das Salesforce CRM-Ziel aktivieren, benötigen Sie eine schema, Datensatzund Segmente erstellt in Experience Platform.

Voraussetzungen in Salesforce CRM

Beachten Sie die folgenden Voraussetzungen in Salesforce CRM, um Daten von Platform in Ihr Salesforce-Konto zu exportieren:

Sie benötigen ein Salesforce-Konto

Gehe zu Salesforce Testversion -Seite, um sich zu registrieren und ein Salesforce-Konto zu erstellen, falls noch keines vorhanden ist.

Eine verbundene App konfigurieren

Als Nächstes müssen Sie eine verbundene App innerhalb Ihres Salesforce-Kontos, falls noch keines vorhanden ist.

Stellen Sie in der verbundenen App sicher, dass OAuth-Einstellungen aktiviert ist.

Stellen Sie außerdem sicher, dass Bereiche werden ausgewählt.

  • chatter_api
  • lightning
  • visualforce
  • content
  • openid
  • full
  • api
  • web
  • refresh_token
  • offline_access

Benutzerdefiniertes Feld in Salesforce erstellen

Benutzerdefiniertes Feld vom Typ erstellen Text Area Long, die Experience Platform verwendet, um den Segmentstatus in Salesforce CRM.
Weitere Informationen finden Sie in der Salesforce-Dokumentation unter Benutzerdefinierte Felder erstellen wenn Sie zusätzliche Anleitungen benötigen.

WICHTIG

Stellen Sie sicher, dass der Feldname keine Leerzeichen enthält. Verwenden Sie stattdessen den Unterstrich. (_) als Trennzeichen.

HINWEIS
  • Objekte in Salesforce sind auf 25 externe Felder beschränkt, siehe Benutzerdefinierte Feldattribute.
  • Diese Einschränkung bedeutet, dass Sie immer nur maximal 25 Experience Platformen Segmentmitgliedschaften aktiv sein können.
  • Wenn Sie diese Grenze in Salesforce erreicht haben, müssen Sie das benutzerdefinierte Attribut aus Salesforce entfernen, mit dem der Segmentstatus für ältere Segmente in Experience Platform vor einer neuen gespeichert wurde. Zuordnungs-ID verwendet werden.

Weitere Informationen finden Sie in der Dokumentation zu Adobe Experience Platform . Feldergruppe Segmentzugehörigkeitsdetails , wenn Sie Anleitungen zum Segmentstatus benötigen.

Salesforce-Anmeldeinformationen sammeln

Beachten Sie die folgenden Elemente, bevor Sie sich bei der Salesforce CRM Ziel:

Anmeldedaten Beschreibung Beispiel
  • Salesforce-Domänenpräfix
Siehe Salesforce-Domänenpräfix für zusätzliche Leitlinien.
  • Wenn Ihre Domäne wie folgt lautet, benötigen Sie den hervorgehobenen Wert.
    d5i000000isb4eak-dev-ed.my.salesforce.com
  • Consumer Key
  • Verbrauchergeheimnis
Siehe Abschnitt Salesforce-Dokumentation wenn Sie zusätzliche Anleitungen benötigen.
  • r23kxxxxxxxx0z05xxxxxx
  • ipxxxxxxxxxxT4xxxxxxxxxxxx

Limits

Salesforce gleicht Transaktionslasten durch Auferlegung von Anforderungs-, Rate- und Timeout-Beschränkungen aus. Siehe Abschnitt API-Anforderungsbeschränkungen und -zuordnungen für Details.

WICHTIG

Wann Aktivieren von Segmenten Sie müssen zwischen Kontakt oder Lead Typen. Sie müssen sicherstellen, dass Ihre Segmente entsprechend dem ausgewählten Typ über das entsprechende Daten-Mapping verfügen.

Unterstützte Identitäten

Salesforce CRM unterstützt die Aktualisierung von Identitäten, die in der folgenden Tabelle beschrieben werden. Weitere Informationen identities.

Zielgruppenidentität Beschreibung Zu beachten
SalesforceId Die Salesforce CRM Kennung für die Kontakt- oder Lead-Identitäten, die Sie über Ihr Segment exportieren oder aktualisieren. Obligatorisch

Exportart und -frequenz

Informationen zum Zielexporttyp und zur Häufigkeit finden Sie in der unten stehenden Tabelle.

Element Typ Anmerkungen
Exporttyp Profilbasiert
  • 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 CRM wird mit dem entsprechenden Segmentstatus von Platform aktualisiert, basierend auf dem Zuordnungs-ID Wert, der während der Segmentplanung Schritt.
Exporthäufigkeit Streaming
  • Streaming-Ziele sind "immer auf"-API-basierte Verbindungen. Sobald ein Profil in Experience Platform auf der Grundlage einer Segmentbewertung aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Mehr dazu Streaming-Ziele.

Herstellen einer Verbindung mit der Datenbank

WICHTIG

Um eine Verbindung zum Ziel herzustellen, benötigen Sie die Ziele verwalten Zugriffsberechtigung. Lesen Sie die Zugriffskontrolle - Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Abschnitt 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.

Within Ziele > Katalog Suchen nach Salesforce CRM. Alternativ können Sie sie unter der CRM Kategorie.

An Ziel authentifizieren

Um sich beim Ziel zu authentifizieren, füllen Sie die erforderlichen Felder aus und wählen Sie Mit Ziel verbinden.

Screenshot der Platform-Benutzeroberfläche, in dem die Authentifizierung gezeigt wird.

  • Passwort: Ihr Salesforce-Kontokennwort.
  • Benutzerdefinierte Domäne: Ihre Salesforce-Domäne.
  • Client-ID: Kundenschlüssel der mit Salesforce verbundenen App.
  • Client Secret: Ihre mit Salesforce verbundene App - Kundengeheimnis.
  • Benutzername: Ihr Salesforce-Konto-Benutzername.

Wenn die angegebenen Details gültig sind, zeigt die Benutzeroberfläche eine Verbunden Status mit einem grünen Häkchen anzeigen, können Sie mit dem nächsten Schritt fortfahren.

Zieldetails ausfüllen

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.
Screenshot der Platform-Benutzeroberfläche mit den Zieldetails.

  • Name: Ein Name, mit dem Sie dieses Ziel in der Zukunft erkennen werden.
  • Beschreibung: Eine Beschreibung, die Ihnen dabei hilft, dieses Ziel in der Zukunft zu identifizieren.
  • Salesforce-ID-Typ: Auswählen Kontakt ob die Identitäten, die Sie exportieren oder aktualisieren möchten, vom Typ Kontakt. Auswählen Lead ob die Identitäten, die Sie exportieren oder aktualisieren möchten, vom Typ Lead.

Aktivieren von Warnhinweisen

Sie können Warnhinweise aktivieren, um Benachrichtigungen über den Status des Datenflusses an Ihr 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 Warnungen finden Sie im Handbuch zu Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.

Wenn Sie alle Details für Ihre Zielverbindung angegeben haben, wählen Sie Nächste.

Aktivieren von Segmenten für dieses Ziel

WICHTIG

Um Daten zu aktivieren, benötigen Sie die Ziele verwalten, Ziele aktivieren, Profile anzeigen und Segmente anzeigen Zugriffssteuerungsberechtigungen. Lesen Sie die Zugriffskontrolle - Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

Lesen Aktivieren von Profilen und Segmenten für Streaming-Segmentexportziele für Anweisungen zum Aktivieren von Zielgruppensegmenten für dieses Ziel.

Zuordnungsüberlegungen und Beispiel

So senden Sie Ihre Zielgruppendaten ordnungsgemäß von Adobe Experience Platform an die Salesforce CRM Ziel, 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. So ordnen Sie Ihre XDM-Felder korrekt der Salesforce CRM Führen Sie die folgenden Schritte aus:

  1. Im Zuordnung Schritt auswählen Neues Mapping hinzufügen, wird eine neue Zuordnungszeile auf dem Bildschirm angezeigt.
    Screenshot der Platform-Benutzeroberfläche zum Hinzufügen einer neuen Zuordnung.

  2. Im Quellfeld auswählen Fenster, wählen Sie die Identitäts-Namespace auswählen oder Attribute auswählen Kategorie und wählen Sie crmID.
    Screenshot-Beispiel der Platform-Benutzeroberfläche für die Quellzuordnung.

  3. Im Zielgruppenfeld auswählen Fenster, wählen Sie die Identitäts-Namespace auswählen Kategorie und wählen Sie SalesforceId.
    Screenshot der Platform-Benutzeroberfläche mit Target-Zuordnung für SalesforceId.

    • Fügen Sie die folgende Zuordnung zwischen Ihrem XDM-Profilschema und Ihrem Salesforce CRM instance:
    XDM-Profilschema Salesforce CRM Instanz Obligatorisch
    crmID SalesforceId Ja
    • Benutzerdefinierte Attribute auswählen: Wählen Sie diese Option aus, um Ihr Quellfeld einem benutzerdefinierten Attribut zuzuordnen, das Sie in der Variablen Attributname -Feld. Siehe Abschnitt Salesforce CRM Dokumentation für Anleitungen zu unterstützten Attributen.

      Screenshot der Platform-Benutzeroberfläche mit Target-Zuordnung für LastName.

    • Wenn Sie mit Kontakte in Ihrem Segment finden Sie in der Objektreferenz in Salesforce für Kontakt , um Zuordnungen für die zu aktualisierenden Felder zu definieren.

    • Sie können Pflichtfelder identifizieren, indem Sie nach dem Wort suchen Erforderlich, was 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 Ihrem Salesforce CRM instance:

    XDM-Profilschema Salesforce CRM Instanz Anmerkungen
    person.name.lastName LastName Required. Nachname des Kontakts mit bis zu 80 Zeichen.
    person.name.firstName FirstName Vorname des Kontakts mit einer Länge von bis zu 40 Zeichen.
    personalEmail.address Email Die E-Mail-Adresse des Kontakts.
    • Nachfolgend finden Sie ein Beispiel für die Verwendung dieser Zuordnungen:

      Screenshot der Platform-Benutzeroberfläche mit Target-Zuordnungen.

    • Wenn Sie mit Leads in Ihrem Segment finden Sie in der Objektreferenz in Salesforce für Lead , um Zuordnungen für die zu aktualisierenden Felder zu definieren.

    • Sie können Pflichtfelder identifizieren, indem Sie nach dem Wort suchen Erforderlich, was 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 Ihrem Salesforce CRM instance:

    XDM-Profilschema Salesforce CRM Instanz Anmerkungen
    person.name.lastName LastName Required. Nachname des Kontakts mit bis zu 80 Zeichen.
    b2b.companyName Company Required. Die Führung ist dabei.
    personalEmail.address Email Die E-Mail-Adresse des Kontakts.
    • Nachfolgend finden Sie ein Beispiel für die Verwendung dieser Zuordnungen:

      Screenshot der Platform-Benutzeroberfläche mit Target-Zuordnungen.

Segmentexport planen, Beispiel

Bei der Durchführung der Segmentexport planen Schritt müssen Sie Platform-Segmente manuell dem benutzerdefinierten Feldattribut in Salesforce zuordnen.

Wählen Sie dazu jedes Segment aus und geben Sie dann das entsprechende benutzerdefinierte Feldattribut aus Salesforce in das Feld Zuordnungs-ID -Feld.

WICHTIG
  • Der für die Zuordnungs-ID sollte genau mit dem Namen des benutzerdefinierten Feldattributs übereinstimmen, das in Salesforce erstellt wurde.
  • Stellen Sie sicher, dass der Name des von Ihnen in Salesforce erstellten benutzerdefinierten Feldattributs nicht das Leerzeichen verwendet.

Nachfolgend finden Sie ein Beispiel:
Screenshot-Beispiel der Platform-Benutzeroberfläche mit der Option Segmentexport planen .

Datenexport überprüfen

Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:

  1. Auswählen Ziele > Durchsuchen um zur Liste der Ziele zu navigieren.
    Screenshot der Platform-Benutzeroberfläche mit den Browse-Zielen.

  2. Wählen Sie das Ziel aus und überprüfen Sie, ob der Status enabled.
    Screenshot der Platform-Benutzeroberfläche mit dem Ziel-Datenfluss.

  3. Wechseln Sie zu Aktivierungsdaten und wählen Sie einen Segmentnamen aus.
    Screenshot-Beispiel der Platform-Benutzeroberfläche mit Zielen-Aktivierungsdaten.

  4. Überwachen Sie die Segmentzusammenfassung und stellen Sie sicher, dass die Anzahl der Profile der im Segment erstellten Anzahl entspricht.
    Beispiel für einen Screenshot der Platform-Benutzeroberfläche mit Segment.

  5. Melden Sie sich schließlich bei der Salesforce-Website an und überprüfen Sie, ob die Profile aus dem Segment hinzugefügt oder aktualisiert wurden.

    • Wenn Sie Kontakte Navigieren Sie in Ihrem Platform-Segment zu der Apps > Contacts Seite.

      Salesforce CRM-Screenshot mit der Seite Kontakte mit den Profilen aus dem Segment.

    • Wählen Sie eine Kontakt und überprüfen Sie, ob die Felder aktualisiert wurden. Sie können sehen, dass jeder Segmentstatus in Salesforce CRM mit dem entsprechenden Segmentstatus von Platform aktualisiert wurde, basierend auf dem Zuordnungs-ID Wert, der während der Segmentplanung.

      Salesforce CRM-Screenshot mit der Seite Kontaktdetails mit aktualisiertem Segmentstatus.

    • Wenn Sie Leads in Ihrem Platform-Segment und navigieren Sie dann zum Apps > Leads Seite.

      Salesforce CRM-Screenshot mit der Leads-Seite mit den Profilen aus dem Segment.

    • Wählen Sie eine Lead und überprüfen Sie, ob die Felder aktualisiert wurden. Sie können sehen, dass jeder Segmentstatus in Salesforce CRM mit dem entsprechenden Segmentstatus von Platform aktualisiert wurde, basierend auf dem Zuordnungs-ID Wert, der während der Segmentplanung.

      Salesforce CRM-Screenshot mit der Seite Lead-Details mit aktualisiertem Segmentstatus.

Datennutzung und -Governance

Alle Adobe Experience Platform-Ziele sind bei der Verarbeitung Ihrer Daten mit Datennutzungsrichtlinien konform. Detaillierte Informationen zur Adobe Experience Platform erzwingt Data Governance, siehe Data Governance - Übersicht.

Fehler und Fehlerbehebung

Unbekannte Fehler beim Senden von Ereignissen an das Ziel

Wenn Sie beim Überprüfen eines Datenflusses die folgende Fehlermeldung erhalten: Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.

Screenshot der Platform-Benutzeroberfläche mit Fehlermeldung.

Um diesen Fehler zu beheben, überprüfen Sie, ob die Variable Zuordnungs-ID Sie haben Salesforce CRM für Ihr Platform-Segment gültig ist und in Salesforce CRM.

Weitere Ressourcen

Zusätzliche nützliche Informationen aus dem Salesforce-Entwicklerportal unten steht:

Auf dieser Seite