Pianificare un trasferimento di Salesforce Marketing Cloud

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Nota: per ricevere assistenza o fornire feedback su questa funzionalità, contatta [e-mail].

Il connettore BigQuery Data Transfer Service per Salesforce Marketing Cloud consente di pianificare e gestire automaticamente i job di caricamento ricorrenti da Salesforce Marketing Cloud in BigQuery.

Prima di iniziare

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

Prerequisiti di Salesforce Marketing Cloud

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

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

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

1. Installa un pacchetto di integrazione dell'API di tipo server-to-server. Prendi nota dell'ID client, della client secret e del sottodominio nella sezione Componenti della pagina dei dettagli del pacchetto.
   • Il sottodominio fa parte dell'URI di base. Ad esempio, nell'URI base di autenticazione https://SUBDOMAIN.auth.marketingcloudapis.com/, SUBDOMAIN è il valore del sottodominio.
   • Per saperne di più, consulta Integrazioni server-to-server con il tipo di concessione delle credenziali client.
2. Individua 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 ulteriori 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 di Salesforce Marketing Cloud:

1. Accedi all'applicazione Salesforce Marketing Cloud.

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

   

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

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

• Verifica di aver completato tutte le azioni necessarie per abilitare BigQuery Data Transfer Service.
• Crea un set di dati BigQuery per archiviare i dati.
• Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, assicurati di disporre dell'autorizzazione pubsub.topics.setIamPolicy Identity and Access Management (IAM). Le autorizzazioni Pub/Sub non sono necessarie se configuri solo le notifiche via email. Per ulteriori informazioni, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.

Ruoli BigQuery obbligatori

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

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare un trasferimento sono necessarie le seguenti autorizzazioni:

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

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

Configurare un trasferimento dati di Salesforce Marketing Cloud

Per creare un trasferimento di dati di Salesforce Marketing Cloud:

Console

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

   Vai a Trasferimenti dati

2. Fai clic su Crea trasferimento.

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

4. Nella sezione Dettagli origine dati:

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

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

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

7. Nella sezione Opzioni di programmazione:

   • 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, questo trasferimento viene eseguito 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. Nel menu Account di servizio, seleziona un account di servizio associato al tuo progetto Google Cloud. L'account di servizio selezionato deve avere i ruoli richiesti per eseguire questo trasferimento di dati.

   Se hai eseguito l'accesso con un'identità federata, è necessario un account di servizio per creare un trasferimento di dati. Se hai eseguito l'accesso con un Account Google, un account di servizio per il trasferimento è facoltativo.

   Per ulteriori informazioni sull'utilizzo degli account di servizio con i trasferimenti di dati, consulta Utilizzare gli account di servizio.

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

   • Per attivare le notifiche via email, fai clic sull'opzione di attivazione/disattivazione Notifica via email. Quando attivi questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un'esecuzione del trasferimento non va a buon fine.
   • 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.

10. 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 specifica 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:

• PROJECT_ID (facoltativo): l'ID del tuo progetto Google Cloud. Se non viene fornito --project_id per specificare un determinato progetto, viene utilizzato il progetto predefinito.
• DATA_SOURCE: l'origine dati (ad es. saphana).
• DISPLAY_NAME: il nome visualizzato per la configurazione del trasferimento. Il nome del trasferimento 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 creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri per un trasferimento di Salesforce Marketing Cloud:
  • connector.subdomain: il sottodominio dell'API.
  • connector.instance: il valore dell'istanza dell'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 difficoltà a configurare un trasferimento di dati di Salesforce Marketing Cloud, prova a seguire i seguenti passaggi per la risoluzione dei problemi:

• Assicurati che l'autenticazione configurata per il pacchetto di integrazione dell'API sia impostata su Server-to-server.
• Assicurati che l'app di autenticazione sia configurata con le autorizzazioni richieste in Ambito.

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 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 gli accessi in base all'indirizzo IP (lista consentita IP) su Lista consentita IP disattivata.

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

Risoluzione: 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 alcun costo mentre questa funzionalità è in anteprima.

Passaggi successivi

• Per una panoramica di BigQuery Data Transfer Service, consulta Introduzione a BigQuery Data Transfer Service.
• Per informazioni sull'utilizzo dei trasferimenti di dati, tra cui come ottenere informazioni su una configurazione di trasferimento, elencare le configurazioni di trasferimento e visualizzare la cronologia di esecuzione di un trasferimento, consulta Gestire i trasferimenti.
• Scopri come caricare i dati con operazioni cross-cloud.