Tracking Link Parameters

More Guides for Integrated Partners More Guides on Singular Links for Customers

Singular tracking links support a wide variety of parameters. As ad networks serve Singular tracking links, they can populate these parameters to pass on additional information about the click or impression to Singular.

The Singular tracker, which receives the tracking links, reads the parameters and uses them in various ways:

  • Improving deterministic or probabilistic attribution
  • Providing higher granularity in aggregated reports: Any data about the campaign, sub campaign (ad group/ad set), creative, etc., is saved by the Singular tracker and used to provide additional breakdowns in reports.
  • Providing additional data in user-level (event-level) logs: See Export Logs and User-Level Data FAQ.
  • Determining Singular Links redirect behavior: Some parameters are used to determine how the tracking link behaves. These special parameters don't need to be populated by the network - they are added to the Singular Link when it is created by the customer in the Singular platform.

Show: All  Device Data Granularity Parameters Singular Links Behavior Website Links Parameters


Tracking Link Parameter
Description Dimension Name in Singular Aggregated Reports
Field Name in Singular User-Level Data
Category
In Web UI
In API/ Data Destination Schemas
In Web UI (Export Logs)
In Data Destination Schemas
ip IP of the device at the time of the click     IP ip
Device and Other Data
cl The ID of the click or transaction, when available     Click ID click_id
Device and Other Data
ve The version of the OS on the user's device. Note: numeric and decimal only.     OS Version os_version
Device and Other Data
idfa The iOS Advertising ID of the device (unhashed/raw)     IDFA idfa
Device and Other Data
ifa1 The iOS Advertising ID of the device (SHA-1 format)     IDFA SHA1
idfa_sha_1
Device and Other Data
ifa5 The iOS Advertising ID of the device (MD5 format)     IDFA MD5
idfa_md5
Device and Other Data
idfv The iOS Identifier for Vendor. This identifier is used for all the apps on the device that are published by the same vendor and may help determine attribution when the IDFA is not available.     IDFV idfv
Device and Other Data
ifv1 The iOS Identifier for Vendor (SHA-1 format)     IDFV SHA-1
  Device and Other Data
ifv5 The iOS Identifier for Vendor (MD5 format)     IDFV MD5
  Device and Other Data
aifa The Android Advertising ID (AAID) of the user's device, a.k.a. GAID      GAID gaid
Device and Other Data
aif1 The Android Advertising ID (AAID) of the user's device, a.k.a. GAID (SHA-1 format)     GAID SHA1 gaid_sha_1
Device and Other Data
aif5  The Android Advertising ID (AAID) of the user's device, a.k.a. GAID (MD5 format)     GAID MD5 gaid_md5
Device and Other Data
andi The Android ID of the user's device (this identifier is provided by devices that do not support GAID. GAID is available through Google Play services.)     Android ID android_id
Device and Other Data
and1 The Android ID of the user's device (SHA-1 format)     Android ID SHA-1 android_ sha1
Device and Other Data
and5 The Android ID of the user's device (MD5 format)     Android ID MD5 android_id_ md5
Device and Other Data
oaid The Open Anonymous Device ID of the user's device (used in China)     OAID   Device and Other Data
amid
Amazon Advertising ID     AMID
  Device and Other Data
sng_ref
The Google Play Install Referrer. Use this parameter if you have an S2S attribution link integration to enable install-referrer-based attribution on Android devices. Learn more
        Device and Other Data
ua The user agent of the device     User Agent   Device and Other Data
lc The language preference on the device, e.g., "en-US"     Locale   Device and Other Data
pssn The name of the site/placement within the publisher app.     Sub Publisher Name sub_publisher_name
Device and Other Data
pssid  The ID of the site/placement within the publisher app.     Sub Publisher ID sub_publisher_id
Device and Other Data
p
Device Platform (Android/iOS) Platform platform
Platform platform Granularity Parameters
pcn The name of the campaign Campaign Name campaign_name Campaign Name campaign_name
Granularity Parameters
pcid The ID of the campaign Campaign ID  campaign_id Campaign ID  campaign_id
Granularity Parameters
pscn The name of the sub campaign. Sub campaign is an additional breakdown under the campaign level in some networks. Sometimes called Ad Set or Ad Group. Sub Campaign Name sub_campaign_name Sub Campaign Name sub_campaign_name
Granularity Parameters
pscid The ID of the sub campaign. Sub campaign is an additional breakdown under the campaign level in some networks. Sometimes called Ad Set or Ad Group. Sub Campaign ID sub_campaign_id Sub Campaign ID sub_campaign_id
Granularity Parameters
pcrn The name of the creative (depending on the network, Singular's "creative" may be the same as the network's "ad", or there may be multiple creatives for each ad). Creative Name creative_name
Creative Name creative_name Granularity Parameters
pcrid The ID of the creative (depending on the network, Singular's "creative" may be the same as the network's "ad", or there may be multiple creatives for each ad). Creative ID  creative_id
Creative ID  creative_id Granularity Parameters
pshid The ID of the app in which the ad was served. The ID is hashed or anonymized. Publisher ID publisher_id
Publisher Hashed ID publisher_hashed_id
Granularity Parameters
psn The name of the app in which the ad was served (usually the name of the app in the relevant app store). Publisher Site Name publisher_site_name
Publisher Name publisher_name
Granularity Parameters
psid The public ID of the app in which the ad was served (usually the ID of the app in the relevant app store). Publisher Site ID publisher_site_id
Publisher ID publisher_id
Granularity Parameters
kw The search keyword (for Google Ads and Apple Search Ads) Keyword keyword
Keyword   Granularity Parameters
paffn The name of the affiliate (for affiliate networks that report it) Affiliate Name affiliate_name
Affiliate Name affiliate_name
Granularity Parameters
paffid The ID of the affiliate (for affiliate networks that report it) Affiliate ID  affiliate_id
Affiliate ID affiliate_id Granularity Parameters
_dl Deep link for all mobile platforms. Note: Overriding/using this query parameter is only possible if the original link was enabled with deep linking         Singular Links Redirect Behavior
_ddl Deferred deep link for all mobile platforms. Note: _ddl can enable deferred deep linking even if it was not enabled via the UI during creation         Singular Links Redirect Behavior
_global_redirect Redirect for all platforms, even in the case the user has the app installed. 

**When used in the same link with other destination override parameters (e.g. _fallback_redirect), the _global_redirect value will set the redirect destination.
        Singular Links Redirect Behavior
_fallback_redirect Fallback Redirect for Non-Android and Non-iOS platforms (typically used for Web)         Singular Links Redirect Behavior
_android_redirect Android Redirect: Redirect URL if the app is not installed on Android. This is typically the app store URL         Singular Links Redirect Behavior
_samsung_redirect Android Redirect for Samsung devices: Redirect URL if the app is not installed on Samsung devices. Samsung app store values supported (samsungapps://ProductDetail/com.game.app). Note that deep linking with this redirect option is currently not supported.         Singular Links Redirect Behavior
_android_dl Deep Link (Android): This is typically used if your deep link URL on Android is different from your iOS app         Singular Links Redirect Behavior
_android_ddl Deferred Deep Link (Android): This is typically used if your deep link URL on Android is different from your iOS app. Note: _android_ddl can be enable deferred deep linking even if not enabled via the UI during creation         Singular Links Redirect Behavior
_ios_redirect iOS Redirect (iOS): Redirect URL if the app is not installed on iOS. This is typically the app store URL         Singular Links Redirect Behavior
_ios_dl Deep Link (iOS): This is typically used if your deep link URL on iOS is different from your Android app. Note: Overriding/using this query parameter is only possible if the original link was enabled with iOS deep linking         Singular Links Redirect Behavior
_ios_ddl Deferred Deep Link (iOS): This is typically used if your deep link URL on iOS is different from your Android app. Note: _ios_ddl can be enable deferred deep linking even if not enabled via the UI during creation         Singular Links Redirect Behavior
_p The passthrough parameter is used in the configuration of Deep Links and Deferred Deep Links. They can be customized to pass things like promo codes or affiliate/influencer names     Passthrough passthrough Singular Links Redirect Behavior
_force_redirect=1 Force Redirect: In cases where iOS Universal Links may not deep link, appending &_force_redirect=1 (or &_force_redirect=true) will enable the Singular Link to use app-scheme-based deep linking to force the deep link to the end-user.      Read more in Singular Links dynamic redirects handling         Singular Links Redirect Behavior
redirect=false This parameter should be used if the partner wishes to redirect their users to the store independently. Clicking on a link with &redirect=false will not lead to the store.         Singular Links Redirect Behavior
_forward_params=1

Forward parameters: Set this parameter to 1 (or true) if you want your redirect destinations to receive all the information included in the Singular Link parameters. Learn more

        Singular Links Redirect Behavior
an
Ad network partner         Website Links Parameters
utm_campaign
The value of the utm_campaign parameter from the web landing page URL. *The value will be used as Campaign Name if using Singular Web Attribution and not implementing the "wpcn" parameter. UTM Campaign*   UTM Campaign utm_campaign Website Links Parameters
utm_medium
The value of the utm_medium parameter from the web landing page URL UTM Medium   UTM Medium utm_medium Website Links Parameters
utm_source
The value of the utm_source parameter from the web landing page URL. **The value will be used as Source if using Singular Web Attribution and not implementing the "wpsrc" parameter. UTM Source**   UTM Source utm_source Website Links Parameters
utm_term The value of the utm_term parameter from the web landing page URL UTM Term   UTM Term utm_term Website Links Parameters
utm_content The value of the utm_content parameter from the web landing page URL UTM Content   UTM Content utm_content Website Links Parameters
wpcid
The ID of the campaign Campaign ID campaign_id Campaign ID campaign_id Website Links Parameters
wpcn
The name of the campaign Campaign Name campaign_name Campaign Name campaign_name Website Links Parameters
wpcrid
The ID of the creative (depending on the network, Singular's "creative" may be the same as the network's "ad", or there may be multiple creatives for each ad). Creative ID creative_id Creative ID creative_id Website Links Parameters
wpcrn
The name of the creative (depending on the network, Singular's "creative" may be the same as the network's "ad", or there may be multiple creatives for each ad). Creative Name creative_name Creative Name creative_name Website Links Parameters
wpkmatch
Match Type         Website Links Parameters
wpkwid
Target ID         Website Links Parameters
wpkwn
Search Keyword Keyword keyword Keyword   Website Links Parameters
wpscid
The ID of the sub campaign. Sub campaign is an additional breakdown under the campaign level in some networks. Sometimes called Ad Set or Ad Group. Sub Campaign ID sub_campaign_id Sub Campaign ID sub_campaign_id Website Links Parameters
wpscn
The name of the sub campaign. Sub campaign is an additional breakdown under the campaign level in some networks. Sometimes called Ad Set or Ad Group. Sub Campaign Name sub_campaign_name Sub Campaign Name sub_campaign_name Website Links Parameters
wpsn The name of the site/placement within the publisher app. Publisher Site Name publisher_site_name Publisher Name publisher_name Website Links Parameters
wpsrc
Network Source source Partner source Website Links Parameters