Firebase
Firebase Crashlytics data available via Google APIs cannot be used for calculating aggregate stats like crash-free rate or adoption rate, because it only contains info on unhealthy sessions: without info on healthy session stats, there is no denominator for crash-free rates or adoption.
As a result, Runway's stability monitoring integration for Firebase relies on Google Analytics data, and that data must be exported from Firebase to BigQuery so that Runway can query it.
Set up in Firebase
Find your Firebase Project ID
Navigate to your Firebase console (๐ https://console.firebase.google.com), and select the Firebase project for your app(s)
Click on the gear icon top left, choose โProject settingsโ
On the โGeneralโ tab, make note of the Project ID. Youโll need to enter this value in Runway shortly
Find your Google Analytics Property ID
Click on the Integrations tab
Next, ensure that the Google Analytics tile in your Firebase console is showing the status "Enabled". If itโs not, you'll need to ๐ set up and enable Google Analytics in your project
Click into the Google Analytics tile. It should show your app(s) in the bottom section, and at the top there should be a Property ID. Grab that value; youโll need to enter it shortly in Runway
Click the link under "Linked Google Analytics account"
Under "Product links", click "BigQuery links"
Click on the row for your Firebase project
On the sheet that opens, under 'Event data', ensure that at least one 'Export type' is selected
BigQuery + GA settings
Setting up BigQuery is required because Google doesn't expose user- and session-level stability data directly via Firebase APIs.
Data processed, and therefore costs, can be variable depending on each team's data volume and other factors. We recommend adding user- and/or project-level quotas to cap query data processed per day. More information is available here: ๐ Controlling your BigQuery costs - Google Cloud
If your team doesn't otherwise use Google Analytics, one way to limit data volume is to filter the events it sends/ingests. The only events Runway needs for this integration to work are session_start
and app_exception
. See Google documentation around data and filtering here: ๐ BigQuery Export limits and data filtering
Click back up to Integrations
Click into the BigQuery tile. If you havenโt yet linked BigQuery to Firebase, youโll be prompted to do so. Once youโre linked, youโll see a list of integrations to configure. Or, if you were already linked, youโll also see that list of integrations
Find the Google Analytics integration, and flip that switch ON
In Apps exporting, make sure the app(s) in question are selected
In Export settings, make sure at least the โDailyโ option is selected
Note that you must be on a Firebase paid plan to select โStreamingโ exports in Export settings, and without โStreamingโ enabled, data flowing into Runway wonโt be real-time.
For BigQuery exports that have been turned on for the first time, it may take a day before the data starts populating in BigQuery.
Save your settings.
Service account / API key setup
Head to the ๐ Google Cloud Platform console
Make sure youโre logged in with an appropriate Google account, and that the project that contains the BigQuery instance you linked with Firebase is selected in the project selector (top left)
In the left hand menu, select IAM & Admin and then Service Accounts
Click + Create Service Account
Fill out the form then click Create and Continue
In step 2, select roles. Youโll need to select the BigQuery Job User and BigQuery Data Viewer roles at minimum. If you want to share a service account between Runwayโs stability monitoring integration and your Google Play and/or Play Beta integrations, add additional roles as needed (Play Console and BigQuery will need to live under the same project for this to work)
On the service account you just created, click the three dots on the right hand side, and select Manage keys
Click Add Key, then Create new key
Select the JSON option and click Create
Your Google API key file should start downloading
Set up in Runway
Navigate to the Integration settings view
Select an app in the top left corner from the Switcher
Navigate to App Settings by clicking the gear icon (โ๏ธ) at the top of the Timeline sidebar
Click on Integrations in the sidebar
Connect Firebase
Find the Firebase integration module under the Stability monitoring section
Click the Connect button
Add your Google API key file, Project ID and GA Property ID from the previous steps to complete your integration setup.
Last updated
Was this helpful?