Salesforce Marketing Cloud-Übertragung planen

Mit BigQuery Data Transfer Service für Salesforce Marketing Cloud-Connector können Sie wiederkehrende Ladejobs von Salesforce Marketing Cloud in BigQuery automatisch planen und verwalten.

Hinweise

In den folgenden Abschnitten werden die Schritte beschrieben, die Sie vor dem Erstellen einer Salesforce Marketing Cloud-Übertragung ausführen müssen.

Voraussetzungen für Salesforce Marketing Cloud

Beim Erstellen einer Salesforce Marketing Cloud-Übertragung benötigen Sie folgende Informationen:

Parametername Beschreibung
subdomain API-Subdomain
instance API-Serverinstanz
clientId Die Client-ID der Anwendungsintegration
clientSecret Den Clientschlüssel der App-Integration

In den folgenden Schritten wird gezeigt, wie Sie die Informationen abrufen, die zum Erstellen einer Salesforce Marketing Cloud-Übertragung erforderlich sind:

  1. API-Integrationspaket für Server-zu-Server-Typen installieren Notieren Sie sich die Client-ID, den Clientschlüssel und die Subdomain im Abschnitt Komponenten der Seite mit den Paketdetails.
  2. Suchen Sie in der URL nach Ihrer API-Serverinstanz, nachdem Sie sich bei der Salesforce Marketing Cloud-Anwendung angemeldet haben. Der Instanzwert enthält s, gefolgt von einem numerischen Wert. In der URL https://mc.s4.exacttarget.com/ ist der Instanzwert beispielsweise s4. Weitere Informationen finden Sie unter Stack-Speicherort für ein Marketing Cloud-Konto ermitteln.

Sie müssen außerdem die Einstellungen für die Bereichsberechtigungen konfigurieren, um eine Salesforce Marketing Cloud-Übertragung zuzulassen:

  1. Melden Sie sich in der Salesforce Marketing Cloud-Anwendung an.

  2. Maximieren Sie das Drop-down-Menü für Ihr Profil und klicken Sie auf Einrichtung.

    Klicken Sie in den Salesforce Marketing Cloud-Einstellungen auf "Einrichtung".

  3. Klicken Sie in der Navigationsleiste unter Plattformtools auf Apps > Installierte Pakete.

  4. Wählen Sie ein installiertes Paket aus, um dessen Einstellungen zu ändern.

  5. Klicken Sie im Bereich Komponenten auf Bearbeiten.

  6. Wählen Sie für die folgenden Bereiche die Option Lesen aus:

    • E-Mail
    • Gespeicherte Inhalte
    • Reisen
    • Callbacks
    • Kampagne

  7. Klicken Sie auf Speichern.

Voraussetzungen für BigQuery

Erforderliche BigQuery-Rollen

Bitten Sie Ihren Administrator, Ihnen den IAM-Rolle BigQuery-Administrator (roles/bigquery.admin) zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Erstellen einer Übertragung benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen einer Übertragung erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind zum Erstellen einer Übertragung erforderlich:

  • bigquery.transfers.update für den Nutzer
  • bigquery.datasets.get für das Ziel-Dataset
  • bigquery.datasets.update für das Ziel-Dataset

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Salesforce Marketing Cloud-Datenübertragung einrichten

So erstellen Sie eine Salesforce Marketing Cloud-Datenübertragung:

Console

  1. Rufen Sie in der Google Cloud Console die Seite "BigQuery" auf.

    Zur Seite „BigQuery“

  2. Klicken Sie im Navigationsbereich auf Datenübertragungen > Übertragung erstellen.

  3. Wählen Sie im Abschnitt Source type (Quelltyp) für Source (Quelle) die Option Salesforce Marketing Cloud aus.

  4. Geben Sie im Abschnitt Konfigurationsname für Übertragung für Anzeigename einen Namen für die Übertragung ein.

  5. Führen Sie im Abschnitt Zeitplanoptionen folgende Schritte aus:

    • Wählen Sie in der Liste Wiederholungshäufigkeit aus, wie oft diese Übertragung ausgeführt werden soll. Wenn Sie eine benutzerdefinierte Wiederholungshäufigkeit angeben möchten, wählen Sie Benutzerdefiniert aus. Wenn Sie On-Demand auswählen, wird diese Übertragung ausgeführt, wenn Sie die Übertragung manuell auslösen.

    • Wählen Sie gegebenenfalls Jetzt starten oder Zu festgelegter Zeit starten aus und geben Sie ein Startdatum und eine Laufzeit an.

  6. Wählen Sie im Abschnitt Zieleinstellungen für Dataset das Dataset aus, das Sie zum Speichern Ihrer Daten erstellt haben.

  7. Führen Sie im Abschnitt Details zur Datenquelle folgende Schritte aus:

    • Geben Sie unter API-Subdomain die API-Subdomain ein.
    • Geben Sie für API-Instanz den Wert der API-Instanz ein.
    • Geben Sie unter Client-ID die Client-ID der Anwendungsintegration ein.
    • Geben Sie unter Clientschlüssel den Clientschlüssel der Anwendungsintegration ein.

  8. Wählen Sie im Menü Dienstkonto ein Dienstkonto aus, das Ihrem Google Cloud-Projekt zugeordnet ist. Das ausgewählte Dienstkonto muss die erforderlichen Rollen für diese Übertragung haben.

    Wenn Sie sich mit einer föderierten Identität angemeldet haben, ist ein Dienstkonto zum Erstellen einer Übertragung erforderlich. Wenn Sie sich mit einem Google-Konto angemeldet haben, ist ein Dienstkonto für die Übertragung optional.

    Weitere Informationen zur Verwendung von Dienstkonten mit Datenübertragungen finden Sie unter Dienstkonten verwenden.

  9. Optional: Gehen Sie im Abschnitt Benachrichtigungsoptionen so vor:

    • Klicken Sie zum Aktivieren von E-Mail-Benachrichtigungen auf die Ein/Aus-Schaltfläche E-Mail-Benachrichtigung. Wenn Sie diese Option aktivieren, erhält der Übertragungsadministrator eine E-Mail-Benachrichtigung, wenn eine Übertragung fehlschlägt.
    • Klicken Sie auf die Ein/Aus-Schaltfläche Pub/Sub-Benachrichtigungen, um Pub/Sub-Benachrichtigungen über die Ausführung von Übertragungen für diese Übertragung zu aktivieren. Sie können den Namen für das Thema auswählen oder auf Thema erstellen klicken, um eines zu erstellen.

  10. Klicken Sie auf Speichern.

Wenn diese Übertragung ausgeführt wird, füllt BigQuery Data Transfer Service die folgenden Tabellen automatisch anhand der REST-Schnittstelle aus.

  • Campaigns
  • Categories
  • EventDefinitions
  • Journeys
  • JourneyActivities
  • SendDefinitions
  • Subscriptions

bq

Geben Sie den Befehl bq mk ein und geben Sie das Flag --transfer_config für die Übertragungserstellung an.

bq mk \
    --transfer_config \
    --project_id=PROJECT_ID \
    --data_source=DATA_SOURCE \
    --display_name=DISPLAY_NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

Ersetzen Sie Folgendes:

  • PROJECT_ID (Optional) Ihre Google Cloud-Projekt-ID. Wenn --project_id nicht bereitgestellt wird, um ein bestimmtes Projekt anzugeben, wird das Standardprojekt verwendet.
  • DATA_SOURCE: Die Datenquelle (z. B. saphana).
  • DISPLAY_NAME: Der Anzeigename für die Übertragungskonfiguration. Der Übertragungsname kann ein beliebiger Wert sein, mit dem Sie die Übertragung identifizieren können, wenn Sie sie später ändern müssen.
  • DATASET: Das Ziel-Dataset für die Übertragungskonfiguration.
  • PARAMETERS: die Parameter für die erstellte Übertragungskonfiguration im JSON-Format. Beispiel: --params='{"param":"param_value"}'. Im Folgenden finden Sie die Parameter für eine Salesforce Marketing Cloud-Übertragung:
    • connector.subdomain: Die API-Subdomain.
    • connector.instance: Der Wert der API-Instanz.
    • connector.authentication.oauth.clientId: Der Name der Anwendungs-ID für den OAuth-Client.
    • connector.authentication.oauth.clientSecret: Der Anwendungsschlüssel für den OAuth-Client.

Mit dem folgenden Befehl wird beispielsweise eine Salesforce Marketing Cloud-Übertragung im Standardprojekt mit allen erforderlichen Parametern erstellt:

  bq mk \
      --transfer_config \
      --target_dataset=mydataset \
      --data_source=salesforce_marketing \
      --display_name='My Transfer' \
      --params='{"connector.subdomain": "abcd",
      "connector.instance": "x",
      "connector.authentication.oauth.clientId": "1234567890",
      "connector.authentication.oauth.clientSecret":"ABC12345"}'

API

Verwenden Sie die Methode projects.locations.transferConfigs.create und geben Sie eine Instanz der Ressource TransferConfig an.

Fehler bei der Übertragungseinrichtung beheben

Wenn bei der Einrichtung von Salesforce Marketing Cloud-Übertragungen Probleme auftreten, führen Sie die folgenden Schritte zur Fehlerbehebung aus:

Fehlermeldungen

Fehler: invalid_grant. The client's IP address is unauthorized for this account. Allowlist the client's IP address in Marketing Cloud Administration.

Lösung: Versuchen Sie Folgendes:

  • Aktivieren Sie alle verfügbaren IP-Adressen für Google Cloud-Ressourcen.
  • Deaktivieren Sie die IP-Zulassungsliste. Melden Sie sich dazu bei der Salesforce Marketing Cloud-Anwendung an und rufen Sie die Seite Einrichtung > Sicherheitseinstellungen auf. Klicken Sie auf Bearbeiten und konfigurieren Sie die Einstellung Anmeldungen nach IP-Adresse einschränken (IP-Zulassungsliste) auf IP-Zulassungsliste deaktiviert.

IP-Zulassungsliste deaktivieren

Fehler: INVALID_ARGUMENT. Table tableName does not exist in asset TableName

Lösung: Stellen Sie sicher, dass Sie in der Salesforce Marketing Cloud-Anwendung die richtigen Bereichsberechtigungen konfiguriert haben. Weitere Informationen finden Sie unter Voraussetzungen für Salesforce Marketing Cloud.

Preise

Die Übertragung von Salesforce Marketing Cloud-Daten in BigQuery ist kostenlos, solange sich dieses Feature in der Vorschau befindet.

Nächste Schritte