If you’re new to Google Analytics 4 validation can be very intimidating (especially for mobile apps). 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 captured data… don’t do that. This post will give you all of the tools you need to QA your Google Analytics 4 tags in a test version of your app or website using Debug Mode.
What Tools Will I Need?
Let me start with some good news: you shouldn’t use a proxy like Charles or Fiddler to validate GA4. These are okay for validating websites, but they really are not helpful at all for mobile apps. Instead, Google Analytics 4 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:
- Websites: The Google Analytics Debugger Chrome Extension
- Android Apps: Android Studio
- iOS Apps: An iOS device (like an iPhone or iPad)
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, GA4 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).
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 Google Analytics 4 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 GA4 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.
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>
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.