Tracking white-label app activity with Google Analytics 4 (GA4)
  • 12 Sep 2023
  • 2 Minutes to read

Tracking white-label app activity with Google Analytics 4 (GA4)


Article Summary

You can track a number of GA4 events through your white-label version of the Passport app, the same way you do on your Members Portal.

GA4 tracking on Android and iOS is reserved to customers using a white-label version of the Passport app.

If you're using the standard version of Passport, you can upgrade to the white-label app to make the most of this integration or only use GA4 tracking on your Members Portal.


Installing Google Analytics 4 on your white-label app

Using GA4 on your white-label app is a three-step process:

  1. Create two data stream - one for iOS and one for Android in your GA4 account
  2. Ask support to re-release of your white-label app
  3. Let your customers know they need to update their app

Step 1. Create data streams for Android and iOS in your GA4 account

You need to create 2 separate data streams, one for iOS and one for Android, under the same GA4 property. We recommend using same GA4 property for your Members Portal and app to track all data stream events under a single property.

iOS

  1. Go to analytics.google.com.
  2. Open the relevant property.
  3. Click on the cog icon in the navigation menu.
  4. Click on Data Streams.
  5. Click Add stream.
  6. Click on iOS app.
  7. Add your iOS bundle ID.
This bundle ID is usually com.nexudusspaces.{your white label app name}

Make sure your white-label app domain doesn't have any spaces or special characters.

For example, com.nexudusspaces.kalkiospaces or com.nexudusspaces.kalkionetwork

When in doubt, just reach out to us to find your bundle ID.

  1. Name your app.
  2. Click Register app
  3. Click on Download GoogleService-Info.plist.

The download should only take a few seconds. Once you've downloaded the package for iOS. You need to repeat the process for Android.

Android

  1. Go to analytics.google.com.
  2. Open the relevant property.
  3. Click on the cog icon in the navigation menu.
  4. Click on Data Streams.
  5. Click Add stream.
  6. Click on Android app.
  7. Add your Package name.
This package name is usually com.nexudusspaces.{your white label app name}

Make sure your white-label app domain doesn't have any spaces or special characters.
For example, com.nexudusspaces.kalkiospaces or com.nexudusspaces.kalkionetwork

When in doubt, just reach out to us to find your package name.

  1. Name your app.
  2. Click Register app
  3. Click on Download GoogleService.json.

The download should only take a few seconds. Once you've downloaded the package for iOS and Android, you're ready to move to the second step.

Step 2. Contact support to re-release of your white-label app

Once you have both iOS and Android downloads, contact support sharing both files with them. Our team will handle your app re-release request as soon as possible. Once our team confirms your app's been re-released, you can move to the third and last step.

Step 3. Let your customers know they need to update their app

Customers that have automatic updates enabled for your app will automatically be moved to the latest version when it's released. For customers who have this option disabled, they'll need to manually update your app on their phone for you to be able to track the supported GA4 events.

You can reach out to your customers via email, a reminder on a set day, or even a newsletter update.


What's Next