No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


don't use this yet.


Step 1: Install

npm install capacitor-firebase-analytics npx cap sync

Step 2: Firebase Settings File

Navigate to the project settings page for your application on Firebase.

Android: Download the google-services.json file and copy it to the android/app/ directory of your capacitor project. You will also need to add the Firebase SDK to your gradle files. More info can be found here:

iOS: Download the GoogleService-Info.plist file. In Xcode right-click on the yellow folder named, "App" and select the 'Add files to "App"'. tip: if you drag and drop your file to this location, Xcode may not be able to find it.


logEvent(options: { name: string, parameters?: object })

Logs an app event.

FirebaseAnalytics.logEvent({ name: 'event_name',  parameters: { param1: 'value1', param2: 'value2' });

setUserId(options: { userId: string })

Sets the user ID property.

FirebaseAnalytics.setUserId({ userId: '11223344' });

setUserProperty(options: { name: string, value: _string })

Sets a user property to a given value.

FirebaseAnalytics.setUserProperty({ name: 'name1', value: 'value1' });

setScreenName(options: { screenName: string, screenClassOverride?: string)

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.

FirebaseAnalytics.setScreenName({ screenName: 'screen1', screenClassOverride: 'ScreenClassName'});

appInstanceId(): Promise

The unique ID for this instance of the application.



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


Detailed Install on New Project [Android]

Step 1: Firebase App Setup

  1. On the Firebase console (, click "Add project."
  2. Click "Create Project" after naming the project and accepting the terms.
  3. Click the continue button after the project is ready.
  4. Click on the Android logo to add an app. If you are unable to find it, follow these steps:
    • In the top left, there is a cog next to "Project Overview." Click it and go to the project settings.
    • At the bottom of the general settings, click on the Android logo in the "Your apps" section to add an app.
  5. Enter a package name. Keep your browser open. You will finish this later.

Step 2: Create new project

  1. ionic start <name> <template> [options] See:
  2. cd [project-directory]
  3. npm install
  4. ionic build
  5. npm install --save @capacitor/core @capacitor/cli See:
  6. npx cap init
  7. When you are prompted for the "App Package ID", enter in the package that was entered on Step 5 of Step 1.
  8. npx cap add android

Step 3: Install Plugin

  1. npm install capacitor-firebase-analytics
  2. npx cap sync
  3. Open project in Android Studio.
  4. In the '' file, add add(CapacitorFirebaseAnalytics.class); in the this.init method call.

Step 4: Add dependencies

  1. Return to the Firebase app registration from the end of Step 1.
  2. Click "Register app"
  3. Follow the instructions for downloading the 'google-services.json' and adding the Firebase SDK.
  4. Run the app. If everything worked correctly, you should see a response on the Firebase console.
  5. More info can be found here: