Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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.

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 Google Analytics supporta il trasferimento dei dati dei report da API di dati di Google Analytics v1. Per informazioni su come i report di Google Analytics vengono trasformati in tabelle e viste BigQuery, vedi 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 creazione. Puoi configurare l'ora del trasferimento di dati quando lo imposti.
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 imposti 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 a quando la policy sulla conservazione dei dati dell'origine dati lo consente. Per informazioni sulla policy sulla conservazione dei dati di Google Analytics, vedi Policy sulla conservazione dei dati di Google Analytics.

Importazione 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 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. Le esecuzioni di backfill attivate 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 nella finestra di aggiornamento. Ad esempio, se la finestra di aggiornamento è di tre giorni ed esegui il trasferimento di dati per la prima volta, BigQuery Data Transfer Service recupera tutti i dati di origine entro tre giorni.

Per recuperare i dati al di fuori della finestra di aggiornamento, ad esempio i dati storici, o per recuperare i 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 il account di servizio deve avere l'accesso Visualizzatore 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 obbligatorie. Per maggiori informazioni, vedi Notifiche di esecuzione di BigQuery Data Transfer Service.

Ruoli BigQuery obbligatori

Per ottenere le autorizzazioni necessarie per creare un trasferimento di dati di BigQuery Data Transfer Service, chiedi all'amministratore di concederti il ruolo IAM di amministratore BigQuery (roles/bigquery.admin) nel 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 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 maggiori informazioni, vedi Concedere l'accesso bigquery.admin.

Report personalizzati

BigQuery Data Transfer Service per il connettore 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 di dati di Google Analytics 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 di trasferimento.
Per ogni report personalizzato sono supportate al massimo 9 dimensioni e 10 metriche.
Non tutte le dimensioni e le metriche sono compatibili tra loro. Utilizza lo strumento Esplora dimensioni e metriche di GA4 per convalidare le dimensioni e le metriche del report personalizzato prima di creare il trasferimento.
Le dimensioni e le metriche personalizzate non sono supportate.

Configurare un trasferimento di dati di Google Analytics 4

Seleziona una delle seguenti opzioni:

Console

Vai alla pagina Trasferimenti di dati nella Google Cloud console.

Vai a Trasferimenti di dati
Fai clic su Crea trasferimento.
Nella pagina Crea trasferimento, segui questi passaggi:
- Nella sezione Tipo di origine, per Origine, scegli Google Analytics 4.
Nella sezione Dettagli origine dati:
- Nel campo ID proprietà, inserisci un ID proprietà.
- (Facoltativo) Nel campo Filtro tabella , inserisci un elenco di 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é i report standard:
  - Nel campo Nome tabella report personalizzato, inserisci il nome della tabella di output per il report personalizzato. Per maggiori informazioni sui nomi delle tabelle validi, vedi Denominazione delle tabelle.
  - Nel campo Dimensioni report personalizzato, inserisci le dimensioni per il report personalizzato. Per maggiori informazioni, vedi Report personalizzati.
  - Nel campo Metriche report personalizzato, inserisci le metriche per il report personalizzato. Per maggiori informazioni, vedi Report personalizzati.
- (Facoltativo) Nel campo Finestra di aggiornamento, inserisci una durata per la tua 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.
Nella sezione Impostazioni destinazione, nel menu Set di dati di destinazione, seleziona il set di dati che hai creato per archiviare i dati.
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.
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.
(Facoltativo) Nel menu Service account, seleziona un service account tra i service account associati al tuo Google Cloud progetto. 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 account di servizio 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.
(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 del topic o fai clic su Crea un argomento. Questa opzione configura l'esecuzione delle notifiche di Pub/Sub in relazione al tuo trasferimento.
(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.
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 non viene specificato --project_id, 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 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, è obbligatorio il parametro property_id.
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 projects.locations.transferConfigs.create metodo e fornisci un'istanza della TransferConfig risorsa.

Limitazioni

I totali aggregati per le metriche relative a utenti e sessioni distinti potrebbero non essere precisi 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 di 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 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 CMEK se il trasferimento non è stato creato originariamente con una CMEK. Ad esempio, non puoi modificare una tabella di destinazione originariamente criptata per impostazione predefinita in modo che venga criptata con la CMEK. Al contrario, non puoi nemmeno modificare una tabella di destinazione criptata con la CMEK in modo che abbia 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 propaga la CMEK alle tabelle di destinazione alla successiva esecuzione del trasferimento, in cui BigQuery Data Transfer Service sostituisce le CMEK obsolete con la nuova CMEK durante l'esecuzione del trasferimento. Per maggiori informazioni, vedi 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 tutte le nuove configurazioni di trasferimento.

Prezzi

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

Quando i dati vengono trasferiti su BigQuery, vengono applicati i prezzi standard di BigQuery per l'archiviazione e le query.

Quota

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