cordova-plugin-firebase-analytics

Cordova plugin for Firebase Analytics

Installation

cordova plugin add https://github.com/SamDelgado/cordova-plugin-firebase-analytics --save

Go to your firebase console and export google-services.json and GoogleService-Info.plist. Put those files into the root of your cordova app folder.

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

Requirements

• cordova >= 6.4.0
• cordova-ios >= 4.3.0

Supported Platforms

• iOS
• Android

IOS Quirks

if you want to open the project with xcode you should use XCWorkspace file not xcodeproj file or you will run with some not found issues.

IOS common issues

if you run with "duplication" issues after using this plugin that's mean there's another plugin using same dependencies of this plugin but without using cocoapods so you should call the author of that plugin to start using cocoapods or update that plugin to version that using cocoapods.

Android common issues

if you run with "Multi dex" issues after using this plugin that's mean there's another plugin using old version of google services, and in gradle that's not allowed so you should use same version via downgrade google services of this plugin or upgrade the google services of that plugin, you have to decide what is the right choice.

Methods

logEvent(name, params)

Logs an app event.

window.cordova.plugins.firebase.analytics.logEvent("page_view", {page: "dashboard"});

Be aware of automatically collected events.

setUserId(id)

Sets the user ID property.

window.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.

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

Be aware of automatically collected user properties.

setEnabled(enabled)

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

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

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.

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