(API) Salesforce Marketing Cloud-Verbindung

Übersicht

Salesforce Marketing Cloud (ehemals ExactTarget) ist eine Digital-Marketing-Suite, mit der Sie Journey für Besucher und Kunden erstellen und anpassen können, um deren Erlebnis zu personalisieren.

WICHTIG

Beachten Sie den Unterschied zwischen dieser Verbindung und der anderen Salesforce-Marketing Cloud-Verbindung , die im Abschnitt E-Mail-Marketing-Katalog vorhanden ist. Mit der anderen Salesforce-Marketing Cloud-Verbindung können Sie Dateien an einen bestimmten Speicherort exportieren, während es sich hierbei um eine API-basierte Streaming-Verbindung handelt.

Diese Adobe Experience Platform Ziel nutzt die Salesforce-Update kontaktiert REST-API, mit dem Sie Kontakte hinzufügen/Kontaktdaten für Ihre geschäftlichen Anforderungen aktualisieren können, nachdem Sie diese in einem neuen Salesforce-Segment aktiviert haben.

Salesforce Marketing Cloud verwendet OAuth 2 mit Client-Anmeldeinformationen als Authentifizierungsmechanismus für die Kommunikation mit der Salesforce REST API. Anweisungen zur Authentifizierung für Ihre Salesforce-Instanz finden Sie weiter unten im Abschnitt An Ziel authentifizieren Abschnitt.

Anwendungsbeispiele

Damit Sie besser verstehen können, wie und wann Sie das Salesforce-Marketing Cloud-Ziel verwenden sollten, finden Sie hier ein Beispielanwendungsbeispiel, das Adobe Experience Platform-Kunden mit diesem Ziel lösen können.

Senden von E-Mails an Kontakte für Marketingkampagnen

Die Vertriebsabteilung einer Heimmiet-Plattform möchte eine Marketing-E-Mail an eine zielgerichtete Kundenzielgruppe senden. Das Marketing-Team der Plattform kann neue Kontakte hinzufügen/vorhandene Kontakte aktualisieren (und ihre E-Mail-Adressen) Erstellen Sie über Adobe Experience Platform Segmente aus eigenen Offline-Daten und senden Sie diese Segmente an Salesforce Marketing Cloud, das dann zum Senden der E-Mail-Adresse der Marketingkampagne verwendet werden kann.

Voraussetzungen

Voraussetzungen für die Experience Platform

Bevor Sie Daten für das Salesforce-Marketing Cloud-Ziel aktivieren, müssen Sie über eine schema, Datensatzund Segmente erstellt in Experience Platform.

Voraussetzungen in Salesforce CRM

Beachten Sie die folgenden Voraussetzungen in Salesforce, um Daten von Platform in Ihr Salesforce-Marketing Cloud-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.

Benutzerdefiniertes Feld in Salesforce erstellen

Sie müssen ein benutzerdefiniertes Attribut des Typs Text Area Long, die Experience Platform verwendet, um den Segmentstatus im Salesforce-Marketing Cloud zu aktualisieren. Aktivieren Sie im Workflow zum Aktivieren von Segmenten für das Ziel im Segmentplan Schritt, verwenden Sie das benutzerdefinierte Attribut als Zuordnungs-ID für jedes Segment, das Sie aktivieren.

Weitere Informationen finden Sie in der Salesforce-Marketing Cloud-Dokumentation unter Benutzerdefinierte Felder erstellen wenn Sie zusätzliche Anleitungen benötigen.

WICHTIG

Stellen Sie sicher, dass Sie das benutzerdefinierte Attribut unter dem Attributsatz "E-Mail-Demografie"in Ihrem Salesforce-Marketing Cloud-Konto erstellen.

HINWEIS
  • Die Anzahl der pro Objekt zulässigen benutzerdefinierten Attribute variiert je nach Salesforce Edition. Weitere Informationen finden Sie in der Salesforce-Dokumentation für Benutzerdefinierte Felder pro Objekt zulässig wenn Sie zusätzliche Anleitungen benötigen.
  • Wenn Sie diese Grenze in Salesforce erreicht haben, müssen Sie das benutzerdefinierte Attribut aus Salesforce entfernen, das zum Speichern des Segmentstatus für ältere Segmente in Experience Platform verwendet wurde, bevor eine neue mappingId verwendet werden kann.

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 beim Salesforce-Marketing Cloud-Ziel authentifizieren.

Anmeldedaten Beschreibung Beispiel
  • Salesforce-Marketing Cloud-Präfix
Siehe Salesforce-Marketing Cloud-Domänenpräfix für zusätzliche Leitlinien.
  • Wenn Ihre Domäne wie folgt lautet, benötigen Sie den hervorgehobenen Wert.
    mcq4jrssqdlyc4lph19nnqgzzs84.login.executeTarget.com
  • Client-ID
  • Client-Geheimnis
Siehe Abschnitt Salesforce-Dokumentation wenn Sie zusätzliche Anleitungen benötigen.
  • r23kxxxxxxxx0z05xxxxxx
  • ipxxxxxxxxxxT4xxxxxxxxxxxx

Unterstützte Identitäten

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

Zielgruppenidentität Beschreibung Zu beachten
contactKey Salesforce-Kontaktschlüssel. Siehe Abschnitt Salesforce-Dokumentation wenn Sie zusätzliche Anleitungen benötigen. 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), wie im Bildschirm Profilattribute im Zielaktivierungs-Workflow.
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.

Katalog

An Ziel authentifizieren

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

Beispiel-Screenshot mit der Authentifizierung beim Salesforce-Marketing Cloud

  • Subdomain: Ihr Salesforce-Marketing Cloud-Domänenpräfix. Beispiel: Ihre Domäne mcq4jrssqdlyc4lph19nnqgzzs84.login.executeTarget.com benötigen Sie den hervorgehobenen Wert.
  • Client-ID: Ihre Salesforce-Client-ID.
  • Client Secret: Ihr Salesforce-Client-Geheimnis.

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.

Beispiel-Screenshot zum Ausfüllen von Details für Salesforce-Marketing Cloud

  • 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.
  • Kundenname: Dies kann ein beliebiger Wert sein, ein Wert ist jedoch obligatorisch. Andernfalls schlägt die Zielaktivierung fehl.

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

Um Ihre Zielgruppendaten korrekt von Adobe Experience Platform an das Salesforce Marketing Cloud-Ziel zu senden, müssen Sie den Feldzuordnungsschritt 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. Gehen Sie wie folgt vor, um Ihre XDM-Felder korrekt den Salesforce-Marketing Cloud-Zielfeldern zuzuordnen.

Die Liste der Attribut-Mappings, die für die Salesforce REST API ist unten angegeben. Das Ziel verwendet die Salesforce Search Attribute-Set Definitions REST API um Attribute abzurufen, die in Salesforce für Ihre Kontakte definiert sind und speziell für Ihr Konto gelten.

WICHTIG

Obwohl Ihre Attributnamen gemäß Ihrem Salesforce-Konto übereinstimmen, werden die Zuordnungen für contactKey und personalEmail.address sind zwingend erforderlich.

  1. Klicken Sie im Schritt "Zuordnung"auf Neues Mapping hinzufügen. Auf dem Bildschirm wird jetzt eine neue Zuordnungszeile angezeigt.
    Neue Zuordnung hinzufügen

  2. Wählen Sie im Fenster Quellfeld auswählen bei der Auswahl des Quellfelds die Attribute auswählen und fügen Sie die gewünschten Zuordnungen hinzu.
    Quellzuordnung

  3. Wählen Sie im Fenster Zielfeld auswählen das Zielfeld aus und wählen Sie die Identitäts-Namespace auswählen und fügen Sie die gewünschten Zuordnungen hinzu.
    Zielgruppenzuordnung

  4. Um benutzerdefinierte Attribute zuzuordnen, wählen Sie das Zielfeld-Fenster aus, wählen Sie das Zielfeld aus und wählen Sie die Attribute auswählen > Email Demographic Kategorie. Geben Sie als Nächstes den gewünschten Zielattribut-Namen ein und fügen Sie die gewünschten Zuordnungen hinzu.
    Zielgruppenzuordnung

  5. Sie können beispielsweise die folgende Zuordnung zwischen Ihrem XDM-Profilschema und Ihrem Salesforce Marketing Cloud instance:

    XDM-Profilschema Salesforce Marketing Cloud Instanz Obligatorisch
    Attribute
    • person.name.firstName
    • personalEmail.address
    • Email Demography.First Name
    • E-Mail-Adressen.E-Mail-Adresse
    • Ja
    Identitäten
    • contactKey
    • salesforceContactKey
    Ja
  6. Nachfolgend finden Sie ein Beispiel für die Verwendung dieser Zuordnungen:
    Target-Zuordnung - Nachname

Segmentexport planen, Beispiel

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

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

WICHTIG

Der für die Zuordnungs-ID verwendete Wert sollte genau mit dem Namen des benutzerdefinierten Attributs übereinstimmen, das in Salesforce unter dem Attributsatz "E-Mail-Demografie"erstellt wurde.

Nachfolgend finden Sie ein Beispiel:
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.

    Ziele durchsuchen

  2. Wählen Sie das Ziel aus und überprüfen Sie, ob der Status enabled.

    Ziel-Datenfluss

  3. Wechseln Sie zu Activation data und wählen Sie einen Segmentnamen aus.

    Zielaktivierungsdaten

  4. Überwachen Sie die Segmentzusammenfassung und stellen Sie sicher, dass die Anzahl der Profile der im Segment erstellten Anzahl entspricht.

    Segment

  5. Melden Sie sich bei der Salesforce Marketing Cloud-Website an. Navigieren Sie dann zum Audience Builder > Contact Builder > All contacts > Email und überprüfen Sie, ob die Profile aus dem Segment hinzugefügt wurden.

    Salesforce-Kontakte

  6. Um zu überprüfen, ob Profile aktualisiert wurden, navigieren Sie zum Email Seitenüberprüfung, ob die Attributwerte für das Profil aus dem Segment aktualisiert wurden.

    Salesforce-Kontakte

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 Salesforce-Marketing Cloud

Wenn Sie die Ausführung eines Datenflusses überprüfen, überprüfen Sie, ob die von Ihnen unter Salesforce CRM für Ihr Platform-Segment gültig ist und in Salesforce CRM.
Fehler

Weitere Ressourcen

Beschränkungen

Auf dieser Seite