Generating Tracking Links

Tracking links are used for attributing an install for the relevant click. In addition to the basic attribution data they contain, it is possible to include other properties, which eventually will be displayed in your Singular reports. This data will help providing you a deeper view of your marketing efforts and results.

Using Singular you can create two types of tracking links:

  1. Regular Tracking Links - for integrated partners like AdColony & Chartboost
  2. Smart Links - for custom marketing sources like email & sms campaigns

Please note that Self Attributing Networks do not require tracking links, please refer to the Special Partners documents to configure these sources.

 

Understanding Tracking Links

In the process of attribution, the tracking links are taking part on the click itself - once a potential user clicks on an Ad, the tracking link is being sent to the Singular server. The data included in it, is being saved, and later, when an install occurs by that user, the Singular attribution service is able to match the install to that click, based on the data collected using the tracking link, and the data sent to Singular once the install occurred. For more information on the attribution methods, click here. image1.png 

Tracking Links Format

While basic format of a tracking link should be: https://c.singular.net/api/v1/ad?st=[link_id]&h=[link_hash]

The Tracking link properties can be ‘fixed’ properties (such as campaign name), or macros which are equivalent to variables. The Macros are uniquely provided by each Source (Ad Network). Both the macros and Fixed properties will automatically be added to the Tracking links while being generated. In case you find that a tracking link is missing a Macro known for a specific source, please contact support@singular.net and report the missing Macro.

Below is an example of an Android Tracking Link along with relevant tracking macros:

https://c.singular.net/api/v1/ad?st=82228468160&udid=[RAW_UDID]&and1=[SHA1_ANDROID_ID]&aifa=[GOOGLE_AD_ID]&s=[APP_ID]&idfa=[IDFA]&odin=[ODIN1]&udi1=[UDID]&api_key=d4636d565f59e217801b5721af716eac&product_id=[PRODUCT_ID]&ip=[IP_ADDRESS]&ve=[OS_VERSION]&cl=[CLICK_ID]&pc=[RAW_AD_CAMPAIGN_ID]&h=99ebf893909cc390843b2cabc6c4f7eccb567676

 

Creating Regular Tracking Links

Used to track mobile app installs campaigns with integrated partners such as AdColony, Chartboost. These tracking links ensures that the partner will receive a postback for every attributed install.
image3.gif

  1. From the Attribution menu on the left, click on ‘Create link’.
  2. Select the App, Site and Destination URL. If you are missing a site or destination URL in the drop down lists, please refer to the Apps screen to update the missing data.
  3. If you have selected a deeplink (or Universal Link for iOS), you can optionally mark that to also be used as a deferred deeplink.  If your deeplink value is "myapp://page?id=1", then the value received in the SDK callback will be "myapp://page?id=1".
  4. Start typing the Source name and select it from the optional list of sources.
    In case the selected source was not configured yet, it will appear with an Orange message: “Please configure this source”
    In that case, click on the Configure link to configure that source.
    Note that each source may have different configuration options.
    Click here for additional information on source configuration, Lookback Window and Events Postbacks.
  5. Type campaign name and click the Generate Link button.
  6. That’s it. Your tracking link is ready to go. Copy the link using the Copy button.

Creating Smart Links

Smart Links allow you to create a single tracking link that, when clicked, will redirect the user to different destinations depending on their device (iOS, Android, other). These tracking links are useful for tracking Email, SMS or any campaign with a non integrated source.

For example, you might want to serve a tracking link in an Email campaign with the following redirect behavior:

  • iOS - take the user to the iTunes app store
  • Android - take the user to the Google Play Store
  • Other - take the user to your web site.

 

image2.gif

  1. From the Attribution menu on the left, click on ‘Create Smart Link’.
  2. Select the App
  3. Select one of the channels or choose “Custom”
  4. Type the campaign name
  5. Choose the destinations and deeplinks for each platform (iOS, Android, other). Note: To enable the deferred deeplink select the checkbox.  If your deeplink value is "myapp://page?id=1", then the value received in the SDK callback will be "myapp://page?id=1".
  6. Click the Generate Link button and copy the link!

Tracking Link Parameters

Reserved Parameters

Reserved parameters are parameters that are the standard or common parameters used by the Singular attribution engine, to properly perform and report attribution with integrated channels and partners.

Property

Description

Example

st

Required Field - Generated Singular Tag ID coded to your application, channel/partner, and Singular Campaign Name

st=544783522947

h

Required Field - Generated Singular security hash.  Matches to Singular Tag ID

h=e35c3d9c098983a0caac36c94a971219238bd7

s

Publisher application or site

s=SampleSourceAppName

cl

Click ID assigned by Ad Network

cl=SampleClickID_1234

pc

Campaign ID assigned by Ad Network

pc=MyCampaign

pl

Optional override for Singular Campaign Name.  Appending this while override the original Singular Campaign Name used when generating the tracking link.

pl=MyCampaign

cr

Creative name assigned by the Ad Network

cr=CreativeName

re

Re-engagement Tracking. Should be set to '1' if tracking re-engagement

re=1

idfa

Advertising Identifier in RAW format - iOS only

idfa=A1C252F5-46AB-4175-9162-EFA23391D9DF

ifa1

SHA1 of IDFA - iOS only

ifa1=6e44a6322dfd8be21d346c0bda3d3bdf8466e66c

ifa5

MD5 of IDFA - iOS only

ifa5=d8724bf33982148aac817951293d6a83

andi

Android ID - Android only.  Fallback if Android Advertising ID is not available on the device

andi=2a9ca2cf2668d55a

and1

SHA1 of Android ID

and1=3272791617360a44edd7a07582ae21a6768fa1fc

and5

MD5 of Android ID

and5=f64f435d04b9736827b2157d6353314d

aifa

Android Advertising ID

aifa=A1A111A8-0AAA-000A-A00A-000000000000

aif1

SHA1 of Android Advertising ID

aif1=2f7023424973d529a26c11cb49bb24ee4d37f87f

aif5

MD5 of Android Advertising ID

aif5=d2a8149dadb68447c9dc2fc56f8e4a82

ve

OS version. Required for server-to-server partners.

ve=6.1.3

ip

IP of the click / impression. Required for server-to-server partners.

ip=123.1.2.3

redirect

Redirect flag. Append redirect=false to disable redirect for tracking link.  Required for server-to-server partners.

redirect=false

 

Non-Reserved Parameters (Passthroughs)

Occasionally you may see parameters in tracking links which is not a reserved parameter.  These parameters are generally used with specific integrations with partners, in order to "pass through" these values to the partner in the attributed postback.  While they enable other more advanced use-cases for postbacks, they are not common.

 

 For questions and additional information, please contact support@singular.net

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.