Validating Google Analytics for Firebase With Debug Mode

If you’re new to Firebase or mobile apps in general, validation can be very intimidating.  Some of you might even be tempted to have your development team deploy your Analytics code to live users so that you can just review the data… don’t do that.  This post will give you all of the tools you need to QA your Google Analytics for Firebase tags in a test version of the app (or website).

What Tools Will I Need?

Let me start with some good news: you shouldn’t use a proxy like Charles or Fiddler to validate Firebase Analytics.  These are okay for validating websites, but they really are not helpful at all for mobile apps.  Instead, Firebase Analytics (and GA4F) provides a special report called DebugView that should be used for QA.  To enable DebugView on each platform, you’re going to need to install some software:

So What Is DebugView and Debug Mode?

In short, DebugView is a real-time report that allows you to isolate the events, parameters and user properties that are flowing in from a specific device where Debug Mode has been enabled. 

Without Debug Mode, Firebase will batch your events together and send across the network in bundles (which is part of the reason you shouldn’t use a proxy), but when Debug Mode is running your data will be sent immediately as you run tests on your app.  Also, data captured while Debug Mode is running will be filtered out of your other reports so that it does not artificially inflate your metrics (in other words, no more separate GA properties for production and staging).

DebugView report with Debug Mode running

TIP: Before you send over implementation requirements to your development team, you should always create tests to show how we will use DebugView to validate that each event/property/user parameter is setting correctly.

How to Enable Debug Mode on a Website

If you’re using an App + Web property and running Google Analytics for Firebase on a website, it’s very easy to enable debug mode.  All you have to do is install the Google Analytics Debugger chrome extension and flip it on.  

If you’re using a Mac like me you’ll see a new debug device called “Apple” appear, and data will start flowing into the report (sometimes I need to refresh GA4F to see my device).

How to Enable Debug Mode on an Android App

Apps are more tricky than websites because developers have a variety of tools that they can use to create and distribute test versions of an app.  The following instructions assume your dev team can provide you with an .apk file because that seems to be the most common for Android.

Step 1 is to install Android Studio and set up an emulator if you haven’t already.  Google’s documentation is okay, but if you are struggling with this I highly recommend the Lynda course “Android Studio Essential Training” by David Gassner.

Once you have the emulator open, you can just drag the .apk file to install the staging app as shown in the screenshot below.

Installing the apk file in the Android emulator

Step 2 is to use the terminal window in Android Studio navigate to the “/sdk/platform-tools/” directory.  In here you can execute the following command to enable debug mode:

./adb shell setprop debug.firebase.analytics.app <package name>

Example:

Finally, step 3 is to open the app in the emulator and take a look at the DebugView report.  After about 30 seconds you should see a new device logging events.

How to Enable Debug Mode on an iOS App

As mentioned above, developers have a variety of tools that they can use to create and distribute test versions of an app.  The following instructions assume your dev team is using TestFlight to distribute test versions of the app because that seems to be the most common for iOS.

Step 1 is to make sure your app developers know to enable Debug Mode in the test version of the iOS app, and ask them to add you to TestFlight.

Step 2 is to install the TestFlight app on your iOS device, and then open the invitation email you received from TestFlight and click the links to download the test app.

At this point all you need to do is open the test app and wait 60 seconds for data to start populating in the DebugView report.

One Reply to “Validating Google Analytics for Firebase With Debug Mode”

  1. Hi,

    Maybe worth mentioning this method is unfortunately useless if you’re trying to QA Enhanced Ecommerce requests in mobile apps, given that none of the item information is visible in Firebase (unless maybe they’ve updated that in the past 2-3 months). In this case Charles is still the only viable option.

    Best!

Leave a Reply

Your email address will not be published.