Skip to main content

Firebase Analytics demystified

Alex Cirstea5 February 20184 min read
Firebase Analytics demystified
			<span style="font-weight: 400;">After a steep learning curve into the world of Firebase Analytics or Google Analytics for Firebase, it seems that a blog post about it would be much valued and appreciated. I’ve compiled a list of the most frequently asked questions.</span>

1. How does Firebase Analytics define a session?

Firebase Analytics defines a session as a user engaging with your app for a minimum amount of time (10 seconds by default) followed by your user not engaging with your app for a certain amount of time (30 minutes by default). So if a user is using your app, switches to camera and takes a photo, then goes back to your app, that's considered one session. Another example is if the user accidentally taps on your app then switches away to open a different app, this won’t record a session in Firebase (if they do this within 10 seconds). You can manually define the duration of a session: for Android within the FirebaseAnalytics class and for iOS through the FIRAnalyticsCofiguration class.

2. How does Firebase Analytics define a unique user?
In Firebase Analytics, a user is synonymous with an instance of an app this is called App Instance ID.  As the name suggests, this identifies a unique instance of the application on a device, so that if the app is uninstalled and reinstalled, it will have a distinct App Instance ID. Updating the app to a newer version does not change the App Instance ID. If you export Firebase data to BigQuery you will find this dimension under: app_instance_id now changed to user_pseudo_id

You can find the full list of dimensions exported to BigQuery here.

3. Can I manually supply my own user ID into Firebase?

Yes, you can supply your own user ID using the FirebaseAnalytics.setUserId method. You can then link the account to BigQuery and count distinct users using BigQuery. This custom user ID will show in your BigQuery table under: user_id

4. How much time does it take for Firebase analytics first report?

It takes a few hours, normally around 3-4 hours but the documentation says that the dashboard updates "a few times every day" and it can take up to 24 hours.

5. Does Firebase Analytics work offline?

Firebase with batch the events and store them locally on the device. When the device has a network connection and it’s time to upload the data, Firebase will attempt to upload the data. If the upload is successful the data is deleted from the device. If the device is offline the app will wait for connectivity before attempting to upload again.

Need help with your data platform?

We build intelligence platforms on BigQuery, Dataform and Google Cloud - from setup to ongoing optimisation.

Short answer: Yes, events are stored locally and uploaded when there is an internet connection.
Note: Data older than 72 hours will be ignored.

6. Where does Firebase Analytics gets demographics and interests data from?

On Android, the data is derived from the Android Advertising ID, which is automatically collected on devices with Google Play Services installed.

On iOS, this data is derived from the Advertising Identifier (IDFA) when available (i.e. when your app links to the Ad Support Framework).

Note: Demographic reports are thresholded for privacy reasons. Once you have enough data (at least 10 users per age/gender bracket), data for that bracket will be shown

7. Can Firebase Analytics combine the data for the Android and iOS version of the same app?

No, currently there's no way to view combined analytics for multiple apps in the same project. You can do this with BigQuery, of course, but there's no out-of-the-box solution for the Firebase Analytics reports. After recent releases, project level reporting nows allows you to see what's happening across all the apps (iOS and Android) in a project, while also being able to apply a filter to view them individually.

8. Why I can’t see custom parameters in my Firebase reports?

In order to see custom parameters in your Firebase reports you need to register these parameters with their corresponding event in the Firebase interface. To enable these parameters in Firebase go to Events, then in the row with the event you want to add the parameter click on “Edit parameter reporting”.

Note: You can register up to 50 event parameters per app (40 numeric and 10 text).

These don’t report retroactively in the UI, custom parameters only report from the point you add them. But historical data is available in BigQuery.

Need help with your data platform?

We build intelligence platforms on BigQuery, Dataform and Google Cloud - from setup to ongoing optimisation.

How ready is your data?

Take our short assessment to find out where your data stack stands and what to prioritise next.


Suggested content

BigQuery Tips: When your query is technically correct but BigQuery won't run it

There is a particular kind of frustration that comes from staring at a query you know is correct and watching it fail. No syntax error. No logic problem. Just a wall. We hit two of them on the same project. What we were building The job was to migrate ga4_daily_snapshot for a large enterprise client from a BigQuery scheduled query into a proper Dataform pipeline. The scheduled query had been added to over time until it was too large to maintain with any confidence. Moving it to Dataform w

Katie Kaczmarek17 Aug 2026

BigQuery Tips: The subquery in your WHERE clause that's scanning your entire table

There is a pattern that appears in a lot of BigQuery pipelines and looks completely reasonable. You have a control table that stores the latest processed date. Rather than hardcoding a date into your query, you pull it dynamically: SELECT * FROM `project.dataset.events` WHERE event_date = ( SELECT latest FROM `project.dataset.control_table` ); The query returns the right results. The logic is clean. And if your events table is large and date-partitioned, you might be scanning the entire

Katie Kaczmarek13 Aug 2026

BigQuery Tips: Arrays in BigQuery - what they are and how to get data out of them

If you have ever opened a GA4 export in BigQuery for the first time and found yourself looking at a column called event_params that seemed to contain an entire table inside each row, this post is for you. Arrays are not trying to make your life harder. Once you understand why they exist and what to do with them, they stop being intimidating. Why BigQuery uses arrays GA4 tracks events. Each event can have many parameters. A purchase event might have a transaction ID, a value, a currency an

Katie Kaczmarek10 Aug 2026