Esportare i dati di Firebase in BigQuery

Firebase fornisce strumenti nella console Firebase per esplorare e analizzare i dati storici relativi alle tue app che utilizzano i prodotti Firebase. Questi strumenti possono aiutarti a rispondere a molte domande su come vengono utilizzate le tue app. A volte, però, potresti voler configurare le tue query per rispondere alle tue domande.

Per farlo, esporta i dati di vari prodotti Firebase in BigQuery. Con BigQuery, puoi analizzare i dati con BigQuery SQL o esportarli per utilizzarli con i tuoi strumenti.

I seguenti prodotti supportano l'esportazione dei dati in BigQuery:

• Google Analytics
• Cloud Messaging
• Crashlytics
• Performance Monitoring
• A/B Testing
• Personalizzazione di Remote Config

Autorizzazioni richieste e ruoli suggeriti

Per visualizzare o gestire le impostazioni relative all'esportazione dei dati in BigQuery, devi disporre del livello di accesso richiesto.

Se non disponi dell'accesso a Firebase necessario, puoi chiedere a un Project Owner del progetto Firebase di assegnarti il ruolo applicabile tramite le impostazioni IAM della console Firebase. Se hai domande sull'accesso al tuo progetto Firebase, tra cui come trovare o assegnare un proprietario, consulta le domande frequenti su autorizzazioni e accesso ai progetti Firebase.

A livello di progetto

La tabella seguente si applica al collegamento di primo livello di un progetto Firebase a BigQuery.

Azione nella console Firebase	Autorizzazione IAM obbligatoria	Ruoli IAM che includono le autorizzazioni richieste per impostazione predefinita	Ruoli aggiuntivi richiesti
Collega un progetto Firebase e BigQuery	firebase.links.create	Proprietario Firebase Admin	nessuno
Scollega un progetto Firebase e BigQuery	firebase.links.delete	Proprietario Firebase Admin	nessuno
Visualizza i link esistenti per BigQuery	firebase.links.list	Qualsiasi ruolo di base (Proprietario, Editor o Visualizzatore) Qualsiasi ruolo a livello di Firebase Qualsiasi ruolo per categoria di prodotto Firebase	nessuno

Google Analytics

La tabella seguente si applica in modo specifico all'esportazione dei dati di Google Analytics in BigQuery.

Azione nella console Firebase	Autorizzazione IAM obbligatoria	Ruoli IAM che includono le autorizzazioni richieste per impostazione predefinita	Ruoli aggiuntivi richiesti
Abilita l'esportazione dei dati di Google Analytics in BigQuery	firebase.links.update AND serviceusage.services.enable AND resourcemanager.projects.getIamPolicy AND resourcemanager.projects.setIamPolicy	Proprietario Firebase Admin E Service Usage Admin E Project IAM Admin	Google Analytics: equivalente di amministratore o editor dell'account per la proprietà Google Analytics collegata Vedi la nota di seguito.
Abilita l'esportazione per app Firebase specifiche	firebase.links.update	Proprietario Firebase Admin	Google Analytics: equivalente di amministratore o editor dell'account per la proprietà Google Analytics collegata Vedi la nota di seguito.
Disattiva l'esportazione per app Firebase specifiche	firebase.links.update	Proprietario Firebase Admin	Google Analytics: equivalente di amministratore o editor dell'account per la proprietà Google Analytics collegata Vedi la nota di seguito.

Nota: per attivare o disattivare l'esportazione nell'interfaccia utente di Google Analytics, devi disporre del ruolo esplicito di Amministratore o Editor per la proprietà Google Analytics collegata. Tuttavia, l'accesso a Firebase non è obbligatorio.

Prodotti Firebase

La tabella seguente si applica a tutti i prodotti Firebase per i quali puoi esportare i dati in BigQuery, ad esempio Crashlytics o Performance Monitoring.

Azione nella console Firebase	Autorizzazione IAM obbligatoria	Ruoli IAM che includono le autorizzazioni richieste per impostazione predefinita	Ruoli aggiuntivi richiesti
Attiva l'esportazione dei dati di un prodotto in BigQuery	firebase.links.update	Proprietario Firebase Admin	nessuno
Abilita l'esportazione per app Firebase specifiche	firebase.links.update	Proprietario Firebase Admin	nessuno
Disattiva l'esportazione per app Firebase specifiche	firebase.links.update	Proprietario Firebase Admin	nessuno

---

Configura l'esportazione in BigQuery

1. Accedi alla console Firebase, quindi seleziona il tuo progetto.

2. Vai alla scheda Settings (Impostazioni) > Integrations (Integrazioni).

3. Nella scheda BigQuery, fai clic su Collega.

4. Segui le istruzioni sullo schermo per configurare l'esportazione in BigQuery.

Scollega da BigQuery

Lo scollegamento da BigQuery interrompe il popolamento dei set di dati corrispondenti in BigQuery.

Tieni presente quanto segue:

• Tutti i dati già esportati in BigQuery verranno conservati per il periodo di conservazione consentito e potrebbero comunque essere applicati costi di archiviazione e query. Puoi eliminare manualmente i set di dati per evitare ulteriori addebiti.

• Se i dati di BigQuery sono archiviati in altri servizi, potrebbero essere regolati da termini di persistenza dei dati diversi.

Puoi scollegare BigQuery a livello di progetto Firebase, a livello di prodotto o a livello di app per un prodotto specifico.

Attenzione: se scolleghi il progetto Firebase da BigQuery, l'esportazione dei dati da qualsiasi prodotto Firebase (e, se applicabile, Google Analytics) per cui hai configurato l'esportazione in BigQuery viene interrotta completamente.

Ecco come scollegare l'account da BigQuery:

1. Nella console Firebase, vai alla scheda Impostazioni > Integrazioni.

2. Nella scheda BigQuery, fai clic su Gestisci.

3. Scegli di scollegare un prodotto specifico o app specifiche per un prodotto specifico.

   Per scollegare completamente il progetto Firebase, individua il pulsante in fondo alla pagina.

4. Quando ti viene chiesto, conferma che vuoi interrompere le esportazioni.

---

Che cosa succede quando attivi l'esportazione?

• Selezioni la località del set di dati. Dopo la creazione del set di dati, la località non può essere modificata, ma puoi copiare il set di dati in un'altra località o spostare (ricreare) manualmente il set di dati in un'altra località. Per saperne di più, consulta Modifica la località per le esportazioni esistenti.

  Questa località è applicabile solo ai dati esportati in BigQuery e non influisce sulla località dei dati archiviati per l'utilizzo nella console Firebase.

• Per impostazione predefinita, tutte le app del progetto sono collegate a BigQuery e tutte le app che aggiungi in un secondo momento al progetto vengono collegate automaticamente a BigQuery. Puoi gestire le app che inviano dati.

• Firebase esporta una copia dei tuoi dati esistenti in BigQuery. La propagazione iniziale dei dati per l'esportazione può richiedere fino a 48 ore.

• Firebase configura le sincronizzazioni giornaliere dei tuoi dati con BigQuery.

  • Dopo aver collegato il progetto, in genere devi attendere la sincronizzazione del giorno successivo per esportare il primo set di dati in BigQuery.

  • La sincronizzazione giornaliera avviene una volta al giorno, indipendentemente dalle esportazioni pianificate che potresti aver configurato in BigQuery. Tieni presente che la tempistica e la durata del job di sincronizzazione possono variare, pertanto sconsigliamo di pianificare operazioni o job downstream in base a una tempistica specifica dell'esportazione.

  Nota: le esportazioni di dati Google Analytics in BigQuery sono limitate a 1 milione di eventi al giorno. Puoi utilizzare i filtri di eventi per limitare il numero di eventi esportati. Per scoprire di più, consulta la sezione Filtro dei dati. Non esiste alcun limite per gli utenti di Google Analytics 360.

---

Modifica la località per le esportazioni esistenti

Dopo aver configurato un prodotto per l'esportazione in BigQuery e aver creato un set di dati, non puoi modificare la località del set di dati. Tuttavia, puoi copiare il set di dati esistente in un nuovo set di dati con una posizione diversa e reimpostare l'esportazione dei dati in questa nuova posizione. Scopri di più sulle località dei set di dati BigQuery.

Assicurati di seguire tutte le istruzioni di queste procedure. Se trascuri un passaggio, potresti perdere dei dati.

Seleziona il prodotto per cui vuoi modificare la località per l'esportazione dei dati

Google Analytics

Per modificare la località di un'esportazione Google Analytics esistente in BigQuery, segui queste istruzioni:

1. Nella console Firebase, vai alla scheda Impostazioni > Integrazioni. Poi esegui le seguenti operazioni:

   1. Nella scheda BigQuery, fai clic su Gestisci.
   2. Disattiva il cursore Google Analytics per disattivare BigQuery.

2. Nella console Google Cloud, vai alla pagina BigQuery. Poi esegui le seguenti operazioni:

   1. Crea un set di dati temporaneo per archiviare una copia dei dati esistenti del set di dati originale. Assegna al set di dati temporaneo un nome diverso da quello del set di dati originale.
   2. Copia o sposta i dati dal set di dati originale a quello temporaneo.
   3. Elimina il set di dati originale.
   4. Crea un nuovo set di dati permanente con lo stesso nome del set di dati originale (analytics_ANALYTICS_PROPERTY_ID), quindi seleziona la nuova regione.
   5. Copia o sposta i dati dal set di dati temporaneo al nuovo set di dati, quindi elimina il set di dati temporaneo.

3. Torna alla console Firebase e alla scheda BigQuery. Poi esegui le seguenti operazioni:

   1. Attiva il cursore Google Analytics per riattivare l'integrazione di BigQuery.
   2. Seleziona le app per cui vuoi attivare l'esportazione.

Cloud Messaging

Per modificare la località di un'esportazione Cloud Messaging esistente in BigQuery, segui queste istruzioni:

1. Nella console Firebase, vai alla scheda Impostazioni > Integrazioni. Poi esegui le seguenti operazioni:

   1. Nella scheda BigQuery, fai clic su Gestisci.
   2. Disattiva il cursore Cloud Messaging per disattivare BigQuery.

2. Nella console Google Cloud, vai alla pagina BigQuery. Poi esegui le seguenti operazioni:

   1. Crea un set di dati temporaneo per archiviare una copia dei dati esistenti del set di dati originale. Assegna al set di dati temporaneo un nome diverso da quello del set di dati originale.
   2. Copia o sposta i dati dal set di dati originale a quello temporaneo.
   3. Elimina il set di dati originale.
   4. Crea un nuovo set di dati permanente con lo stesso nome del set di dati originale (firebase_messaging), quindi seleziona la nuova regione.
   5. Copia o sposta i dati dal set di dati temporaneo al nuovo set di dati, quindi elimina il set di dati temporaneo.

3. Torna alla console Firebase e alla scheda BigQuery. Poi esegui le seguenti operazioni:

   1. Attiva il cursore Cloud Messaging per riattivare l'integrazione di BigQuery.
   2. Seleziona le app per cui vuoi attivare l'esportazione.

4. Torna alla console Google Cloud e alla pagina BigQuery per verificare che sia stata creata una configurazione del trasferimento per Cloud Messaging nella nuova regione.

Crashlytics

Per modificare la località di un'esportazione Crashlytics esistente in BigQuery, segui queste istruzioni:

1. Nella console Firebase, vai alla scheda Impostazioni > Integrazioni. Poi esegui le seguenti operazioni:

   1. Nella scheda BigQuery, fai clic su Gestisci.
   2. Disattiva il cursore Crashlytics per disattivare BigQuery.

2. Nella console Google Cloud, vai alla pagina BigQuery. Poi esegui le seguenti operazioni:

   1. Crea un set di dati temporaneo per archiviare una copia dei dati esistenti del set di dati originale. Assegna al set di dati temporaneo un nome diverso da quello del set di dati originale.
   2. Copia o sposta i dati dal set di dati originale a quello temporaneo.
   3. Elimina il set di dati originale.
   4. Crea un nuovo set di dati permanente con lo stesso nome del set di dati originale (firebase_crashlytics), quindi seleziona la nuova regione.
   5. Copia o sposta i dati dal set di dati temporaneo al nuovo set di dati, quindi elimina il set di dati temporaneo.

3. Torna alla console Firebase e alla scheda BigQuery. Poi esegui le seguenti operazioni:

   1. Attiva il cursore Crashlytics per riattivare l'integrazione di BigQuery.
   2. Seleziona le app per cui vuoi attivare l'esportazione.

4. Torna alla console Google Cloud e alla pagina BigQuery per verificare che sia stata creata una configurazione del trasferimento per Crashlytics nella nuova regione.

Performance Monitoring

Per modificare la località di un'esportazione Performance Monitoring esistente in BigQuery, segui queste istruzioni:

1. Nella console Firebase, vai alla scheda Impostazioni > Integrazioni. Poi esegui le seguenti operazioni:

   1. Nella scheda BigQuery, fai clic su Gestisci.
   2. Disattiva il cursore Performance Monitoring per disattivare BigQuery.

2. Nella console Google Cloud, vai alla pagina BigQuery. Poi esegui le seguenti operazioni:

   1. Crea un set di dati temporaneo per archiviare una copia dei dati esistenti del set di dati originale. Assegna al set di dati temporaneo un nome diverso da quello del set di dati originale.
   2. Copia o sposta i dati dal set di dati originale a quello temporaneo.
   3. Elimina il set di dati originale.
   4. Crea un nuovo set di dati permanente con lo stesso nome del set di dati originale (firebase_performance), quindi seleziona la nuova regione.
   5. Copia o sposta i dati dal set di dati temporaneo al nuovo set di dati, quindi elimina il set di dati temporaneo.

3. Torna alla console Firebase e alla scheda BigQuery. Poi esegui le seguenti operazioni:

   1. Attiva il cursore Performance Monitoring per riattivare l'integrazione di BigQuery.
   2. Seleziona le app per cui vuoi attivare l'esportazione.

4. Torna alla console Google Cloud e alla pagina BigQuery per verificare che sia stata creata una configurazione del trasferimento per Performance Monitoring nella nuova regione.

---

Prezzi e sandbox BigQuery

Se il tuo progetto Firebase utilizza il piano tariffario Spark senza costi, puoi utilizzare la sandbox di BigQuery, che fornisce l'accesso di prova senza costi a BigQuery. Per informazioni sulla sandbox BigQuery e sulle sue funzionalità, consulta Utilizzo della sandbox BigQuery.

Se il tuo progetto Firebase è nel piano tariffario Blaze con pagamento a consumo, puoi utilizzare tutte le funzionalità di BigQuery. L'utilizzo di BigQuery è soggetto ai prezzi di BigQuery, che includono un utilizzo limitato senza costi.