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:
Some parameters are managed by the network. When a user interacts with the ad, the network provides values for these parameters:
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.
Parameter Name | Description |
---|---|
Parameter Name | Description | Included by default |
---|---|---|
goalName
Unique name of the default or custom goal
network
The justtrack id for the connected Network
storeId
Store ID for Apple iTunes/App Store app, or the package name for Google Play
deviceId
Google Advertiser ID / Identifier for Advertisers
clickId
Network generated unique ID of the click (click links only)
viewId
Network generated unique ID of the view (view links only)
sourceId
Sub ID
sourceBundleId
Sub App ID
sourceCampaignId
Campaign ID of the network
creativeName
Name of the set of creative assets (provided by AppLike).
sourcePublisher
App publisher
creativeId
ID of the set of creative assets (provided by AppLike)
referrerId
Network generated unique ID of the referrer (click links only)
sourceUrl
Appstore URL in which the ad was shown
sourcePlacement
Placement within the publisher’s app
sourceCategory
Category of the publisher’s app in which the ad was shown
channel
Ad unit
adType
Type of shown creative asset
limitedAdTracking
"1" or "true" if ad tracking is limited, "0" or "false" if ad tracking is not limited
country
GEO country of the user (ISO3166 alpha-2)
osVersion
Operating system version
deviceType
Device type (tablet, phone, etc.)
deviceModel
Device model
deviceResolution
User device’s screen resolution
s2s
true/false: Describes if the click/view was executed by the server or by frontend
exchangeId
ID of ad exchange
exchangeName
Name of ad exchange
sourceName
Name of the publisher’s app in which the ad was shown
deviceVendor
Should be "apple" for ios platform or empty
adSetId
Ad set/group ID of the network
bidType
Campaign cost model ("CPI", "CPA", "CPC", "CPM", "CPV", "CPCV")
bidCurrency
CPI/CPA currency. This is required for spend tracking via clicks and views.
bidValue
CPI/CPA value (use . as decimal delimiter). This is required for spend tracking via clicks and views.
userAgent
User agent of the tracking event
ip
Current GEO IP of the tracking event
redirect
Prevents user getting redirected to the PlayStore if set to false
custom0
Optional custom parameter
custom1
Optional custom parameter
custom2
Optional custom parameter
custom3
Optional custom parameter
campaignType
"retargeting" for retargeting campaigns, "acquisition" for acquisition campaigns
optimizationType
The optimization type of the campaign
sourceCampaignName
Name of the campaign in network
adSetName
Name of the ad set, ad group, offer