Cordova plugin for Firebase Analytics

	Your help is appreciated. Create a PR, submit a bug or just grab me 🍺

Index

• Supported platforms
• Installation
• Methods

Supported platforms

• iOS
• Android

Installation

$ cordova plugin add cordova-plugin-firebase-analytics

If you get an error about CocoaPods being unable to find compatible versions, run

$ pod repo update

Plugin depends on cordova-support-google-services for setting up google services properly. Please read the README carefully in order to avoid common issues with a project configuration.

Use variable FIREBASE_ANALYTICS_VERSION to override dependency version on Android.

NOTE: on iOS in order to collect demographic, age, gender data etc. you should additionally include AdSupport.framework into your project.

Methods

Every method returns a promise that fulfills when a call was successful.

logEvent(name, params)

Logs an app event.

cordova.plugins.firebase.analytics.logEvent("my_event", {param1: "value1"});

Be aware of automatically collected events.

setUserId(id)

Sets the user ID property.

cordova.plugins.firebase.analytics.setUserId("12345");

This feature must be used in accordance with Google's Privacy Policy.

setUserProperty(name, value)

Sets a user property to a given value.

cordova.plugins.firebase.analytics.setUserProperty("name1", "value1");

Be aware of automatically collected user properties.

setCurrentScreen(name)

Sets the current screen name, which specifies the current visual context in your app. This helps identify the areas in your app where users spend their time and how they interact with your app.

cordova.plugins.firebase.analytics.setCurrentScreen("User profile");

setEnabled(enabled)

Sets whether analytics collection is enabled for this app on this device.

cordova.plugins.firebase.analytics.setEnabled(false);

resetAnalyticsData()

Clears all analytics data for this instance from the device and resets the app instance ID

cordova.plugins.firebase.analytics.resetAnalyticsData();