(API) Salesforce Marketing Cloud-Verbindung

Übersicht

Salesforce Marketing Cloud (früher bekannt als 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 Marketing Cloud Kontakte aktualisieren API, mit der Sie Kontakte hinzufügen/Kontaktdaten für Ihre geschäftlichen Anforderungen aktualisieren können, nachdem Sie sie in einer neuen aktiviert haben Salesforce Marketing Cloud Segment.

Salesforce Marketing Cloud verwendet OAuth 2 mit Client-Anmeldeinformationen als Authentifizierungsmechanismus für die Kommunikation mit dem Salesforce Marketing Cloud API. Anweisungen zur Authentifizierung bei Ihrem Salesforce Marketing Cloud -Instanz weiter unten im An Ziel authentifizieren Abschnitt.

Anwendungsbeispiele

Um Ihnen zu helfen, besser zu verstehen, wie und wann Sie die Salesforce Marketing Cloud Ziel, hier ein Beispielanwendungsfall, den 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, die dann zum Versand der E-Mail-Adresse der Marketing-Kampagne verwendet werden kann.

Voraussetzungen

Voraussetzungen für die Experience Platform

Vor der Aktivierung der Daten für Salesforce Marketing Cloud Ziel, müssen Sie über eine schema, Datensatzund Segmente erstellt in Experience Platform.

Voraussetzungen in Salesforce Marketing Cloud

Beachten Sie die folgenden Voraussetzungen, um Daten von Platform in Ihre Salesforce Marketing Cloud Konto:

Sie benötigen eine Salesforce Marketing Cloud account

Wenden Sie sich an Ihre Salesforce Account Executive , um sich für die Salesforce Marketing Cloud Account Engagement Produkt, wenn Sie es noch nicht haben.

Erstellen Sie ein benutzerdefiniertes Feld in Salesforce Marketing Cloud

Sie müssen ein benutzerdefiniertes Attribut des Typs Text Area Long, die Experience Platform verwendet, um den Segmentstatus in Salesforce Marketing Cloud. 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.

Siehe Abschnitt Salesforce Marketing Cloud Dokumentation zu 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 bei der Salesforce Marketing Cloud Ziel.

Beschränkungen in Salesforce Marketing Cloud

• Salesforce setzt bestimmte Grenzwerte.
  • Siehe Abschnitt Salesforce Marketing Cloud Dokumentation , um alle möglichen Einschränkungen zu beheben, die bei der Ausführung auftreten könnten, und Fehler zu reduzieren.
  • Siehe Abschnitt Salesforce Marketing Cloud Interaktionskosten 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.
  • Siehe here für eine Seite, die diese Details sortiert.
• Die Anzahl der Benutzerdefinierte Felder pro Objekt zulässig variiert je nach Salesforce Edition.
  • Siehe Abschnitt Salesforce Dokumentation für zusätzliche Leitlinien.
  • Wenn Sie die für Benutzerdefinierte Felder pro Objekt zulässig Innerhalb Salesforce Marketing Cloud Sie müssen
    • Entfernen Sie ältere benutzerdefinierte Felder, bevor Sie neue benutzerdefinierte Felder in hinzufügen. Salesforce Marketing Cloud.
    • Aktualisieren oder entfernen Sie alle Ziele in Platform, die diese älteren benutzerdefinierten Feldnamen als Wert für Zuordnungs-ID während der Segmentplanung Schritt.

Unterstützte Identitäten

Salesforce Marketing Cloud unterstützt die Aktivierung der in der folgenden Tabelle beschriebenen Identitäten. 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.

Within Ziele > Katalog, suchen Sie nach (API) Salesforce Marketing Cloud. Alternativ können Sie sie unter der E-Mail-Marketing Kategorie.

An Ziel authentifizieren

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

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

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.

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

So senden Sie Ihre Zielgruppendaten ordnungsgemäß von Adobe Experience Platform an die Salesforce Marketing Cloud 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 Marketing Cloud Gehen Sie wie folgt vor:

1. Im Zuordnung Schritt auswählen Neues Mapping hinzufügen. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.
   

2. Im Quellfeld auswählen Fenster, wählen Sie die Attribute auswählen Kategorie und wählen Sie contactKey.
   

3. Im Zielgruppenfeld auswählen wählen Sie den Typ des Zielfelds aus, dem Sie Ihr Quellfeld zuordnen möchten.

   • Identitäts-Namespace auswählen: Wählen Sie diese Option aus, um Ihr Quellfeld einem Identitäts-Namespace aus der Liste zuzuordnen.

     

   • Fügen Sie die folgende Zuordnung zwischen Ihrem XDM-Profilschema und Ihrem Salesforce Marketing Cloud instance: |XDM-Profilschema|Salesforce Marketing Cloud Instanz| Erforderlich| |—|—|—| |contactKey|salesforceContactKey| 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 Salesforce Marketing Cloud Dokumentation für eine Liste der unterstützten Attribute. Beachten Sie außerdem, dass das Ziel 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.

     

   • Fügen Sie je nach den Werten, die Sie aktualisieren möchten, beispielsweise die folgende Zuordnung zwischen Ihrem XDM-Profilschema und Ihrem Salesforce Marketing Cloud instance: |XDM-Profilschema|Salesforce Marketing Cloud Instanz| |—|—| |person.name.firstName|Email Demographics.First Name| |personalEmail.address|Email Addresses.Email Address|

   • Nachfolgend finden Sie ein Beispiel für die Verwendung dieser Zuordnungen:

     

Segmentexport planen, Beispiel

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

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. 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 und überprüfen Sie, ob die Attributwerte für das Profil aus dem Segment aktualisiert wurden. Bei Erfolg können Sie sehen, dass jeder Segmentstatus in Salesforce Marketing Cloud mit dem entsprechenden Segmentstatus von Platform aktualisiert wurde, basierend auf dem Zuordnungs-ID Wert, der im Segmentplanung Schritt.
   

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

Beim Überprüfen eines Datenfluss-Ablaufs wird möglicherweise die folgende Fehlermeldung angezeigt: Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.

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

Weitere Ressourcen

• Salesforce Marketing Cloud APIs

Ressourcen für Business.Adobe.com