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
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:
- Adjust the access level for Firebase users to Analytics data
- Turn off enhanced audience integration (the feature is on by default)
To open these settings:
- Under PRODUCT LINKS, click Firebase Links.
- Find the row for the relevant Firebase project ID.
User access (roles in Analytics)
Firebase project users are automatically granted Analytics roles when you link a Firebase project to an Analytics property:
- Firebase users in a project, based on their highest Firebase firebaseanalytics permission, are assigned to one of four Firebase linked users:
- Firebase project <project number> Editor
- Firebase project <project number> Marketer
- Firebase project <project number> Viewer (no data restrictions)
- Firebase project <project number> Viewer (no access to cost or revenue data)
- The Firebase linked users are in turn assigned to default roles in the linked Analytics property.
| If you have this Firebase role/permission | You are assigned to this Firebase linked user | Which is assinged this Analytics role |
|---|---|---|
|
firebaseanalytics.resources.googleAnalyticsEdit |
Firebase project <project number> Editor |
Editor No data restrictions |
| firebaseanalytics.resources.googleAnalyticsAdditionalAccess | Firebase project <project number> Marketer | Marketer |
|
firebaseanalytics.resources.googleAnalyticsReadAndAnalyze |
Firebase project <project number> Viewer |
Viewer No data restrictions |
| firebaseanalytics.resources.googleAnalyticsRestricedAccess | Firebase project <project number> Viewer |
Viewer No access to cost or revenue data |
In Analytics access management, each Firebase linked user represents a group of users in the linked Firebase project.
As an Analytics Administrator, you can change the Analytics role and data restrictions that are assigned to a property's Firebase linked users. If you change the Analytics role and data restrictions assigned to a Firebase linked user, you affect everyone in the Firebase project that is assigned to that linked user.
The role assignments and data restrictions persist until the link between the Firebase project and the Analytics property is deleted.
Analytics Administrators can edit access for the Firebase roles in Admin > linked property > Property Access Management.
For example, you can restrict access to cost and revenue data in the Firebase Console, if users in the Firebase project don't need to see that information:
- In the Property column, click Property Access Management.
- Click the row for the Firebase user whose data access you want to restrict.
- Under Data restrictions, select No Cost Metrics and/or No Revenue Metrics.
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.
To use the option to automatically create a new Google Analytics 4 property, you need to have the Firebase permission firebaseanalytics.resources.googleAnalyticsEdit, which is included in the Firebases roles Owner, Editor, and Firebase Admin.
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 Analytics user roles based on their Firebase roles (see User access above).
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.