Carica i dati di Google Analytics 4 in BigQuery

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

Panoramica del connettore

BigQuery Data Transfer Service per il connettore Google Analytics supporta le seguenti opzioni per il trasferimento di dati.

Opzioni di trasferimento dei dati Assistenza
Report supportati Il connettore di Google Analytics supporta il trasferimento dei dati dei report dall'API Google Analytics Data v1.

Per informazioni su come i report di Google Analytics vengono trasformati in tabelle e viste BigQuery, consulta Trasformazione dei report di Google Analytics.
Frequenza di ripetizione Il connettore Google Analytics supporta i trasferimenti di dati giornalieri.

Per impostazione predefinita, i trasferimenti di dati vengono pianificati al momento della loro creazione. Puoi configurare l'ora del trasferimento dei dati quando configuri il trasferimento dei dati.
Finestra di aggiornamento Puoi pianificare i trasferimenti di dati per recuperare i dati di Google Analytics fino a 30 giorni al momento dell'esecuzione del trasferimento di dati. Puoi configurare la durata della finestra di aggiornamento quando configuri il trasferimento di dati.

Per impostazione predefinita, il connettore Google Analytics ha una finestra di aggiornamento di 4 giorni.

Per maggiori informazioni, vedi Finestre di aggiornamento.
Disponibilità dei dati di backfill Esegui un backfill dei dati per recuperare i dati al di fuori del trasferimento di dati pianificato. Puoi recuperare i dati fino al periodo consentito dalla policy sulla conservazione dei dati dell'origine dati.

Per informazioni sulle norme sulla conservazione dei dati di Google Analytics, consulta le Norme sulla conservazione dei dati di Google Analytics.

Limitazioni

  • I totali aggregati per le metriche relative a utenti e sessioni distinti potrebbero non essere accurati e non corrispondere ai valori in Google Analytics.
  • Il connettore Google Analytics 4 non supporta il trasferimento di proprietà personalizzate.

Acquisizione dei dati dai trasferimenti di Google Analytics 4

Quando trasferisci i dati da Google Analytics 4 a BigQuery, i dati vengono caricati in tabelle BigQuery partizionate per data. La partizione della tabella in cui vengono caricati i dati corrisponde alla data dell'origine dati. Se pianifichi più trasferimenti per la stessa data, BigQuery Data Transfer Service sovrascrive la partizione per quella data specifica con i dati più recenti. Più trasferimenti nello stesso giorno o l'esecuzione di backfill non comportano la duplicazione dei dati e le partizioni per altre date non sono interessate.

Finestre di aggiornamento

Una finestra di aggiornamento è il numero di giorni in cui un trasferimento di dati recupera i dati quando si verifica un trasferimento di dati. Ad esempio, se la finestra di aggiornamento è di tre giorni e viene eseguito un trasferimento giornaliero, BigQuery Data Transfer Service recupera tutti i dati dalla tabella di origine degli ultimi tre giorni. In questo esempio, quando si verifica un trasferimento giornaliero, BigQuery Data Transfer Service crea una nuova partizione della tabella di destinazione BigQuery con una copia dei dati della tabella di origine del giorno corrente, quindi attiva automaticamente le esecuzioni di backfill per aggiornare le partizioni della tabella di destinazione BigQuery con i dati della tabella di origine dei due giorni precedenti. Le esecuzioni di backfill attivate automaticamente sovrascrivono o aggiornano in modo incrementale la tabella di destinazione BigQuery, a seconda che gli aggiornamenti incrementali siano supportati o meno nel connettore BigQuery Data Transfer Service.

Quando esegui un trasferimento di dati per la prima volta, il trasferimento recupera tutti i dati di origine disponibili nella finestra di aggiornamento. Ad esempio, se la finestra di aggiornamento è di tre giorni e esegui il trasferimento dei dati per la prima volta, BigQuery Data Transfer Service recupera tutti i dati di origine entro tre giorni.

Per recuperare dati al di fuori della finestra di aggiornamento, ad esempio dati storici, o per recuperare dati da eventuali interruzioni o lacune del trasferimento, puoi avviare o pianificare un'esecuzione di backfill.

Prima di iniziare

Prima di creare un trasferimento di dati di Google Analytics 4, esamina i seguenti prerequisiti e informazioni.

Prerequisiti

  • In Google Analytics 4, l'account utente o l'account di servizio deve disporre dell'accesso in visualizzazione all'ID proprietà utilizzato nella configurazione del trasferimento.
  • Verifica di aver completato tutte le azioni necessarie per abilitare BigQuery Data Transfer Service.
  • Crea un set di dati BigQuery per archiviare i dati di Google Analytics 4.
  • Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, assicurati di disporre dell'autorizzazione Identity and Access Management (IAM) pubsub.topics.setIamPolicy. Se configuri solo le notifiche via email, le autorizzazioni Pub/Sub non sono necessarie. Per saperne di più, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.

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) nel 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 di 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 di 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 saperne di più, consulta Concedi l'accesso a bigquery.admin.

Report personalizzati

Il connettore BigQuery Data Transfer Service per Google Analytics supporta l'utilizzo di report personalizzati specificando dimensioni e metriche nella configurazione del trasferimento di Google Analytics. Questi report personalizzati importano i dati dalla versione dell'API Google Analytics Data supportata da BigQuery Data Transfer Service.

Puoi specificare un report personalizzato quando crei un trasferimento di Google Analytics.

Limitazioni dei report personalizzati

  • È supportato un solo report personalizzato per configurazione del trasferimento.
  • Per ogni report personalizzato è supportato un massimo di 9 dimensioni e 10 metriche.
  • Non tutte le dimensioni e le metriche sono compatibili tra loro. Utilizza lo strumento Esplorazione dimensioni e metriche di GA4 per convalidare le dimensioni e le metriche dei report personalizzati prima di creare il trasferimento.
  • Dimensioni e metriche personalizzate non sono supportate.

Configura un trasferimento di dati di Google Analytics 4

Seleziona una delle seguenti opzioni:

Console

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

    Vai a Trasferimenti di dati

  2. Fai clic su Crea trasferimento.

  3. Nella pagina Crea repository, segui questi passaggi:

    • Nella sezione Tipo di origine, per Origine, scegli Google Analytics 4.

  4. Nella sezione Dettagli origine dati:

    • Nel campo ID proprietà, inserisci un ID proprietà.
    • (Facoltativo) Nel campo Filtro tabella, inserisci un elenco delle tabelle da includere separato da virgole, ad esempio Audiences, Events. In questo elenco, inserisci come prefisso il carattere - per escludere determinate tabelle, ad esempio -Audiences, Events. Per impostazione predefinita, sono incluse tutte le tabelle.
    • (Facoltativo) Per importare report personalizzati anziché report standard, segui questi passaggi:
      • Nel campo Nome tabella report personalizzato, inserisci il nome della tabella di output per il report personalizzato. Per saperne di più sui nomi di tabella validi, consulta Denominazione delle tabelle.
      • Nel campo Dimensioni report personalizzato, inserisci le dimensioni del report personalizzato. Per saperne di più, consulta Report personalizzati.
      • Nel campo Metriche report personalizzato, inserisci le metriche per il report personalizzato. Per saperne di più, consulta Report personalizzati.
    • (Facoltativo) Nel campo Finestra di aggiornamento, inserisci una durata per la finestra di aggiornamento in giorni. La finestra di aggiornamento ha un valore predefinito di quattro giorni e può essere un valore fino a 30 giorni.

  5. Nella sezione Impostazioni destinazione, nel menu Set di dati di destinazione, 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. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.

  7. Nella sezione Opzioni di pianificazione:

    • Seleziona Inizia ora o Inizia all'ora impostata, quindi fornisci una data di inizio e un'ora di esecuzione.
    • Per Si ripete, scegli un'opzione per la frequenza con cui eseguire il trasferimento di dati. Se selezioni Giorni, specifica un'ora valida nel fuso orario UTC.

  8. (Facoltativo) Nel menu Service account, seleziona un service account tra quelli associati al tuo progetto Google Cloud . Il 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 service account per creare un trasferimento di dati. Se hai eseguito l'accesso con un Account Google, il service account per il trasferimento dei dati è facoltativo. Per ulteriori informazioni sull'utilizzo dei service account con i trasferimenti di dati, consulta Utilizza i service account.

  9. (Facoltativo) Nella sezione Opzioni di notifica:

    • Fai clic sul pulsante di attivazione/disattivazione per abilitare le notifiche via email. Quando attivi questa opzione, l'amministratore del trasferimento riceve una notifica via email quando l'esecuzione di un trasferimento non riesce.
    • Fai clic sul pulsante di attivazione/disattivazione per abilitare le notifiche Pub/Sub. In Seleziona un argomento Cloud Pub/Sub, scegli il nome dell'argomento o fai clic su Crea un argomento. Questa opzione configura le notifiche di esecuzione di Pub/Sub per il trasferimento.

  10. (Facoltativo) Se utilizzi le CMEK, nella sezione Opzioni avanzate, seleziona Chiave gestita dal cliente. Viene visualizzato un elenco di CMEK disponibili tra cui scegliere. Per informazioni su come funzionano le CMEK con BigQuery Data Transfer Service, vedi Specificare la chiave di crittografia con i trasferimenti.

  11. Fai clic su Salva.

bq

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

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

Dove:

  • PROJECT_ID: il tuo ID progetto. Se --project_id non è specificato, viene utilizzato il progetto predefinito.
  • DATASET: il set di dati di destinazione per la configurazione del trasferimento di dati.
  • NAME: il nome visualizzato della configurazione del trasferimento di dati. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.
  • PARAMETERS: i parametri per la configurazione del trasferimento di dati creata in formato JSON, ad esempio --params='{"param":"param_value"}'. Per i trasferimenti di Google Analytics 4, il parametro property_id è obbligatorio.
  • DATA_SOURCE: l'origine dati, ga4.

Ad esempio, il seguente comando crea un trasferimento di dati di Google Analytics 4 denominato My Transfer utilizzando l'ID proprietà 468039345, con il set di dati di destinazione mydataset.

Il trasferimento di dati viene creato nel progetto predefinito:

  bq mk --transfer_config
  --project_id=your_project
  --target_dataset=mydataset
  --display_name=My Transfer
  --params='{"property_id":"468039345"}'
  --data_source=ga4

API

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

Specifica la chiave di crittografia con i trasferimenti

Puoi specificare chiavi di crittografia gestite dal cliente (CMEK) per criptare i dati per un'esecuzione del trasferimento. Puoi utilizzare una CMEK per supportare i trasferimenti da Google Analytics 4.

Quando specifichi una CMEK con un trasferimento, BigQuery Data Transfer Service applica la CMEK a qualsiasi cache del disco intermedia dei dati importati, in modo che l'intero flusso di lavoro di trasferimento dei dati sia conforme alla CMEK.

Non puoi aggiornare un trasferimento esistente per aggiungere una CMEK se il trasferimento non è stato creato originariamente con una CMEK. Ad esempio, non puoi modificare una tabella di destinazione che era originariamente criptata per impostazione predefinita in modo che ora sia criptata con CMEK. Allo stesso modo, non puoi modificare una tabella di destinazione criptata con CMEK per applicare un tipo di crittografia diverso.

Puoi aggiornare una CMEK per un trasferimento se la configurazione del trasferimento è stata creata originariamente con una crittografia CMEK. Quando aggiorni una CMEK per una configurazione di trasferimento, BigQuery Data Transfer Service la propaga alle tabelle di destinazione alla successiva esecuzione del trasferimento, durante la quale BigQuery Data Transfer Service sostituisce le CMEK obsolete con la nuova CMEK. Per saperne di più, consulta Aggiorna un trasferimento.

Puoi anche utilizzare le chiavi predefinite del progetto. Quando specifichi una chiave predefinita del progetto con un trasferimento, BigQuery Data Transfer Service utilizza la chiave predefinita del progetto come chiave predefinita per tutte le nuove configurazioni di trasferimento.

Prezzi

L'esecuzione di un trasferimento di Google Analytics 4 non comporta costi.

Una volta trasferiti i dati a BigQuery, si applicano i prezzi standard di BigQuery per l'archiviazione e le query.

Quota

I trasferimenti di Google Analytics 4 sono soggetti alle quote delle proprietà di Analytics applicate da Google Analytics 4. Per aumentare la quota per proprietà, puoi eseguire l'upgrade a Google Analytics 360.