Predefined user dimensions

User dimension Type Description
Age Text Identifies users by six categories: 18-24, 25-34, 35-44, 45-54, 55-64, and 65+.
App Store Text The store from which the app was downloaded and installed.
App Version Text The versionName (Android) or the Bundle version (iOS).
Country Text The country the user resides in.
Device Brand Text The brand name of the mobile device (e.g., Motorola, LG, or Samsung).
Device Category Text The category of the mobile device (e.g., mobile or tablet).
Device Model Text The mobile device model name (e.g., iPhone 5s or SM-J500M).
First Open Time Number The time (in milliseconds, UTC) at which the user first opened the app, rounded up to the next hour.
Gender Text Identifies users as either male or female.
Interests Text Lists the interests of the user (e.g., "Arts & Entertainment, Games, Sports").
Language Text The language setting of the device OS (e.g., en-us or pt-br).
New/Established N/A New: First opened the app within the last 7 days.
Established: First opened the app more than 7 days ago.
OS Version Text The version of the device OS (e.g., 9.3.2 or 5.1.1).

Automatically collected events

Analytics collects these events by default.

Automatically collected events are triggered by basic interactions with your app.

Analytics collects these events for Android and iOS apps unless otherwise stated.

Event name Automatically triggered Parameters
ad_click when a user clicks an ad
Publisher events coming from AdMob via the Google Mobile Ads SDK		 ad_event_id
ad_exposure when at least one ad served by the Mobile Ads SDK is on screen firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time
ad_impression when a user sees an ad impression
Publisher events coming from AdMob via the Google Mobile Ads SDK		 ad_event_id
ad_query when an ad request is made by the Mobile Ads SDK ad_event_id
ad_reward when a reward is granted by a rewarded ad served by the Mobile Ads SDK ad_unit_id, reward_type, reward_value
adunit_exposure when an ad unit served by the Mobile Ads SDK is on screen firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time
app_clear_data when the user resets/clears the app data, removing all settings and sign-in data  
app_exception when the app crashes or throws an exception fatal, timestamp, engagement_time_msec
app_remove

when an application package is removed or "uninstalled" from an Android device

Android only

This event is different from the Daily uninstalls by device and Daily uninstalls by user metrics, which are both reported by Google Play Developer Console. The app_remove event counts the removal of application packages, regardless of the installation source, and the count changes depending on the date range you are using for the report. The Daily uninstalls by device and Daily uninstalls by user metrics count the removal of application packages only when they were installed from Google Play, and are reported on a daily basis.

  
app_store_refund

when an in-app purchase is refunded by Google Play

Android only

This event is not exported to BigQuery.

 product_id, value, currency, quantity
app_store_subscription_cancel

when a paid subscription is cancelled in Google Play

Android only

Requires an initial subscription that was made on or after July 1, 2019.

This event is not exported to BigQuery.

 product_id, price, value, currency, cancellation_reason
app_store_subscription_convert

when a free-trial subscription is converted to a paid subscription

This event is set as a default conversion.

Android requires an initial subscription that was made on or after July 1, 2019. An initial free-trial subscription is logged as an in_app_purchase with the subscription parameter set to true.

This event is not exported to BigQuery.

 product_id, price, value, currency, quantity
app_store_subscription_renew

when a paid subscription is renewed

This event is set as a default conversion.

Android requires an initial subscription that was made on or after July 1, 2019.

This event is not exported to BigQuery.

 product_id, price, value, currency, quantity, renewal_count
app_update

when the app is updated to a new version and launched again 

The previous app version id is passed as a parameter.

This event is conceptually different from the Daily upgrades by device metric, which is reported by Google Play Developer Console.  An upgrade refers to the updating of the application binary, whereas an app_update event is triggered upon the subsequent launch of the upgraded app.

 previous_app_version
dynamic_link_app_open when a user re-opens the app via a dynamic link. source, medium, campaign, link_id, accept_time
dynamic_link_app_update

when the app is updated to a new version and is opened via a dynamic link.

Android only

 source, medium, campaign, link_id, accept_time
dynamic_link_first_open when a user opens the app for the first time via a dynamic link. source, medium, campaign, link_id, accept_time
first_open the first time a user launches an app after installing or re-installing it

This event is not triggered when a user downloads the app onto a device, but instead when he or she first uses it. To see raw download numbers, look in Google Play Developer Console or in iTunesConnect.		 previous_gmp_app_id, updated_with_analytics, previous_first_open_count, system_app, system_app_update, deferred_analytics_collection, reset_analytics_cause, engagement_time_msec
in_app_purchase

when a user completes an in-app purchase, including an initial subscription, that is processed by the App Store on iTunes or by Google Play

The product ID, product name (iOS only), currency, and quantity are passed as parameters.

To see in_app_purchase data for Android apps, you need to link Firebase to Google Play.

Analytics supports automatic subscription tracking on Android and iOS.

This event is triggered only by versions of your app that include the Firebase SDK. Note: paid-app purchase revenue and refunds (iOS only) are not automatically tracked. Your reported revenue may differ from the values you see in the Google Play Developer Console. Events that are flagged as being invalid or as sandbox (test) are ignored. Only iOS events are flagged as sandbox. Learn more about testing Google Play billing.

 product_id, price, value, currency, quantity, subscription, free_trial, introductory_price
notification_dismiss

when a user dismisses a notification sent by FCM.

Android only

 message_name, message_time, message_device_time, message_id, topic, label, message_channel
notification_foreground when a notification sent by FCM is received while the app is in the foreground. message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type
notification_open when a user opens a notification sent by FCM. message_name, message_time, message_device_time, message_id, topic, label, message_channel
notification_receive when a notification sent by FCM is received by a device. Android apps only. message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type
os_update

when the device operating system is updated to a new version.

The previous operating system version id is passed as a parameter.

 previous_os_version
screen_view when a screen transition occurs and any of the following criteria are met:
 
  • No screen was previously set
  • The new screen name differs from the previous screen name
  • The new screen-class name differs from the previous screen-class name
  • The new screen id differs from the previous screen id
 firebase_screen, firebase_screen_class, firebase_screen_id, firebase_previous_screen, firebase_previous_class, firebase_previous_id, engagement_time_msec
session_start when a user engages with your site or app.  
user_engagement periodically, while the app is in the foreground. engagement_time_msec

The above content is based on Google documentation:https://support.google.com/firebase/answer/6317485
https://support.google.com/firebase/answer/6317486