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

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 occured. 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

Allows to create a custom tracking link that will automatically redirect to iTunes, Google Play or other available stores according to the user device.

These tracking links are useful for tracking: Email,SMS or any campaign with a non integrated source.

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. 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

Property

Description

Example

st

Singular Tag ID

st=544783522947

h

Singular security hash

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

ca

Singular Campaign Name

ca=MyCampaign

cr

Creative name assigned by the Ad Network

cr=CreativeName

re

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

re=0

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

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

ve=6.1.3

 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.
Powered by Zendesk