Support Center

Connecting your Google Analytics account with apps made with Shoutem

Last Updated: May 24, 2016 10:27AM CEST
As you may know already, Shoutem integrates with Google Analytics service, to bring you usage details for all of your apps created under our service. Those analytics are visible within the Statistics tab, inside of our app builder, for every published app.

That being said, more extensive data is available directly from within the Google Analytics service. For our regular users, we will happily provide you with an invitation to check your app's analytics. However, for our reseller clients, it is a bit more complicated, as the process involves a lot more apps.

This guide will show you how to setup your Google Analytics instance that can track multiple apps, located under one reseller account.
 

Setting up your Google Analytics account


If you don't have a GA account created yet, you can do so from here. If you do have an account already, log in via this link. Once logged in, switch to the Admin tab, from the list in the top left. For the users that have just created the GA account, new Account entity is started automatically, and you can follow the instructions below.
 

Here, we need to create a new account. This "Account" will hold the data for all of your apps on Shoutem. In case you already have another account, select the dropdown menu, under the Account section, and click the "create new account" button.

Creating your tracking account


Continuing the process above, we need to create a new tracking account, that will be used as a connector between GA service, and your mobile app. 

Fill in the following details :
 
  1. App type: Mobile app
  2. Account name: Name for your tracking account
  3. App name: Name for your tracking app ( this is mostly used in cases where you have multiple apps active one one account. In our case, we'll be using only one, so enter something recognisable here ).
  4. Industry category: Choose your area of business
  5. Reporting time zone: Time zone that will be used in Analytics reports
Other options within the same view are optional, and you can activate them if you want to contribute to GA service improvements. Once you've entered everything, click on the Get Tracking ID button in the bottom. At that point, you will need to accept Google's Terms of Service.
 

 
Next screen will provide you with the newly created tracking ID. Copy this, or write it down for later.

 

Now that we have the proper Tracking ID, we need to enter it within the the appropriate field, inside of your Shoutem account. Go to the analytics settings page here , and enter the tracking code under the Property Id label. Hit the save button afterwards.

 
 

Inviting Shoutem to your new tracking account


Next, we need to make sure Shoutem master account is invited to your new GA account. Go back to the admin panel from the start of this guide, select your new account, and access the User Management section. 
Here, we need to invite the Shoutem account :

- Within the Add permissions for field, enter : 237754941928-cvm4e1ql1tu351tigf0br6i4jcs1g8dv@developer.gserviceaccount.com
- Set the permission level to : Read and Analyze
- Click the Add button
 

Now, the two services are connected, and the data is being tracked correctly. However, the data visible at this point, will refer to all of your apps combined. If we want to view unique stats for a specific app under your account, we will need to create a custom segment.
 

Filtering data for specific apps


Go back to the Admin section of the GA interface, and under Property tab, select the Custom Definitions -> Custom Dimensions. Then, click on the + New Custom Definition button.
 

Fill out the required fields, and click the Create button :

- Name : set this to "nid"
- Scope : Hit
- Active : checked

Once you have this created, go to the Reports section of the GA service, go to Audience -> Overview, and click the Add segment button.

 

In the new screen, click the big red button, labeled + New Segment. Then, select the Conditions tab, and enter the following data :

First dropdown : "nid"
Second dropdown : Exactly matches
Filter field : NID number of your app. Check the notes section below, if you need help finding this
Segment name : Set this to your actual app name

Hit the save button when you're done. It should look like this :


The process above will successfully create a filter for one specific app. Whenever you want to check this app analytics, just open up the new segment that we created ( this will happen automatically, once you create the filter for the first time ). The same process can be repeated for as many apps as you have under your agency account.
 

Important notes


- If you are setting this up for the first time, after you've initially published one or more apps, you will need to republish any live apps, in order to apply the new tracking code. Keep in mind that in this case, analytics will be tracked from the moment you republish the app, after the setup above is complete.

- Minimum app versions that support this functionality :

iPhone -> 5.53 and above
Android -> 5.56 and above

- If you're looking for an easy way to find your app's NID number, you can simply use your web browser. Open the app you're looking the NID for, within your app builder. Within the browser address bar, you will see a URL containing this NID number, like on the screenshot below :



For any additional questions in regards to this process, or if you need some help with setting this up, please feel free to contact our support team at shoutem@shoutem.com

Contact us

Didn't find what you were looking for? No problem! Feel free to
write to our support team.

shoutem@shoutem.com
http://assets1.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete