Loading
CRM Analytics
Salesforce OAuth 2.0-Verbindung für Marketing Cloud Engagement

Sie befinden sich hier:

  1. Salesforce-Hilfe
  2. Dokumente
  3. CRM Analytics

Salesforce OAuth 2.0-Verbindung für Marketing Cloud Engagement

Erstellen Sie mithilfe des OAuth 2.0-Konnektors für Salesforce Marketing Cloud Engagement eine Remote-Verbindung, um Daten aus Engagement mit CRM Analytics zu synchronisieren.

Erstellen der Verbindung

  1. Klicken Sie im Datenmanager auf der Registerkarte "Verbindungen" auf Neue Verbindung.
  2. Klicken Sie auf den Namen des Konnektors und dann auf Weiter.
  3. Geben Sie die Konnektoreinstellungen ein.
  4. Klicken Sie auf Speichern und testen, um Ihre Einstellungen zu validieren und zu versuchen, eine Verbindung mit der Quelle herzustellen. Wenn die Verbindung fehlschlägt, zeigt CRM Analytics mögliche Gründe an.

Für diesen Konnektor sind Marketing Cloud Engagement-Pakete mit einem mandantenspezifischen Endpunkt und ohne OAuth 2.0-Authentifizierung erforderlich. Paketberechtigungen müssen mindestens Folgendes umfassen:

  • Lesen für "List and Subscribers" (Liste und Abonnenten)
  • Lesen und Schreiben für "Data Extensions"
  • Lesen und Schreiben für "Marketing Cloud Connect"
  • Lesen für "Accounts"
  • Lesen für "Benutzer"

Die Sicherheitseinstellungen des Benutzers, den Sie zum Herstellen der Verbindung verwenden, bestimmen die für die Synchronisierung verfügbaren Objekte und Felder.

Alle Einstellungen erfordern einen Wert, sofern nicht anders angegeben.

VerbindungseinstellungBeschreibung
Verbindungsname Identifiziert die Verbindungen. Verwenden Sie eine Konvention, mit der Sie verschiedene Verbindungen auf einfache Weise voneinander unterscheiden können.
Entwicklername Der API-Name der Verbindung. Dieser Name darf keine Leerzeichen enthalten. Der API-Name wird in Ihren Rezepten verwendet, um auf die über diese Verbindung extrahierten Daten zu verweisen. Sie können den Entwicklernamen nicht ändern, nachdem Sie die Verbindung erstellt haben.
Beschreibung Die Beschreibung der Verbindung zur internen Verwendung.
API-Typ Die zu verwendende API. Die Optionen sind SOAP für die SOAP-API oder REST (Standard).
ClientSecret Das Client-Geheimnis von Marketing Cloud Engagement, das zum Generieren eines gültigen Zugriffstokens erforderlich ist.
ClientId Die Client-ID von Marketing Cloud Engagement, die zum Generieren eines gültigen Zugriffstokens erforderlich ist.
Salesforce Marketing Cloud-URL

Der URL, der zum Herstellen der Verbindung mit Marketing Cloud Engagement-WSDL verwendet wird. Ersetzen Sie zum Erstellen des URLs "mcxxx" im Standard-URL https://mcxxx.soap.marketingcloudapis.com/etframework.wsdl durch Ihren Basis-URL. Abrufen des Basis-URLs:

  1. Anmelden bei Marketing Cloud Engagement
  2. Öffnen Sie "Setup".
  3. Klicken Sie auf Plattform-Tools.
  4. Klicken Sie auf Anwendungen.
  5. Klicken Sie auf Installierte Pakete.
  6. Wählen Sie Ihr Zielpaket aus der Liste aus, um die zugehörigen Details zu öffnen. Kopieren Sie den SOAP-Basis-URI aus den Details. Verwenden Sie diesen Wert für REST- oder SOAP-API-Aufrufe.

Wenn Ihr Basis-URL beispielsweise mc7f4m1tsgmxz8862chq5qar2k4q lautet, lautet Ihr Salesforce Marketing Cloud-URL https://mc7f4m1tsgmxz8862chq5qar2k4q.soap.marketingcloudapis.com/etframework.wsdl.
UTC-Verschiebung Optionale Einstellung. Wird zum Lesen von Daten aus Marketing Cloud Engagement in einer Zeitzone mit UTC-Verschiebung verwendet.
Untergeordnete Data Extensions anzeigen Optionale Einstellung. Zeigt die obersten und untergeordneten Business Unit-MID-Informationen im MID-Objekt unter Verwendung des Formats "Parentname_childnameID" an. Die Data Extensions der aktuellen Business Unit werden mit und ohne Suffix angezeigt. Die Daten sind in beiden Fällen identisch.

Filtern von mit CRM Analytics synchronisierten Daten

Mithilfe von Datensynchronisierungsfiltern können Sie nicht benötigte oder sensible Daten ausschließen, sodass sie nicht mit CRM Analytics synchronisiert werden. Filter werden auf das Quellobjekt angewendet und beschleunigen die Datensynchronisierung, indem nur die benötigten Daten in CRM Analytics abgerufen werden.

Hinweis
Hinweis Falls Sie künftig ausgeschlossene Daten verwenden möchten, sollten Sie anstelle eines Datensynchronisierungsfilters einen Rezeptfilter verwenden, um die in einem Datenset gespeicherten Daten zu begrenzen.
  1. Klicken Sie im Datenmanager auf die Registerkarte Verbindungen.
  2. Wählen Sie die Verbindung aus, die dem zu filternden Objekt zugeordnet ist.
  3. Klicken Sie auf den Namen des zu filternden Objekts.
  4. Klicken Sie auf Datensynchronisierungsfilter.
  5. Geben Sie den Filter ein.
  6. Klicken Sie auf Speichern.

Geben Sie für den Marketing Cloud Engagement-OAuth 2.0-Konnektor einen Filter in der SQL-Syntax ein, der der Filterteil-Hilfe entspricht. Filter können boolesche Anweisungen (AND, OR), numerische Vergleiche (>, >=, <, <=) sowie Gleichheits- (=,!=) und LIKE-Operatoren enthalten. Filtern wird nur für SOAP-Objekte unterstützt.

Geben Sie beispielsweise Einträge zurück, bei denen das Feld Name Marc mit dem Filter Name="Marc" lautet. Verwenden Sie diesen Typ einfacher Filter für optimale Leistung und optimale Abfrageantworten. Kombinieren Sie für komplexere Situationen zwei Filterteile mit einem logischen Operator vom Typ AND oder OR, beispielsweise (Name="Marc") AND (Age=57). Sie können Filter auch in Klammern schachteln, beispielsweise (Name="Marc") AND ((Age=57) OR (Age=37)).

Wenn Sie mit Datumswerten filtern möchten, speichern Sie die Datumsdaten in einem von Marketing Cloud unterstützten Format. Beispiel: column_date > '2010-12-31T22:00:00.000Z'

Überlegungen zum OAuth 2.0-Konnektor für Salesforce Marketing Cloud Engagement

Beachten Sie diese Verhaltensweisen, wenn Sie den Salesforce Marketing Cloud Engagement-Konnektor verwenden.

  • Die Namen von verbundenen Objekten müssen mit einem Buchstaben beginnen und dürfen nur Buchstaben, Ziffern oder Unterstriche enthalten. Objektnamen dürfen nicht mit einem Unterstrich enden.
  • Nur Feldnamen mit Kombinationen von alphanumerischen Zeichen, Punkten, Unterstrichen oder Strichen werden unterstützt. Wenn ein Konnektor Feldnamen enthält, die andere Zeichen wie Leerzeichen oder Klammern enthalten, schlägt die Synchronisierung fehl.
  • Der Konnektor kann bis zu 20 Millionen Zeilen oder 10 GB pro Objekt synchronisieren, je nachdem, welche Obergrenze zuerst erreicht wird.
  • Marketing Cloud Engagement-Standardobjekte und benutzerdefinierte Objekte werden unterstützt, sind jedoch möglicherweise aufgrund Ihrer Paketzugriffs- oder Berechtigungskonfiguration nicht verfügbar.
    Hinweis
    Hinweis Das Objekt "JourneyActivities" ist nicht verfügbar.
  • Sie sollten Data Extensions während der Datensynchronisierung nicht überschreiben. Die SOAP-API für Marketing Cloud Engagement kann unvollständige Daten aus einem Lesevorgang für Data Extensions zurückgeben, wenn diese Data Extension gleichzeitig überschrieben wird.
  • Dieser Konnektor kann keine in Marketing Cloud Engagement gespeicherten Daten mit Hexadezimalzeichen (wie 0x1B) lesen und generiert einen Fehler vom Typ HTTP 302. Entfernen Sie alle Hexadezimalwerte, um die Spalte zu integrieren.
  • Bei Marketing Cloud Engagement Data Extensions wird der Text "Ungrouped__" mit einem doppelten Unterstrich am Anfang hinzugefügt. Beispielsweise wird der MC_East der Data Extension als Ungrouped__MC_East angezeigt.
 
Laden
Salesforce Help | Article