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

Report supportati

BigQuery Data Transfer Service per Google Analytics 4 supporta le seguenti opzioni di generazione dei report:

Opzione di segnalazione Assistenza
Frequenza di ripetizione

Giornaliero, all'ora in cui viene creato il trasferimento dei dati (impostazione predefinita)

Puoi configurare l'ora del giorno.
Finestra di aggiornamento

Ultimi 4 giorni (predefinito)

Configurabile fino a 30 giorni
Durata massima del backfill

Nessun limite

Sebbene il connettore Google Analytics non abbia una durata massima per il backfill, potresti riscontrare errori durante il backfill dei dati storici a causa delle impostazioni di conservazione dei dati di Google Analytics.

Per informazioni su come i report di Google Analytics 4 vengono trasformati in tabelle e viste BigQuery, consulta Trasformazione dei dati di Google Analytics 4.

In un trasferimento Google Analytics 4, BigQuery Data Transfer Service trasferisce i seguenti report a BigQuery:

  • Audiences
  • Demographic details
  • Ecommerce purchases
  • Events
  • Landing page
  • Pages and screens
  • Promotions
  • Tech details
  • Traffic Acquisition
  • User Acquisition

Per saperne di più sui report predefiniti disponibili per Google Analytics, consulta Report predefiniti.

Importazione dei dati dai trasferimenti di Google Analytics 4

Quando trasferisci i dati da Google Analytics 4 a BigQuery, questi 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 vengono interessate.

Aggiorna finestre

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<0xx0A>e si verifica 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 degli ultimi due giorni. I backfill attivati automaticamente sovrascriveranno o aggiorneranno 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 di dati recupera tutti i dati di origine disponibili all'interno della finestra di aggiornamento. Ad esempio, se la finestra di aggiornamento è di tre giorni ed esegui il trasferimento dei dati per la prima volta, BigQuery Data Transfer Service recupera tutti i dati di origine entro tre giorni.

Le finestre di aggiornamento sono mappate al campo API TransferConfig.data_refresh_window_days.

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

Prima di iniziare

Esamina i seguenti prerequisiti e informazioni prima di creare un trasferimento di dati di Google Analytics 4.

Prerequisiti

  • In Google Analytics 4, l'account utente o l'account di servizio deve disporre dell'accesso come visualizzatore all'ID proprietà utilizzato nella configurazione del trasferimento.
  • Verifica di aver completato tutte le azioni necessarie per attivare 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 hai configurato solo le notifiche email, non sono necessarie autorizzazioni Pub/Sub. 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, chiedi all'amministratore di concederti il ruolo IAM BigQuery Admin (roles/bigquery.admin). 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. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un trasferimento sono necessarie le seguenti autorizzazioni:

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

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

Configurare un trasferimento dei dati di Google Analytics 4

Seleziona una delle seguenti opzioni:

Console

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

    Vai a Trasferimenti 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) 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 è 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. Sono necessari i seguenti flag:

  • --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 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.
  • PARAMETERS: i parametri per la configurazione del trasferimento dei dati creata in formato JSON, ad esempio --params='{"param":"param_value"}'. Per i trasferimenti di Google Analytics 4, è necessario il parametro property_id.
  • DATA_SOURCE: l'origine dati ga4.

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

Il trasferimento dei 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.

Limitazioni

  • I totali aggregati per le metriche relative a utenti unici e sessioni potrebbero non essere accurati e potrebbero non corrispondere ai valori in Google Analytics.

Specificare la chiave di crittografia con i trasferimenti

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

Quando specifichi una CMEK con un trasferimento, BigQuery Data Transfer Service la applica a qualsiasi cache su 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 chiave CMEK se il trasferimento non è stato originariamente creato con una chiave CMEK. Ad esempio, non puoi modificare una tabella di destinazione che originariamente era criptata per impostazione predefinita in modo che ora sia criptata con CMEK. Al contrario, non puoi modificare una tabella di destinazione criptata con CMEK in modo che abbia un tipo di crittografia diverso.

Puoi aggiornare una chiave CMEK per un trasferimento se la configurazione del trasferimento è stata originariamente creata 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 Aggiornare 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 qualsiasi nuova configurazione di trasferimento.

Prezzi

Il trasferimento di Google Analytics 4 non prevede costi.

Una volta trasferiti su BigQuery, i dati sono soggetti ai prezzi standard di BigQuery per l'archiviazione e le query.

Quota

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