Tracker Management

A step-by-step guide to build a tracker in the Metrix dashboard

How do I create a tracker?

Follow this path: organization -> your desired application -> settings (also you can go to settings after entering your application) -> Trackers sub-menu -> Create a tracker.

app settings trackers menu

What is the meaning of making a tracker?

In order to equip your application with Metrix tracker, the first step is to determine the traffic track of your app. This is called making tracker. As an app owner, you need to create a tracker for your mobile ads. To do this, you need to go through three main steps:

  • Define advertising network
  • Enter tracker information
  • Complete redirect links

create new-tracker

Each of these steps may involve a set of other actions. We explain each of them in the following order:

Step 1: Define the advertising network

add ad network name Your ad campaigns classified as not-organic installations should run through one or more ad networks. At this point, you need to specify with which ad network you are launching your campaign. By clicking on the drop-down, you will see the names of the Metrix collaborators. These ad networks are integrated with Metrix, meaning they are technically compatible. Choose one of the ad networks' names.

Step 2: Enter tracker information

How can I view user engagement reports by campaign?

When creating a tracker, if the relevant fields are completed correctly, the report of all installations as well as the quality and behavior of users will be visible in the dashboard. These fields are: source (network), campaign, ad group, and creative.

tracker info sub-menu in tracker setting

In order to have a more complete view of your ad campaign traffic, it is necessary to define hierarchically multi-layered in the standard structure of a campaign. The reason for this is more accuracy and clearer categorization of your marketing performance output. By doing this, you can see how the users interacted with your app, how much installation you earned, how many clicks have led to installation, by ad network, campaign, ad group, and creative or final advertisement that you have exposed to the user and other useful statistics of this kind.

If you've also done marketing for your website, you know how to set UTM parameters on the desktop. In the following table, we have examined the similarity of these parameters in the world of web and mobile:

LayersMetrix ParametersUTM parameters in GoogleFunctionality
First LayerSource/NetworkUtm_sourceAdvertising network or main channel to attract users
Second LayerCampaignUtm_campaignThe name of the campaign you have run to attract users
Third LayerAd GroupUtm_contentThe type of advertising content you have intended for the campaign
Fourth LayerCreativeUtm_termThe final ad displayed to users

Therefore, these four layers in the world of mobile marketing analysis and generally in digital marketing, are known as parameters:

First Parameter: Source

fill source of tracker

The first layer in the structure of the campaign is the main network through which you have tried to attract users. By default, the same network name that you entered in the first step will appear. We recommend that you keep the same name, but you can enter the name you want for the source if you wish.

Second Parameter: Campaign

Fill campaign of tracker

The second layer in the structure of an advertising campaign is specifying the name of the campaign. You may have run several campaigns with one network, for example one for Christmas and the other for Black Friday. In this section, you need to write each campaign name to make the campaign tracking more specific.

Third Parameter: Ad Group

Fill ad group of tracker

The third layer in the structure of the advertising campaign is specifying the content group of your campaign. Complete this section based on the type of content you have run your campaign on. Common ad groups are video ads, banner ads, and native ads.

Fourth Parameter: Creative

Fill creative of tracker

The last layer and the most detailed part of the structure of advertising campaigns is the creative or final advertising that you display to users. You can distinguish creatives by number or consider name for each one.

By completing all these layers correctly, you will allow Metrix to perform the process of monitoring user engagement in different level well.

Note that creatives are often not named that way and are distinguished by the publisher ID. To make this structure more tangible, we have explained the advertising content in more detail.

Step 3: Complete the redirect links

In this step, you need to enter the links that users are redirected to your application by clicking on them and you want the end user to be redirected to it after clicking on the ad. For this reason, these links are called intent or redirect links. These links can be direct links from various app stores, a website link, a default link and even a deep link that monitors the user's click within one of your application pages.

tracker info redirect link en

In the following, we will explain each of these types of links:

Market link

Once you have registered your application with the Android and iOS platform in their own markets, you can enter the link to install your app in these stores by activating the "I have links from stores" section. This will notify you as soon as the user clicks on the desired market link.

Also, if you have set up a market link on the website and the user is attracted to your application by clicking on the desktop, Metrix will inform you.

Default link

In case the Android or iOS market links are not available or do not work for your application, and also when you have not set a link on the website to attract users to your app, specify a custom link by default. By doing this, you have redirected users to your application in any way. This link can be anything.

Deep link

If you have defined a deep link for a specific content and page in your application, and you want users to be attracted to your app through it, you can enter your deep link in this section. By doing this, users are redirected to specific content within the app.


Now that you have completed all these steps, you can click on the Create Cracker option.

Instructions for setting parameters in the campaigns you want to observe:

  • Always separate the parameters with "&".

  • Parameters are case-sensitive. Use only lowercase letters (i.e. campaign is correct, not Campaign or CAMPAIGN)

  • Make sure the parameters are not misspelled (for example, adgroup is correct, not adgroups or adgrouping)

  • Observe the hierarchy of parameters. (For example, do not enter creative until you have filled in a high level, such as an adgroup). If you do not follow this structure, the Metrix will ignore the higher parameters and report only the lowest level data. This deprives you of accurate and transparent analysis.

  • If the parameters are left blank they are in unknown mode: If your tracker URL has no parameters, the Metrix dashboard (and all the reports it gives) shows the unknown value. To ensure that the same data is recorded below the same levels, we recommend you set the same values in each parameter and in all monitored channels.

  • The 4-layer levels and structure of campaigns are permanent: You can not edit a campaign-level tracker after creation to rename it to replace the ad group or creative level tracker.

How to complete redirect links when creating a new tracker?

In each of the four fields of the redirect link, you must enter the address to which you want the end user to be redirected. In this way, if the user clicks on the ad link on an Android device (including web or in-app ads), to what address will it be redirected, or if it is from iOS or desktop web page, to which address will it be redirected, and finally if none of the previous cases recognized, what should be the default link? (To complete these sections, you need to read the redirect links section in the above step-by-step guide.)

How to test the tracker link?

Once the tracker link is created, copy it and try it on a mobile phone that has not already installed the app, click on the link and install the app. After that enter the application and go to the first page of it, then close the app and enter the Metrix dashboard. Go to the Console Debug section via the settings icon in the upper corner of the application and enter the mobile phone Google ID on which the test was performed, in the GAID/IDFA section, and click on the Show info button. If the tracker implementation steps are done correctly, the information about the installation test and the relevant mobile phone will be displayed to you. With a slight delay (about 20 minutes) by refreshing the page, your click and installation information can be seen in the attribution section of the Metrix dashboard.


I made a tracker link but any installation isn't counted. What is the reason?

  • Not enough time has passed since installation.
  • The application has not been opened after installation.
  • The relevant application has already been installed.
  • The kit or SDK is not implemented properly.
  • The application in the redirect link does not have the Metrix SDK.

I want to advertise by direct download method (for example, Telegram), how can I define a tracker?

If in the advertisement you do, your application is downloaded and installed directly, such as telegram ads, you should create as many as needed installation files (apk) and use each one in one of the ad channels.

For more information, read the following blog:

How does Metrix count direct installs from telegram ads?