Salesforce Marketing Cloud verbinden

Mit der Salesforce-Marketing-Cloud-Integration wird jede Person, die sich anmeldet, in Marketing Cloud als Kontakt angelegt oder aktualisiert, mit der E-Mail-Adresse als Contact Key. Bei der Einrichtung hilft in der Regel Ihr Salesforce-Administrator.

Was Sie brauchen

• Ein Salesforce-Marketing-Cloud-Konto und einen Benutzer mit Zugriff auf Setup > Installed Packages (meist ein Marketing-Cloud-Administrator).
• Einen Scratcher-Plan, der alle nativen Integrationen enthält. Ist der Button gesperrt, siehe Ihre Testphase, die Pläne und was nach dem Ende der Testphase passiert.

Schritt 1: API-Zugangsdaten in Marketing Cloud erstellen

1. Öffnen Sie in Marketing Cloud Setup (im Menü unter Ihrem Namen).
2. Gehen Sie zu Apps > Installed Packages und klicken Sie auf New. Geben Sie dem Paket einen Namen, zum Beispiel „Scratcher“, und speichern Sie.
3. Klicken Sie auf Add Component, wählen Sie API Integration und dann Server-to-Server.
4. Setzen Sie die unten aufgeführten Berechtigungen und speichern Sie.
5. Öffnen Sie die Komponente. Kopieren Sie Client Id, Client Secret, Authentication Base URI und REST Base URI.
6. Stellen Sie sicher, dass das Paket Zugriff auf die Business Unit hat, in der die Kontakte landen sollen (unter Access im Paket).
7. Suchen Sie den External Key der Data Extension, die Ihr Team für Scratcher-Leads nutzt. Öffnen Sie die Data Extension in Contact Builder oder Email Studio und kopieren Sie ihren External Key.

Berechtigungen, die das Paket braucht

Scratcher fragt bei Marketing Cloud genau diese Berechtigungen an, die Komponente muss sie also erlauben:

• Contacts > List and Subscribers: Read und Write. Um Kontakte per E-Mail zu finden und sie anzulegen oder zu aktualisieren.
• Data > Data Extensions: Write.

Mehr ist nicht nötig.

Schritt 2: Mit Scratcher verbinden

1. Gehen Sie in Scratcher zu Einstellungen > Integrationen und klicken Sie auf Salesforce Marketing Cloud.
2. Füllen Sie die Felder aus:
   • Auth Base URL: die Authentication Base URI, zum Beispiel https://xxxx.auth.marketingcloudapis.com.
   • Rest Base URL: die REST Base URI, zum Beispiel https://xxxx.rest.marketingcloudapis.com.
   • Client ID und Client Secret.
   • Data extension id: der External Key aus Schritt 1.
3. Klicken Sie auf Integration installieren. Scratcher meldet sich bei Marketing Cloud an, um die Angaben zu prüfen.

Beide URLs müssen API-Adressen von Marketing Cloud sein (endend auf marketingcloudapis.com). Andere Adressen werden abgelehnt.

Schritt 3: In einer Kampagne aktivieren

1. Gehen Sie im Editor zu Verbinden > Integrationen > Salesforce Marketing Cloud und klicken Sie auf Aktivieren.
2. Wenn Sie mehr als ein Konto verbunden haben, wählen Sie es unter Konto auswählen.
3. Klicken Sie unter Feldzuordnungen auf Feldzuordnung hinzufügen, wählen Sie das Scratcher-Feld und geben Sie unter Name des externen Felds den Namen des Attributs in Marketing Cloud ein.
4. Wählen Sie bei Bedarf unter Nach Einwilligungen filtern (optional) Ihre Einwilligungs-Checkbox.
5. Klicken Sie auf Speichern und dann auf Testen.

Gut zu wissen: Es gibt keine Liste zu wählen. Scratcher beginnt also zu senden, sobald Sie auf Aktivieren klicken. Aktivieren Sie die Integration, bevor die Kampagne live geht, oder richten Sie die Zuordnungen sofort ein.

Was gesendet wird

• Die E-Mail-Adresse dient als Contact Key und wird im Attribute Set Email Addresses gespeichert, mit aktivierten HTML-E-Mails.
• Vor- und Nachname aus Ihrem Formular werden in Email Demographics gespeichert.
• Ihre zugeordneten Felder werden im Attribute Set Custom Data gespeichert, mit den Namen, die Sie eingegeben haben. Bitten Sie Ihren Administrator, dieses Attribute Set in Contact Builder mit passenden Attributnamen anzulegen.

Neue Anmeldungen werden innerhalb von ein, zwei Minuten gesendet, die bestehenden Leads der Kampagne beim Aktivieren.

Fehlerbehebung

• „Einige oder alle Felder sind ungültig. Die Integration konnte die Felder nicht validieren.“ bei der Installation: Prüfen Sie die beiden URLs, Client-ID und Secret, und ob das Paket die oben genannten Berechtigungen hat.
• Zustellungen schlagen mit einem unbekannten Attribut fehl: Ein Name des externen Felds passt zu keinem Attribut in Custom Data. Korrigieren Sie den Namen oder legen Sie das Attribut an.
• „The Salesforce Marketing Cloud urls must be marketingcloudapis.com addresses.“: Installieren Sie die Integration mit den richtigen URLs erneut.

Brauchen Sie eine tiefere Anbindung an Salesforce, etwa an die Sales Cloud? In Enterprise-Plänen können wir sie mit Ihnen bauen. Buchen Sie einen Termin.