This article is about Google Analytics 4 properties. If you're using a Universal Analytics property, refer to the Universal Analytics section of this help center.

[GA4] Firebase integration

Link Google Analytics 4 properties to Firebase.

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:

  1. Create a new Google Analytics 4 property.
  2. During property creation, skip the step of adding an app data stream.
  3. Link your existing Firebase project to the new 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:

  1. Click Admin.
  2. At the top of the Property column, use the dropdown selector to select the property you want to edit.
  3. Under Product Linking, click Firebase Linking.
  4. 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:

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

  1. Open your Firebase project.
  2. Open Project settings > Integrations.
  3. On the Google Analytics card, click Link.
  4. 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
  5. Configure your Analytics settings.

Edit an Analytics link

  1. Open your Firebase project.
  2. Open Project settings > Integrations.
  3. On the Google Analytics card, click View link.
  4. Remove the existing Analytics link.
  5. 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:

  1. Open your Firebase project.
  2. Open Project settings > Integrations.
  3. 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.

Was this helpful?
How can we improve it?
Search
Clear search
Close search
Google apps
Main menu
Search Help Center
true
69256
false