Caricare i dati di Mailchimp in BigQuery

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

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

Puoi caricare i dati da Mailchimp a BigQuery utilizzando il connettore BigQuery Data Transfer Service per Mailchimp. Con BigQuery Data Transfer Service, puoi pianificare job di trasferimento ricorrenti che aggiungono i dati più recenti da Mailchimp a BigQuery. Il connettore Mailchimp supporta più account, inclusi gli account Mailchimp Standard ed Express.

Limitazioni

• L'API Marketing di Mailchimp supporta un massimo di 10 connessioni simultanee per utente. Il superamento di questo limite genera l'errore 429: TooManyRequests: You have exceeded the limit of 10 simultaneous connections
  • Per evitare di raggiungere questo limite di frequenza, ti consigliamo di eseguire un solo trasferimento di dati per account Mailchimp.
  • Per saperne di più, consulta il Glossario degli errori.
• Il tipo di dati Integer in Mailchimp ha un valore massimo supportato di 2.147.483.647 in tutti gli oggetti.
  • Tuttavia, alcuni campi Mailchimp supportano valori più elevati, ad esempio il campo Quantity in EcommerceOrderLines e EcommerceCartLines.

Limitazioni dei campi array

Il connettore Mailchimp non supporta i campi ARRAY nei seguenti oggetti Mailchimp:

Oggetto Mailchimp	Campi ARRAY non supportati
Campaigns	VariateSettings_SubjectLines VariateSettings_SendTimes VariateSettings_FromNames VariateSettings_ReplyToAddresses VariateSettings_Contents VariateSettings_Combinations
EcommerceCarts	Lines
EcommerceProducts	Variants
ListMembers	TagsAggregate
ListMergeFields	Options_Choices
Lists	Modules
AuthorizedApps	Users
AutomationEmails	Settings_AutoFbPost
CampaignOpenEmailDetails	Opens
EcommerceProductImages	VariantIds
ListSignupForms	Contents, Styles
ReportEmailActivity	Activity
Reports	Timewarp

Prima di iniziare

Le sezioni seguenti descrivono i prerequisiti da soddisfare prima di creare un trasferimento di dati Mailchimp.

Prerequisiti di Mailchimp

Per abilitare i trasferimenti di dati da Mailchimp a BigQuery, devi disporre di una chiave API Mailchimp per l'autorizzazione e l'accesso. Per informazioni su come ottenere una chiave API, consulta Generare una chiave API.

Prerequisiti di BigQuery

• Verifica di aver completato tutte le azioni necessarie per attivare BigQuery Data Transfer Service.
• Crea un set di dati BigQuery per archiviare i dati.

Ruoli BigQuery richiesti

Per ottenere le autorizzazioni necessarie per creare un trasferimento di dati BigQuery Data Transfer Service, chiedi all'amministratore di concederti il ruolo IAM Amministratore BigQuery (roles/bigquery.admin) sul tuo progetto. 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 di dati BigQuery Data Transfer Service. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un trasferimento di dati di BigQuery Data Transfer Service sono necessarie le seguenti autorizzazioni:

• Autorizzazioni BigQuery Data Transfer Service:
  • bigquery.transfers.update
  • bigquery.transfers.get
• Autorizzazioni BigQuery:
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.datasets.update
  • bigquery.datasets.setIamPolicy
  • bigquery.jobs.create

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

Per maggiori informazioni, vedi Concedere l'accesso a bigquery.admin.

Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, assicurati di disporre dell'autorizzazione pubsub.topics.setIamPolicyIAM. Le autorizzazioni Pub/Sub non sono necessarie se configuri solo le notifiche via email. Per saperne di più, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.

Configurare un trasferimento di dati Mailchimp

Aggiungi i dati di Mailchimp a BigQuery configurando una configurazione del trasferimento utilizzando una delle seguenti opzioni:

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, scegli Mailchimp - Anteprima.

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

   • Per Chiave API, inserisci la tua chiave API Mailchimp. Per ulteriori informazioni, consulta Prerequisiti di Mailchimp.
   • (Facoltativo) Per Data di inizio, specifica una data di inizio per i nuovi record da includere nel trasferimento dei dati. Nel trasferimento dei dati sono inclusi solo i record creati a partire da questa data.
     • Inserisci una data nel formato YYYY-MM-DD. Il valore minimo è 2001-01-01.
   • Per Oggetti Mailchimp da trasferire, fai clic su Sfoglia per selezionare gli oggetti da trasferire al set di dati di destinazione BigQuery. In questo campo puoi anche inserire manualmente gli oggetti da includere nel trasferimento di dati.

5. Nella sezione Impostazioni destinazione, in Set di dati, scegli 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:

   • 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.

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=NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

Sostituisci quanto segue:

• (Facoltativo) PROJECT_ID: l'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 mailchimp.
• NAME: il nome visualizzato per la configurazione del trasferimento dei dati. Il nome del trasferimento 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 dati Mailchimp:

  • assets: il percorso degli oggetti Mailchimp da trasferire a BigQuery.
  • connector.authentication.apiKey: la chiave API di Mailchimp.
  • connector.startDate: (facoltativo) una data di inizio per i nuovi record da includere nel trasferimento dei dati, nel formato YYYY-MM-DD. Nel trasferimento dei dati sono inclusi solo i record creati in questa data o successivamente.

Il comando seguente crea un trasferimento di dati Mailchimp nel progetto predefinito.

    bq mk
        --transfer_config
        --target_dataset=mydataset
        --data_source=mailchimp
        --display_name='My Transfer'
        --params='{"assets": "Lists",
            "connector.authentication.apiKey":"1234567",
            "connector.startDate":"2025-01-01"}'

Quando salvi la configurazione del trasferimento, il connettore Mailchimp attiva automaticamente un'esecuzione del trasferimento in base all'opzione di pianificazione che hai scelto. A ogni esecuzione del trasferimento, il connettore Mailchimp trasferisce tutti i dati disponibili da Mailchimp a BigQuery.

Per eseguire manualmente un trasferimento di dati al di fuori della pianificazione regolare, puoi avviare un'esecuzione di backfill.

Mappatura dei tipi di dati

La seguente tabella mappa i tipi di dati di Mailchimp con i tipi di dati BigQuery corrispondenti:

Tipo di dati Mailchimp	Tipo di dati BigQuery	Descrizione
String	STRING
Integer	INT64
Number	BIGNUMERIC	Gli oggetti dati di Mailchimp Number vengono mappati al tipo di dati BIGNUMERIC per i campi correlati alla finanza come Price e OrderTotal o al tipo di dati FLOAT64 per altri campi come Stats_OpenRate e Location_Latitude.
Number	FLOAT64
Boolean	BOOLEAN
String nel formato data e ora	TIMESTAMP	I tipi di dati STRING nel formato data e ora sono rappresentati nel formato ISO 8601. Ad esempio, 2019-08-24T14:15:22Z.

Prezzi

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

Risolvere i problemi di configurazione del trasferimento

Se riscontri problemi durante la configurazione del trasferimento dei dati, consulta Problemi di trasferimento di Mailchimp.

Passaggi successivi

• Per una panoramica di BigQuery Data Transfer Service, consulta Che cos'è BigQuery Data Transfer Service.
• Per informazioni sull'utilizzo dei trasferimenti, 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.