Pianifica un trasferimento di Salesforce Marketing Cloud

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

Prima di iniziare

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

Prerequisiti di Salesforce Marketing Cloud

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

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

1. Installare un pacchetto di integrazione dell'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.
   • Il sottodominio fa parte dell'URI di base. Ad esempio, nell'URI di base dell'autenticazione https://SUBDOMAIN.auth.marketingcloudapis.com/, SUBDOMAIN è il valore del tuo sottodominio.
   • Per saperne di più, consulta la sezione 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 inoltre configurare le impostazioni delle autorizzazioni dell'ambito per consentire un trasferimento a Salesforce Marketing Cloud:

1. Accedi all'applicazione Salesforce Marketing Cloud.

2. Espandi il menu a discesa del profilo e poi fai clic su Configurazione.

   

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 Leggi per i seguenti ambiti:

   • Email
   • Contenuti salvati
   • Percorsi
   • Callback
   • Campagna

7. Fai clic su Salva.

Prerequisiti BigQuery

• Verifica di aver completato tutte le azioni necessarie per abilitare BigQuery Data Transfer Service.
• Crea un set di dati BigQuery per archiviare i tuoi dati.
• Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, assicurati di avere l'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.

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

Potresti anche essere in grado di ottenere queste autorizzazioni con i 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:

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

  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"}'

Risolvere i problemi di configurazione del trasferimento

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

• Assicurati che l'autenticazione configurata per il pacchetto di integrazione API sia configurata su Server-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:

• Abilita tutti gli indirizzi IP disponibili per le risorse Google Cloud.
• Disabilita la lista consentita degli IP. A questo scopo, accedi all'applicazione Salesforce Marketing Cloud e 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 disabilitata.

Prezzi

Non è previsto alcun costo per trasferire i dati di Salesforce Marketing Cloud in BigQuery 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, incluse le informazioni su una configurazione di trasferimento, l'elenco delle configurazioni di trasferimento e la visualizzazione della cronologia delle esecuzioni di un trasferimento, consulta Gestire i trasferimenti.
• Scopri come caricare dati con le operazioni cross-cloud.