(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.

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.

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.

Unterstützte Identitäten

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

Exportart und -frequenz

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

Herstellen einer Verbindung mit der Datenbank

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.

An Ziel authentifizieren

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

• 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.

• 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

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.

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

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.
   

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.
   

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.
   

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:
   

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.

Nachfolgend finden Sie ein Beispiel:

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.

   

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

   

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

   

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

   

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.

   

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.

   

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.

Weitere Ressourcen

• Salesforce-Entwicklerportal

Beschränkungen

• Salesforce setzt bestimmte Grenzwerte.
• Siehe Abschnitt Ratenbeschränkungen-Fehler , um eventuelle Fehler zu überprüfen.
• Siehe Abschnitt Salesforce Marketing Cloud Interaktionspreise Seite zu Vollständige Vergleichstabelle herunterladen als pdf , in dem die durch Ihren Plan festgelegten Grenzen beschrieben werden.
• Die API-Übersicht Seite enthält zusätzliche Einschränkungen.
• Ein KB-Element, das diese Details sortiert, ist verfügbar here.

Business.Adobe.com - Ressourcen