Tracking URL
Last updated
Last updated
A tracking URL specifies where to send data when users view or click your ads as well as what data you want to receive.
Here is a typical workflow for using tracking URLs in justtrack:
When you connect a network to your company in justtrack, you usually need to configure two tracking URLs. The first is for when a user sees your ad. (This is called an impression.) The second is for when a user clicks your ad. At this stage, the tracking URLs are more like templates that specify what information you want to receive and the way you want to receive it; but more on that later.
When you create a campaign in the network, you:
Build a tracking URL that is specific to an app, platform, and goal*.
Add this tracking URL to the Network campaign.
When the network places the ad, it includes these tracker URLs.
When the user sees or clicks the ad, the network SDK sends tracking data to the correct URL where you can see the results in real time.
*Goals are not always required when building tracking URLs. They are only required if the network you're connecting supports both:
Automatic campaign creation
Sending spend data via tracking URLs
The data you receive from tracking URLs is valuable for things like understanding how effective your campaign is at achieving some goal or attributing user behaviours to the networks that run the campaigns.
Some networks don't support external tracking URLs. In those cases, we can't show impression or click data.
A tracking URL is composed of three parts:
The domain is the address that receives data about the network, the campaign, and user who sees or clicks your ad.
The event identifies the interaction the user had with your advertisement. The two possible values are:
view
click
The parameters specify the data you want to receive for your campaign. This data might include the user's country, the campaign type, or the goal you're basing your campaign on.
There are two types of parameters:
Those that justtrack provides values for.
Those that the network provides values for.
Some parameters are managed by justtrack. When you build a URL for a campaign, justtrack provides these values in the tracking URL:
| Parameter Name | Description |
|---|---|
| Unique name of the default or custom goal |
| The justtrack id for the connected Network |
| Store ID for Apple iTunes/App Store app, or the package name for Google Play |
Some parameters are managed by the network. When a user interacts with the ad, the network provides values for these parameters:
| Parameter Name | Description | Included by default |
|---|---|---|
| Google Advertiser ID / Identifier for Advertisers | |
| Network generated unique ID of the click (click links only) | |
| Network generated unique ID of the view (view links only) | |
| Sub ID | |
| Sub App ID | |
| Campaign ID of the network | |
| Name of the set of creative assets (provided by AppLike). | |
| App publisher | |
| ID of the set of creative assets (provided by AppLike) | |
| Network generated unique ID of the referrer (click links only) | |
| Appstore URL in which the ad was shown | |
| Placement within the publisher’s app | |
| Category of the publisher’s app in which the ad was shown | |
| Ad unit | |
| Type of shown creative asset | |
| "1" or "true" if ad tracking is limited, "0" or "false" if ad tracking is not limited | |
| GEO country of the user (ISO3166 alpha-2) | |
| Operating system version | |
| Device type (tablet, phone, etc.) | |
| Device model | |
| User device’s screen resolution | |
| true/false: Describes if the click/view was executed by the server or by frontend | |
| ID of ad exchange | |
| Name of ad exchange | |
| Name of the publisher’s app in which the ad was shown | |
| Should be "apple" for ios platform or empty | |
| Ad set/group ID of the network | |
| Campaign cost model ("CPI", "CPA", "CPC", "CPM", "CPV", "CPCV") | |
| CPI/CPA currency. This is required for spend tracking via clicks and views. | |
| CPI/CPA value (use . as decimal delimiter). This is required for spend tracking via clicks and views. | |
| User agent of the tracking event | |
| Current GEO IP of the tracking event | |
| Prevents user getting redirected to the PlayStore if set to false | |
| Optional custom parameter | |
| Optional custom parameter | |
| Optional custom parameter | |
| Optional custom parameter | |
| "retargeting" for retargeting campaigns, "acquisition" for acquisition campaigns | |
| The optimization type of the campaign | |
| Name of the campaign in network | |
| Name of the ad set, ad group, offer |
When you connect a network to justtrack, you create templates for your tracking URLs. These templates use placeholders for the parameters so the values can be added later:
By the time the user interacts with the ad, all these placeholders are replaced by real values.
You can include fixed values instead of placeholders if you don't want to receive dynamic tracking data from your network.
For justtrack parameters, the placeholders you provide are arbitrary. For network parameters, the placeholders you provide are specific to the network. Please consult the network's documentation to learn what placeholders you should use to get the correct data in your tracking URL.
