(API) Salesforce Marketing Cloud-Verbindung

Übersicht

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

Im Vergleich zu Salesforce Marketing Cloud Account Engagement die stärker auf B2B Marketing, (API) Salesforce Marketing Cloud Das Ziel ist ideal für B2C Anwendungsfälle mit kürzeren Transaktionsentscheidungen-Zyklen. Sie können größere Datensätze, die das Verhalten Ihrer Zielgruppe repräsentieren, zusammenfassen, um Marketing-Kampagnen anzupassen und zu verbessern, indem Sie Kontakte priorisieren und segmentieren, insbesondere aus Datensätzen außerhalb von Salesforce. Beachten Sie, dass Experience Platform auch eine Verbindung für die Salesforce Marketing Cloud Account Engagement.

Diese Adobe Experience Platform Ziel nutzt die Salesforce Marketing Cloud Kontakte aktualisieren API, mit der Sie Hinzufügen von Kontakten und Aktualisieren von Kontaktdaten für Ihre Geschäftsanforderungen, nachdem Sie sie in einer neuen 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 Ihrer Salesforce Marketing Cloud-Instanz sehen Sie weiter unten im Abschnitt Authentifizieren bei Ziel.

Anwendungsfälle

Damit Sie besser verstehen können, wie und wann Sie das (API) Salesforce Marketing Cloud-Ziel verwenden sollten, finden Sie hier ein Anwendungsbeispiel, das für Kundinnen und Kunden von Adobe Experience Platform mit diesem Ziel geeignet ist.

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 das (API) Salesforce Marketing Cloud-Ziel müssen Sie über ein Schema, einen Datensatz und Segmente verfügen, die in Experience Platform erstellt wurden.

Voraussetzungen in (API) Salesforce Marketing Cloud

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

Sie benötigen ein Salesforce Marketing Cloud-Konto

A Salesforce Marketing Cloud -Konto mit einem Abonnement für Marketing Cloud Engagement Das Produkt ist für den Fortgang des Verfahrens obligatorisch.

Wenden Sie sich an Salesforce Support wenn Sie keine Salesforce Marketing Cloud oder Ihr Konto fehlt, Marketing Cloud Engagement Produktabonnement.

Erstellen von Attributen in Salesforce Marketing Cloud

Beim Aktivieren von Segmenten für (API) Salesforce Marketing Cloud Ziel, müssen Sie einen Wert in die Zuordnungs-ID -Feld für jedes aktivierte Segment im Segmentplan Schritt.

Salesforce erfordert, dass dieser Wert Segmente aus Experience Platform korrekt liest und interpretiert und ihr Segmentstatus in Salesforce Marketing Cloud. Weitere Informationen finden Sie in der Dokumentation zur Experience Platform für Feldergruppe Segmentzugehörigkeitsdetails , wenn Sie Anleitungen zum Segmentstatus benötigen.

Für jedes Segment, das Sie von Platform in aktivieren Salesforce Marketing Cloud, müssen Sie ein Attribut des Typs Text Innerhalb Salesforce. Verwenden Sie die Salesforce Marketing Cloud Contact Builder , um Attribute zu erstellen. Die Attributfeldnamen werden für die (API) Salesforce Marketing Cloud Zielfeld und sollte unter dem Email Demographics system attribute-set. Je nach Ihren Geschäftsanforderungen können Sie das Feldzeichen mit maximal 4000 Zeichen definieren. Siehe Salesforce Marketing Cloud Datentypen für Datenerweiterungen Dokumentationsseite für weitere Informationen zu Attributtypen.

Siehe Abschnitt Salesforce Marketing Cloud Dokumentation zu Attribute erstellen , wenn Sie Anleitungen zum Erstellen von Attributen benötigen.

Ein Beispiel für den Data Designer-Bildschirm in Salesforce Marketing Cloud, zu dem Sie das Attribut hinzufügen werden, sehen Sie wie folgt:

Ansicht der Salesforce Marketing Cloud Email Demographics attribute-set ist unten dargestellt:

Die (API) Salesforce Marketing Cloud Das Ziel verwendet Salesforce Marketing Cloud Search Attribute-Set Definitions REST API dynamisch die Attribute und ihre Attribute-Sets abrufen, die in Salesforce Marketing Cloud.

Diese werden im Zielfeld Auswahlfenster bei der Einrichtung Mapping im Workflow zu Aktivieren von Segmenten für das Ziel. Beachten Sie, dass nur Zuordnungen für die Attribute erstellt werden, die innerhalb der Variablen Salesforce Marketing Cloud Email Demographics -Attributsätze unterstützt.

Ein Beispiel für die Attributerstellung in Salesforce Marketing Cloud, wie unten gezeigt:

Weisen Sie Benutzerrollen und Berechtigungen innerhalb von zu Salesforce Marketing Cloud

As Salesforce Marketing Cloud unterstützt benutzerdefinierte Rollen je nach Anwendungsfall. Ihrem Benutzer sollten die entsprechenden Rollen zugewiesen werden, um Ihre Attribute in Ihren Salesforce Marketing Cloud Attributsätzen. Nachfolgend finden Sie ein Beispiel für Benutzerrollen:

Welche Rollen Ihre Salesforce Marketing Cloud Benutzer zugewiesen wurde, müssen Sie außerdem Berechtigungen für Salesforce Marketing Cloud -Attributsätzen, die die zu aktualisierenden Felder enthalten.

Da dieses Ziel Zugriff auf die Email Demographics system attribute-set, müssen Sie Email wie unten gezeigt:

Um die Zugriffsebene zu beschränken, können Sie auch einzelne Zugriffe durch Verwendung granularer Berechtigungen überschreiben.

Siehe Abschnitt Marketing Cloud Roles und Marketing Cloud Roles and Permissions Seiten für ausführliche Anleitungen.

Sammeln von Salesforce Marketing Cloud-Anmeldeinformationen

Beachten Sie die folgenden Elemente, bevor Sie sich bei der (API) Salesforce Marketing Cloud Ziel.

Leitplanken

• 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
    • Ältere Attribute vor dem Hinzufügen neuer Attribute in Salesforce Marketing Cloud.
    • Aktualisieren oder entfernen Sie aktivierte Segmente in Platform-Zielen, die diese älteren Attributnamen als Wert für Zuordnungs-ID während der Segmentplanung Schritt.

Unterstützte Identitäten

(API) Salesforce Marketing Cloud unterstützt die Aktualisierung von Identitäten, die in der folgenden Tabelle beschrieben werden. Erhalten Sie weitere Informationen zu Identitäten.

Exporttyp und -häufigkeit

Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.

Herstellen einer Verbindung mit dem Ziel

Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im 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.

Beim Ziel authentifizieren

Um sich beim Ziel zu authentifizieren, füllen Sie die erforderlichen Felder unten aus und wählen Sie Mit Ziel verbinden. Eine Anleitung dazu finden Sie im Abschnitt Salesforce Marketing Cloud Sammeln von -Anmeldeinformationen.

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.

Ausfüllen der Zieldetails

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, durch den Sie dieses Ziel in Zukunft erkennen können.
• Beschreibung: Eine Beschreibung, die Ihnen hilft, dieses Ziel in Zukunft zu identifizieren.

Aktivieren von Warnhinweisen

Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem 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 Warnhinweisen finden Sie im Handbuch zum Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.

Wenn Sie mit dem Eingeben der Details für Ihre Zielverbindung fertig sind, klicken Sie auf Weiter.

Aktivieren von Segmenten für dieses Ziel

Anweisungen zum Aktivieren von Zielgruppensegmenten für dieses Ziel finden Sie unter Aktivieren von Profilen und Segmenten für Streaming-Segmentexportziele.

Zuordnungsüberlegungen und Beispiel

Um Ihre Zielgruppendaten ordnungsgemäß von Adobe Experience Platform an das (API) Salesforce Marketing Cloud-Ziel zu senden, müssen Sie den Schritt zur Feldzuordnung durchlaufen. Die Zuordnung besteht darin, eine Verknüpfung zwischen den Schemafeldern Ihres Experience-Datenmodells (XDM) in Ihrem Platform-Konto und den jeweiligen Entsprechungen vom Ziel zu erstellen.

So ordnen Sie Ihre XDM-Felder korrekt der (API) Salesforce Marketing Cloud Gehen Sie wie folgt vor:

1. Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.
   

2. Im Quellfeld auswählen Fenster, wählen Sie die Attribute auswählen und wählen Sie das XDM-Attribut aus oder wählen Sie die Identitäts-Namespace auswählen und wählen Sie eine Identität aus.

3. Im Zielgruppenfeld auswählen Fenster, wählen Sie die Identitäts-Namespace auswählen und wählen Sie eine Identität oder Benutzerdefinierte Attribute auswählen und wählen Sie ein Attribut aus der Email Demographics -Attribute nach Bedarf angezeigt werden. Die (API) Salesforce Marketing Cloud Das Ziel verwendet Salesforce Marketing Cloud Search Attribute-Set Definitions REST API dynamisch die Attribute und ihre in Salesforce Marketing Cloud. Diese werden im Zielfeld Popup bei der Einrichtung der Mapping im Aktivieren von Segmenten für den Workflow. Beachten Sie, dass nur Zuordnungen für die Attribute erstellt werden, die innerhalb der Variablen Salesforce Marketing Cloud Email Demographics -Attributsätze unterstützt.

   • Wiederholen Sie diese Schritte, um die folgenden Zuordnungen zwischen Ihrem XDM-Profilschema und (API) Salesforce Marketing Cloud: |Quellfeld|Zielfeld| Erforderlich| |—|—|—| |IdentityMap: contactKey|Identity: salesforceContactKey| Mandatory |\

     |xdm: person.name.firstName|Attribute: Email Demographics.First Name| - |
     |xdm: personalEmail.address|Attribute: Email Addresses.Email Address| - |

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

     

Wenn Sie die Zuordnungen für Ihre Zielverbindung bereitgestellt haben, wählen Sie Nächste.

Planen des Segmentexports und Beispiel

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

Wählen Sie dazu jedes Segment aus und geben Sie dann den Namen des Attributs aus Salesforce Marketing Cloud im (API) Salesforce Marketing Cloud Zuordnungs-ID -Feld. Siehe Abschnitt Attribut erstellen in Salesforce Marketing Cloud Abschnitt mit Anleitungen und Best Practices zum Erstellen von Attributen in Salesforce Marketing Cloud.

Wenn beispielsweise Ihre Salesforce Marketing Cloud Attribut ist salesforce_mc_segment_1, geben Sie diesen Wert in der (API) Salesforce Marketing Cloud Zuordnungs-ID , um Segmentzielgruppen aus Experience Platform in dieses Attribut zu füllen.

Ein Beispielattribut aus Salesforce Marketing Cloud ist unten dargestellt:

Ein Beispiel, das die Position der (API) Salesforce Marketing Cloud Zuordnungs-ID ist unten dargestellt:

Wie gezeigt, (API) Salesforce Marketing Cloud Zuordnungs-ID sollte genau mit dem Wert übereinstimmen, der in Salesforce Marketing Cloud FELDNAME.

Wiederholen Sie diesen Abschnitt für jedes aktivierte Platform-Segment.

Je nach Anwendungsfall können alle aktivierten Segmente demselben Salesforce Marketing Cloud FELDNAME oder anderen FELDNAME in (API) Salesforce Marketing Cloud. Ein typisches Beispiel, das auf dem oben gezeigten Bild basiert, könnte sein.
| (API) Salesforce Marketing Cloud Segmentname | Salesforce Marketing Cloud FELDNAME | (API) Salesforce Marketing Cloud Zuordnungs-ID | | — | — | — | | Salesforce mc Segment 1 | salesforce_mc_segment_1 | salesforce_mc_segment_1 | | Salesforce mc Segment 2 | salesforce_mc_segment_2 | salesforce_mc_segment_2 |

Überprüfen des Datenexports

Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:

1. Wählen Sie Ziele > Durchsuchen aus, um zur Liste der Ziele zu navigieren.
   

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

3. Wechseln Sie zur Registerkarte 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. Ausführliche Informationen darüber, wie Adobe Experience Platform Data Governance erzwingt, finden Sie unter 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 im Aktivierungs-Workflow für das (API) Salesforce Marketing Cloud Das Ziel stimmt genau mit dem Namen des Attributs überein, das Sie in Salesforce Marketing Cloud. Siehe Abschnitt Attribut erstellen in Salesforce Marketing Cloud für Hinweise.

• Beim Aktivieren eines Segments erhalten Sie möglicherweise eine Fehlermeldung: The client's IP address is unauthorized for this account. Allowlist the client's IP address...

  • Wenden Sie sich zur Behebung dieses Fehlers an Ihren Salesforce Marketing Cloud Kontoadministrator zum Hinzufügen IP-Adressen der Experience Platform auf Salesforce Marketing Cloud Vertrauenswürdige IP-Bereiche der Konten. Siehe Abschnitt Salesforce Marketing Cloud IP-Adressen für die Einbindung in Zulassungslisten in Marketing Cloud Dokumentation, wenn Sie zusätzliche Anleitungen benötigen.

Zusätzliche Ressourcen

• Salesforce Marketing Cloud API
• Salesforce Marketing Cloud Dokumentation Erläuterung der Aktualisierung von Kontakten mit den in den angegebenen Attributgruppen angegebenen Informationen.

Änderungsprotokoll

In diesem Abschnitt werden die Funktionen und wesentlichen Aktualisierungen der Dokumentation an diesem Ziel-Connector erfasst.

Ressourcen für Business.Adobe.com