Pianificare un trasferimento a Google Analytics 4

Il connettore BigQuery Data Transfer Service per Google Analytics 4 consente di pianificare e gestire automaticamente i job di caricamento ricorrenti per i dati di configurazione e dei report di Google Analytics 4.

Report supportati

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

Opzione di segnalazione Assistenza
Frequenza di ripetizione

Giornalmente, al momento della prima creazione del trasferimento dei dati (valore predefinito)

Puoi configurare l'ora del giorno.
Aggiorna finestra

Ultimi 4 giorni (impostazione predefinita)

Configurabile fino a 30 giorni

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

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

  • Audiences
  • Conversions
  • Demographic details
  • Ecommerce purchases
  • Events
  • In-app purchases
  • 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 nelle 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 generano dati duplicati e le partizioni per altre date non sono interessate.

Aggiornare le finestre

Una finestra di aggiornamento è il numero di giorni per i quali 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 della 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 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, vengono recuperati 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 dell'API TransferConfig.data_refresh_window_days.

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

Esamina i prerequisiti e le informazioni riportati di seguito 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 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 memorizzare 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 ulteriori informazioni, consulta 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 il ruolo IAM Amministratore BigQuery (roles/bigquery.admin). Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare un trasferimento sono necessarie le seguenti autorizzazioni:

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

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

Configurare un trasferimento di dati di Google Analytics 4

Seleziona una delle seguenti opzioni:

Console

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

    Vai a Trasferimenti dati

  2. Fai clic su Crea trasferimento.

  3. Nella pagina Crea repository, segui questi passaggi:

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

  4. Nella sezione Dettagli origine dati:

    • Nel campo ID proprietà, inserisci un ID proprietà.
    • (Facoltativo) Nel campo Finestra di aggiornamento, inserisci la durata della 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 service account 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 Utilizzare 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. Fai clic su Salva.

bq

Inserisci il comando bq mk e specifica 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 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 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 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.

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 un 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 intermedia su disco 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 un CMEK se il trasferimento non è stato creato inizialmente con un CMEK. Ad esempio, non puoi modificare una tabella di destinazione che era inizialmente criptata per impostazione predefinita in modo che venga criptata con CMEK. Al contrario, non puoi nemmeno modificare una tabella di destinazione con crittografia CMEK per avere un tipo di crittografia diverso.

Puoi aggiornare un CMEK per un trasferimento se la configurazione del trasferimento è stata creata inizialmente 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, dove sostituisce le CMEK obsolete con la nuova CMEK durante l'esecuzione del trasferimento. Per ulteriori 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 la utilizza come chiave predefinita per tutte le nuove configurazioni di trasferimento.

Prezzi

L'esecuzione di un trasferimento a 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 come applicate da Google Analytics 4. Per consentire una quota maggiore per proprietà, puoi eseguire l'upgrade a Google Analytics 360.