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

WICHTIG

Beachten Sie den Unterschied zwischen dieser Verbindung und der anderen Salesforce Marketing Cloud connection , 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 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.

WICHTIG

Stellen Sie sicher, dass Sie das benutzerdefinierte Attribut unter dem Email Demographics -Attribut in Ihrer Salesforce Marketing Cloud -Konto.

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.

Anmeldedaten Beschreibung Beispiel
  • Salesforce Marketing Cloud prefix
Siehe Salesforce Marketing Cloud domain prefix 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 Marketing Cloud Dokumentation wenn Sie zusätzliche Anleitungen benötigen.
  • r23kxxxxxxxx0z05xxxxxx
  • ipxxxxxxxxxxT4xxxxxxxxxxxx

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.

Zielgruppenidentität Beschreibung Zu beachten
contactKey Salesforce Marketing Cloud Kontaktschlüssel. Siehe Abschnitt Salesforce Marketing Cloud 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), entsprechend Ihrer Feldzuordnung.
  • Jeder Segmentstatus in Salesforce Marketing Cloud 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 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.
Screenshot der Platform-Benutzeroberfläche, in dem gezeigt wird, wie die Authentifizierung für das Salesforce-Marketing Cloud erfolgt.

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

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 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:

WICHTIG

Auch wenn Ihre Attributnamen gemäß Ihrer Salesforce Marketing Cloud -Konto, die Zuordnungen für beide contactKey und personalEmail.address sind zwingend erforderlich.

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

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

  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.

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

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

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

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

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

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:
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 Activation data 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 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.
    Screenshot der Salesforce Marketing Cloud-Benutzeroberfläche mit der Kontaktseite mit den im Segment verwendeten Profilen.

  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.
    Screenshot der Salesforce Marketing Cloud-Benutzeroberfläche mit der ausgewählten Kontakts-E-Mail-Seite 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 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.

Screenshot der Platform-Benutzeroberfläche mit Fehlermeldung.

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

Auf dieser Seite