Firebase Installations SDK

Firebase Installations SDK (google/firebaseinstallations)

operated by: Google LLC (get company information on

The Firebase Installations service (FIS) provides a unique identifier for each installed instance of a Firebase app, called Firebase installation ID (FID). Source “Many Firebase services depend on the Firebase Installations API in order to identify app installs and/or authenticate client requests to their servers.” Source Other purposes include user segmentation, message delivery, performance monitoring, tracking the number of unique users, or selecting which configuration values to return. Source

FIDs can also be used by Google Analytics for attribution. Source

Endpoint URLs

These are URLs or regexes of endpoints the tracker sends data to. We use these to determine which adapter to apply to a request. Some trackers use the same endpoint for several formats. In this case we use additional logic to match the adapter to the request, refer to the code for more information.
  • /^https:\/\/firebaseinstallations\.googleapis\.com\/v1\/projects\/.+\/installations\/?$/

Decoding steps

Every tracking library has its own way of transmitting tracking data, often even several. They are regularly pretty convoluted, nested encoding schemes. Because of that, the adapter needs to decode the request information into a consistent format. We try to keep keys and paths intact, but the structure results from our decoding. All steps used in the decoding for this adapter are documented here.
  1. Parse the request body as JSON. Store that in the result for the request body.
  2. Get the property at JSONPath $ in the request headers. Store that in the result for the request headers.
1res.body = parseJson(body)
2res.header = header.$

Observed data transmissions

This is data that we observed being transmitted by this tracker. Not every request contains all of this data. The context of the data describes where we found the data in the request, the path describes the location of the data in the decoded request. The examples are a selection of observed values.
PropertyContextPathExamples of observed values
App IDheaderX-Android-Packagecom.scorp.who
Other unique identifiers for the user, device, session, or installationbodyfid Tracker documentation on this propertydYPvivoVTOWuVT5l_T_rmF
Tracker SDK versionbodysdkVersiona:16.3.3
headerx-firebase-clientkotlin/1.4.10 fire-auth/19.4.0 fire-analytics/17.6.0 fire-installations/16.3.3 fire-fst/21.7.1 fire-iid/20.3.0 fire-gcs/19.2.0 fire-fcm/20.1.7_1p fire-android/ fire-cls/17.2.2 fire-fn/19.1.0 fire-core/19.3.1
kotlin/1.4.10 fire-installations/16.3.3 fire-iid/20.2.3 fire-android/ fire-fcm/20.2.4 fire-analytics/17.5.0 fire-core/19.3.1
fire-installations/16.3.3 fire-rc/20.0.0 kotlin/1.3.72 fire-iid/21.0.0 fire-fcm/20.1.7_1p fire-abt/20.0.0 fire-analytics/18.0.0 fire-android/ fire-cls/17.2.2 fire-core/19.3.1
fire-installations/16.3.3 fire-rc/19.2.0 fire-iid/20.2.4 fire-android/ fire-fcm/20.2.4 fire-analytics/17.5.0 fire-core/19.3.1 fire-abt/19.1.0
fire-analytics/17.6.0 fire-installations/16.3.2 kotlin/1.3.50 fire-android/ fire-core/19.3.1