Caricare i dati di Salesforce Marketing Cloud in BigQuery

Puoi caricare i dati da Salesforce Marketing Cloud a BigQuery utilizzando il connettore BigQuery Data Transfer Service per Salesforce Marketing Cloud. Con BigQuery Data Transfer Service, puoi pianificare job di trasferimento ricorrenti che aggiungono i dati più recenti di Salesforce Marketing Cloud a BigQuery.

Limitazioni

I trasferimenti di dati di Salesforce Marketing Cloud sono soggetti alle seguenti limitazioni:

  • Se l'attestazione di rete e l'istanza di macchina virtuale (VM) configurate si trovano in regioni diverse, potrebbe verificarsi uno spostamento di dati tra regioni quando trasferisci dati da Salesforce Marketing Cloud.

Prima di iniziare

Le sezioni seguenti descrivono i passaggi da seguire prima di creare un trasferimento di dati di Salesforce Marketing Cloud.

Prerequisiti per Salesforce Marketing Cloud

Quando crei un trasferimento di dati di Salesforce Marketing Cloud, devi disporre delle seguenti informazioni:

Nome parametro Descrizione
subdomain Il sottodominio API
instance L'istanza del server API
clientId L'ID client dell'integrazione dell'app
clientSecret Il client secret dell'integrazione dell'app

I seguenti passaggi mostrano come ottenere le informazioni necessarie per creare un trasferimento di dati Salesforce Marketing Cloud:

  1. Installa un pacchetto di integrazione API di tipo server-to-server. Prendi nota dell'ID client, del client secret e del sottodominio nella sezione Componenti della pagina dei dettagli del pacchetto.
  2. Trova l'istanza del server API nell'URL dopo aver eseguito l'accesso all'applicazione Salesforce Marketing Cloud. Il valore dell'istanza include s seguito da un valore numerico. Ad esempio, nell'URL https://mc.s4.exacttarget.com/, il valore dell'istanza è s4. Per maggiori informazioni, consulta Trovare la posizione dello stack per un account Marketing Cloud.

Devi anche configurare le impostazioni delle autorizzazioni di ambito per consentire un trasferimento di dati Salesforce Marketing Cloud:

  1. Accedi all'applicazione Salesforce Marketing Cloud.

  2. Espandi il menu a discesa del profilo, quindi fai clic su Configurazione.

    Fai clic su Configurazione nelle impostazioni di Salesforce Marketing Cloud

  3. Nella barra di navigazione in Strumenti della piattaforma, fai clic su App > Pacchetti installati.

  4. Seleziona un pacchetto installato per modificarne le impostazioni.

  5. Nella sezione Componenti, fai clic su Modifica.

  6. Seleziona l'opzione Lettura per i seguenti ambiti:

    • Email
    • Contenuti salvati
    • Percorsi
    • Callback
    • Campagna
    • Abbonamenti

  7. Fai clic su Salva.

Prerequisiti di BigQuery

Ruoli BigQuery richiesti

Per ottenere le autorizzazioni necessarie per creare un trasferimento, chiedi all'amministratore di concederti il ruolo IAM BigQuery Admin (roles/bigquery.admin). Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un trasferimento sono necessarie le seguenti autorizzazioni:

  • bigquery.transfers.update sull'utente
  • bigquery.datasets.get sul set di dati di destinazione
  • bigquery.datasets.update sul set di dati di destinazione

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Configura un trasferimento di dati di Salesforce Marketing Cloud

Per creare un trasferimento di dati di Salesforce Marketing Cloud:

Console

  1. Vai alla pagina Trasferimenti di dati nella console Google Cloud .

    Vai a Trasferimenti dati

  2. Fai clic su Crea trasferimento.

  3. Nella sezione Tipo di origine, per Origine, seleziona Salesforce Marketing Cloud.

  4. Nella sezione Dettagli origine dati, segui questi passaggi:

    • Per Sottodominio API, inserisci il sottodominio dell'API.
    • Per Istanza API, inserisci il valore dell'istanza API.
    • Per ID client, inserisci l'ID client dell'integrazione dell'app.
    • Per Client secret, inserisci il client secret dell'integrazione dell'app.

  5. Nella sezione Impostazioni destinazione, per Set di dati, seleziona il set di dati che hai creato per archiviare i dati.

  6. Nella sezione Nome configurazione di trasferimento, per Nome visualizzato, inserisci un nome per il trasferimento di dati.

  7. Nella sezione Opzioni di pianificazione, segui questi passaggi:

    • Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la frequenza con cui viene eseguito questo trasferimento di dati. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzata. Se selezioni On demand, l'esecuzione avviene quando attivi manualmente il trasferimento.
    • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e fornisci una data di inizio e un'ora di esecuzione.

  8. (Facoltativo) Nella sezione Opzioni di notifica, segui questi passaggi:

    • Per attivare le notifiche via email, fai clic sul pulsante di attivazione/disattivazione Notifica email. Quando attivi questa opzione, l'amministratore del trasferimento riceve una notifica via email quando l'esecuzione di un trasferimento non riesce.
    • Per attivare le notifiche di esecuzione del trasferimento Pub/Sub per questo trasferimento, fai clic sul pulsante di attivazione/disattivazione Notifiche Pub/Sub. Puoi selezionare il nome del tuo argomento oppure fare clic su Crea un argomento per crearne uno.

  9. Fai clic su Salva.

Quando viene eseguito questo trasferimento di dati, BigQuery Data Transfer Service compila automaticamente le seguenti tabelle in base all'interfaccia REST.

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

bq

Inserisci il comando bq mk e fornisci il flag di creazione del trasferimento: --transfer_config.

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

Sostituisci quanto segue:

  • (Facoltativo) PROJECT_ID: il tuo ID progetto Google Cloud . Se non viene fornito --project_id per specificare un progetto particolare, viene utilizzato il progetto predefinito.
  • DATA_SOURCE: l'origine dati (ad esempio, saphana).
  • DISPLAY_NAME: il nome visualizzato per la configurazione del trasferimento. Il nome del trasferimento dei dati può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.
  • DATASET: il set di dati di destinazione per la configurazione del trasferimento.
  • PARAMETERS: i parametri per la configurazione del trasferimento creato in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri per un trasferimento da Salesforce Marketing Cloud:
    • connector.subdomain: il sottodominio dell'API.
    • connector.instance: il valore dell'istanza API.
    • connector.authentication.oauth.clientId: il nome dell'ID app per il client OAuth.
    • connector.authentication.oauth.clientSecret: il segreto dell'app per il client OAuth.

Ad esempio, il seguente comando crea un trasferimento di dati di Salesforce Marketing Cloud nel progetto predefinito con tutti i parametri richiesti:

  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

Utilizza il metodo projects.locations.transferConfigs.create e fornisci un'istanza della risorsa TransferConfig.

Risolvere i problemi di configurazione del trasferimento

Se hai problemi a configurare un trasferimento di dati di Salesforce Marketing Cloud, prova a seguire questi passaggi per la risoluzione dei problemi:

Messaggi di errore

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

Risoluzione:prova uno dei seguenti passaggi:

  • Attiva tutti gli indirizzi IP disponibili per le risorse Google Cloud .
  • Disattiva la lista consentita di indirizzi IP. Per farlo, accedi all'applicazione Salesforce Marketing Cloud, quindi vai alla pagina Configurazione > Impostazioni di sicurezza. Fai clic su Modifica, quindi configura l'impostazione Limita accessi per indirizzo IP (lista consentita IP) su Lista consentita IP disattivata.

Disattivare la lista consentita IP

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

Soluzione:assicurati di aver configurato le autorizzazioni di ambito corrette nell'applicazione Salesforce Marketing Cloud. Per ulteriori informazioni, consulta Prerequisiti di Salesforce Marketing Cloud.

Prezzi

Il trasferimento dei dati di Salesforce Marketing Cloud in BigQuery non prevede costi durante l'anteprima di questa funzionalità.

Passaggi successivi