During the summer of 2019, Google announced a new feature allowing marketing teams to merge analytics from mobile applications and websites into one tool. The feature is now available as a beta on Google Analytics new properties App + Web. It gives access to the new Analysis hub, where both data from your website and your applications are available.
Today we are going to set up your Firebase and Google Analytics accounts to make these new features available with the data of the Batch SDK.
1. Wiring up the Batch SDK to Firebase
First, we need to wire up Batch SDK to Firebase. The easiest way to achieve this is to install the Firebase Events Dispatcher into your application. This small plugin will make Batch's data available on your Firebase dashboard.
More details are available in our technical documentation for Android and iOS.
2. Linking your Firebase project to your Google Analytics
Once your Firebase project is created and set up with the Batch SDK (and the dispatcher installed), you need to link your Firebase project to a Google Analytics property.
Go to your Firebase dashboard, select your project, click on the ⚙️ in the top left corner, and then on Project settings. On the new page, click on the Integrations tab.
a. My Firebase project isn’t linked to GA
Depending on your Firebase configuration, you might not have enabled Google Analytics for your project.
If you see the option Enable on the card, then you need to choose or create a Google Analytics account on which your applications' data will be linked (a new property App + Web will be automatically created in the selected Google Analytics account).
b. My Firebase project is linked to GA
If your Firebase project is already linked, you need to make sure to upgrade your link to gain access to the new beta features.
To do so, click on Manage then under your Google Analytics configuration, a banner will offer you to Begin upgrade, click on it, then choose or create a Google Analytics account on which your applications' data will be linked (a new property App + Web will be automatically created).
Note: If you can't see the banner, it's probably because your Google Analytics link has already been upgraded, simply move on to the next step.
3. Merge my website and app data
Go to your Google Analytics dashboard, you should see a new property in your account, labelled as App + Web:
Select that new property, then click on ⚙️Admin in the bottom left corner, then click on Data Streams in the property column. Under the All data streams tab, you should see your applications (Android and/or iOS) from your Firebase project (if you do not have any applications in your Firebase project, then click the Web button).
Click on the Web tab, and move on to the next step.
a. I don’t have Google Analytics on my website
If you don’t have Google Analytics on your website, you can add one now, data will be directly merged with your application’s data.
On top of the form, fill in the Website URL and Stream name of which you want to track data and then click Create Stream.
Optional: Click on the Web tab, and under Tagging Instructions > Add new on-page tag follow the instructions to add Google Analytics to your website. If you don’t know how to do it, you can skip this step but keep in mind that your website data won’t show on your dashboard.
b. I already have Google Analytics on my website
If you already have Google Analytics tracking your website, you need to fill in the exact same Website URL as in your property (you can find it under ⚙️Admin > Property Settings > Default URL), also fill in the Stream name input, then click on Create stream.
Now under Tagging Instructions > Use existing on-page tag, expand the Google Analytics block and follow the instructions to add your new Measurement ID to your existing property.
Congratulations! You have successfully set up the new Google Analytics dashboard App + Web. You can now access data from your website and your app on the same dashboard, take a look around, for example under Technology in the left menu, you can now inspect platform-specific metrics.
Note: you may have to wait 24 hours to see website data in your dashboard, but if you can see the Technology > Web option in your menu, your configuration is done.
4. Create and tag your campaigns
Now that everything is set up, you need to send campaigns to create data on your Firebase and Google Analytics project.
To know how to properly tag your campaigns, you can follow this article.
5. Use Batch data on my dashboard
Now that you have data on your dashboard, we will need to flag specific events and parameters from the Batch SDK. To achieve this, go back to your Firebase dashboard, and click on Analytics > Events in the left menu.
In the list you should see events starting with batch_:
If you can’t see them, make sure the Firebase dispatcher is correctly installed and working (you can send a test push from the Batch dashboard to create events on your Firebase Dashboard).
a. Configure parameters
For each Batch event, a set of parameters is available (corresponding to your UTM tags), to set one click on the three dots at the end of the line of any batch event and click Edit parameter reporting, in the modal, you can add any of the following parameters (always as Text type).
Here is an example of the batch_in_app_show event after being configured:
Note: you’re limited to 50 text parameters per Firebase project, so you should only set up parameters that you want to use in your reports, if you don’t know which one to use yet, start with the campaign parameter and move on to the next step.
b. Create my first report in Google Analytics
Go back to Google Analytics dashboard, click on Analysis > Analysis Hub, then click on the + card on top of the page to create a new analysis.
In the left menu click on the + next to Dimensions, in the list showing on the right side of the screen you should find the parameters you have added on the Firebase dashboard, check them to add them to your analysis. You can now use those dimensions to draw graphs and tables!