npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@fttx/cordova-plugin-firebase-analytics

v8.2.2

Published

Cordova plugin for Firebase Analytics

Downloads

11

Readme

Cordova plugin for Firebase Analytics

NPM version NPM downloads NPM total downloads PayPal donate Twitter

| Donate | Your help is appreciated. Create a PR, submit a bug or just grab me :beer: | |-|-|

Index

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

Use variables ANDROID_FIREBASE_BOM_VERSION or IOS_FIREBASE_POD_VERSION to override dependency versions for Firebase SDKs:

$ cordova plugin add cordova-plugin-firebase-analytics \
    --variable IOS_FIREBASE_POD_VERSION="9.3.0" \
    --variable ANDROID_FIREBASE_BOM_VERSION="30.3.1"

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

Disabling analytics data collection

In some cases, you may wish to temporarily or permanently disable collection of Analytics data. You can set the value of variable ANALYTICS_COLLECTION_ENABLED to false to prevent collecting any user data:

$ cordova plugin add cordova-plugin-firebase-analytics \
    --variable ANALYTICS_COLLECTION_ENABLED=false

Later you can re-enable analytics data collection (for instance after getting end-user consent) using method setEnabled.

Disabling automatic screen collection

In order to disable automatic collection of screen view events set the value of variable AUTOMATIC_SCREEN_REPORTING_ENABLED to false:

$ cordova plugin add cordova-plugin-firebase-analytics \
    --variable AUTOMATIC_SCREEN_REPORTING_ENABLED=false

Adding required configuration files

Cordova supports resource-file tag for easy copying resources files. Firebase SDK requires google-services.json on Android and GoogleService-Info.plist on iOS platforms.

  1. Put google-services.json and/or GoogleService-Info.plist into the root directory of your Cordova project
  2. Add new tag for Android platform
<platform name="android">
    ...
    <resource-file src="google-services.json" target="app/google-services.json" />
</platform>
...
<platform name="ios">
    ...
    <resource-file src="GoogleService-Info.plist" />
</platform>

This way config files will be copied on cordova prepare step.

Functions

logEvent

logEvent(name, params): Promise<void>

Logs an app event.

Example

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

Parameters

| Name | Type | Description | | :------ | :------ | :------ | | name | string | Enent name | | params | Record<string, string | number | object[]> | Event parameters |

Returns

Promise<void>

Callback when operation is completed


resetAnalyticsData

resetAnalyticsData(): Promise<void>

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

Example

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

Returns

Promise<void>

Callback when operation is completed


setCurrentScreen

setCurrentScreen(screenName): Promise<void>

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.

Example

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

Parameters

| Name | Type | Description | | :------ | :------ | :------ | | screenName | string | Current screen name |

Returns

Promise<void>

Callback when operation is completed


setDefaultEventParameters

setDefaultEventParameters(defaults): Promise<void>

Adds parameters that will be set on every event logged from the SDK, including automatic ones.

Example

cordova.plugins.firebase.analytics.setDefaultEventParameters({foo: "bar"});

Parameters

| Name | Type | Description | | :------ | :------ | :------ | | defaults | Record<string, string | number | object[]> | Key-value default parameters map |

Returns

Promise<void>

Callback when operation is completed


setEnabled

setEnabled(enabled): Promise<void>

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

Example

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

setAnalyticsConsent

setAnalyticsConsent(json object): Promise<void>

Sets the consent map

Example

cordova.plugins.firebase.analytics.setAnalyticsConsent({
    "GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE": true,
    "GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE": true,
    "GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA": true,
    "GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS": true
});

Parameters

| Name | Type | Description | | :------ | :------ | :------ | | enabled | boolean | Flag that specifies new state |

Returns

Promise<void>

Callback when operation is completed


setUserId

setUserId(userId): Promise<void>

Sets the user ID property. This feature must be used in accordance with Google's Privacy Policy.

See

https://www.google.com/policies/privacy

Example

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

Parameters

| Name | Type | Description | | :------ | :------ | :------ | | userId | string | User's indentifier string |

Returns

Promise<void>

Callback when operation is completed


setUserProperty

setUserProperty(name, value): Promise<void>

Sets a user property to a given value. Be aware of automatically collected user properties.

See

https://support.google.com/firebase/answer/6317486?hl=en&ref_topic=6317484

Example

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

Parameters

| Name | Type | Description | | :------ | :------ | :------ | | name | string | Property name | | value | string | Property value |

Returns

Promise<void>

Callback when operation is completed