To preserve historical Google Analytics for Firebase app data from an existing Firebase project, use the Google Analytics 4 property already linked to that Firebase project instead of creating a new property.
If you do not currently have a Google Analytics 4 property:
Starting from Google Analytics
Create a Google Analytics 4 property
To measure app data in Analytics, you need to create a corresponding project in Firebase and establish a link between that project and your property.
Learn more about creating a Google Analytics 4 property
Firebase users who have access to that project and who have the Firebase permission firebaseanalytics.resources.googleAnalyticsEdit, such as Project Owners, also effectively have the Editor role for the linked Google Analytics 4 property by default.
Update settings after creating the link
After you create a Google Analytics 4 property and establish the link to your Firebase project, you have options to:
- Set the default Analytics role assigned to a Firebase role
- Turn off enhanced audience integration (the feature is on by default)
To open these settings:
- Click Admin.
- At the top of the Property column, use the dropdown selector to select the property you want to edit.
- Under Product Linking, click Firebase Linking.
- Find the row for the relevant Firebase project ID.
User access (roles in Analytics)
Firebase users are given the following Analytics roles based on their Firebase roles:
| Firebase role | Analytics role |
|---|---|
| Reader | Viewer |
| Editor | Editor |
| Custom role with RestrictedAccess permission | Viewer, No Revenue Data, No Cost Data |
The role assignments persist until the link between Firebase and GA4 is deleted.
Analytics will create one virtual user for each Firebase role. Analytics Administrators can edit access for those virtual users in Admin > linked property > Property Access Management.
Enhanced audience integration
Enhanced audience integration provides the following benefits:
- Prepopulate audiences exported to Firebase with up to 30 days of data when that data is available.
- Export predictive audiences and audiences based on dynamic evaluation and/or time-windowed metrics from Analytics to Firebase.
The feature is on by default after you create the link. Turn the feature off if necessary.
Starting from Firebase
If you previously enabled Analytics for your Firebase project, then when you upgrade your project, your project is automatically linked to a Google Analytics 4 property.
If you did not initially enable Analytics for your project but choose to later, then you have the option to automatically create a new Google Analytics 4 property or you can link to an existing Google Analytics 4 property.
| Firebase role | Analytics role |
|---|---|
| Reader | Viewer |
| Editor | Editor |
| Custom role with RestrictedAccess permission | Viewer, No Revenue Data, No Cost Data |
The role assignments persist until the link between Firebase and GA4 is deleted.
Analytics will create one virtual user for each Firebase role. Analytics Administrators can edit access for those virtual users in Admin > linked property > Property Access Management.
Create a project
When you create a project in Firebase, you have the option to integrate with Analytics. If you already have one or more Google Analytics accounts, you can associate your project with one of those. If you do not already have a Google Analytics Account, a new one will be created for you with the name Default Account for Firebase.
Firebase users who have access to that project are given the following Analytics user roles, based on their Firebase roles. These role assignments determine the visibility the Firebase user has in the Firebase console.
Link your Firebase project to Analytics
Firebase Owners can set up and manage the Analytics link under Project Settings > Integrations.
Set up a new Analytics link
- Open your Firebase project.
- Open Project settings > Integrations.
- On the Google Analytics card, click Link.
- Select an Analytics Account or create a new one.
- If you select an existing account, you have the option to select an existing Google Analytics 4 property in that account or to create a new property.
- If you create a new account, then a new Google Analytics 4 property is created for you and your project is linked to that property.
- Learn more about setup and limits
- Configure your Analytics settings.
Edit an Analytics link
- Open your Firebase project.
- Open Project settings > Integrations.
- On the Google Analytics card, click View link.
- Remove the existing Analytics link.
- Follow the instructions for setting up a new Analytics link.
Relink your Firebase project
If you had previously linked your Firebase project with your Analytics account but are no longer able to locate your Firebase project in Analytics:
- Open your Firebase project.
- Open Project settings > Integrations.
- Click the Analytics card to link Analytics to your project.
Unlink Analytics from your Firebase project
Firebase Owners can unlink Analytics under Project Settings > Integrations.