Pianifica 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 per questa funzionalità, contatta [e-mail].

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

Prima di iniziare

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

Prerequisiti di Salesforce Marketing Cloud

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

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

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

1. Installare 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.
   • Il sottodominio fa parte dell'URI di base. Ad esempio, nel modulo di autenticazione URI di base https://SUBDOMAIN.auth.marketingcloudapis.com/, SUBDOMAIN è il valore del sottodominio.
   • Per saperne di più, consulta la pagina relativa alle integrazioni server-to-server con il tipo di concessione delle credenziali client.
2. Per trovare l'istanza del server API nell'URL dopo aver eseguito l'accesso alla l'applicazione Salesforce Marketing Cloud. Il valore dell'istanza include s seguito da un valore numerico. Ad esempio, nell'URL https://mc.s4.exacttarget.com/, la proprietà il valore dell'istanza è s4. Per ulteriori informazioni, consulta Individuare la posizione dello stack per un account Marketing Cloud.

Devi anche configurare le impostazioni delle autorizzazioni dell'ambito per consentire Trasferimento di Salesforce Marketing Cloud:

1. Accedi all'applicazione Salesforce Marketing Cloud.

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

   

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

4. Seleziona un pacchetto installato per modificarne le impostazioni.

5. Nella sezione Componenti, fai clic su Modifica.

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

   • Email
   • Contenuti salvati
   • Percorsi
   • Callback
   • Campagna

7. Fai clic su Salva.

Prerequisiti di BigQuery

• Verifica di aver completato tutte le azioni richieste 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 Identity and Access Management (IAM) di pubsub.topics.setIamPolicy. Pub/Sub le autorizzazioni non sono necessarie se configuri solo le notifiche via email. Per ulteriori informazioni le informazioni, vedi 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 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 vedere le autorizzazioni esatte obbligatorie, 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 riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.

Configurare un trasferimento di dati di Salesforce Marketing Cloud

Per creare un trasferimento di dati di Salesforce Marketing Cloud:

Console

1. Vai alla pagina BigQuery nella console Google Cloud.

   Vai alla pagina di BigQuery

2. Nel riquadro di navigazione, fai clic su Trasferimenti di dati > Crea un trasferimento.

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

4. Nella sezione Nome configurazione di trasferimento, per Nome visualizzato, inserisci un nome del trasferimento.

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

   • Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la spesso viene eseguito questo trasferimento. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzato. Se selezioni On demand, il trasferimento viene eseguita quando attivi manualmente il trasferimento.

   • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata. e specificare una data di inizio e un'ora di esecuzione.

6. Nella sezione Impostazioni destinazione, per Set di dati, seleziona il creato per archiviare i dati.

7. Nella sezione Dettagli origine dati:

   • In API Subdomain (Sottodominio API), inserisci il sottodominio dell'API.
   • In Istanza API, inserisci il valore dell'istanza API.
   • In ID client, inserisci l'ID client di integrazione app.
   • In Client Secret, inserisci il client secret per l'integrazione dell'app.

8. Nel menu Account di servizio, seleziona un account di servizio associati al tuo progetto Google Cloud. Il servizio selezionato l'account deve disporre dei ruoli richiesti per eseguire questa trasferimento.

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

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

9. (Facoltativo) Nella sezione Opzioni di notifica, procedi nel seguente modo:

   • Per attivare le notifiche via email, fai clic su Notifica email pulsante di attivazione/disattivazione. Quando abiliti questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un trasferimento non va a buon fine.
   • Per attivare Notifiche di esecuzione del trasferimento di Pub/Sub per questo trasferimento, fai clic sull'opzione di attivazione/disattivazione Notifiche Pub/Sub. Tu puoi selezionare argomento personalizzato oppure fai clic su Crea un argomento per crearne uno.

10. Fai clic su Salva.

Quando viene eseguito questo trasferimento, 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 --project_id non viene specificato per specificare un particolare progetto, viene utilizzato il progetto predefinito.
• DATA_SOURCE: l'origine dati (ad esempio saphana).
• DISPLAY_NAME: il nome visualizzato del trasferimento configurazione. Il nome del trasferimento può essere qualsiasi valore che ti consenta 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 il trasferimento creato configurazione in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri un trasferimento di Salesforce Marketing Cloud:
  • connector.subdomain: il sottodominio dell'API.
  • connector.instance: il valore dell'istanza API.
  • connector.authentication.oauth.clientId: il nome ID app del client OAuth.
  • connector.authentication.oauth.clientSecret: il secret dell'app per il client OAuth.

Ad esempio, il comando seguente crea un trasferimento di Salesforce Marketing Cloud nella 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 fornisce un'istanza della risorsa TransferConfig.

Risolvere i problemi di configurazione del trasferimento

Se riscontri problemi durante la configurazione di un trasferimento di Salesforce Marketing Cloud, prova la i seguenti 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.
• Disattiva la lista consentita degli IP. Puoi farlo accedendo al nell'applicazione Salesforce Marketing Cloud, quindi vai a Configurazione > Impostazioni di sicurezza. . Fai clic su Modifica, quindi configura Limita gli accessi in base all'indirizzo IP (Lista consentita IP) su Lista consentita IP disabilitata.

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

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

Prezzi

Non sono previsti costi per il trasferimento dei dati di Salesforce Marketing Cloud 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 cambi, incluse informazioni su un configurazione di trasferimento, elencare le configurazioni di trasferimento e visualizzare cronologia esecuzioni del trasferimento, vedi Gestire i trasferimenti.
• Scopri come caricare i dati con operazioni cross-cloud.