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:

  • Better 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 determining how the tracking link behaves. These special parameters don't need to be populated by the network - they are added into the Singular Link when it is created by the customer in the Singular web app.

 

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     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 of the user's device, a.k.a. GAID     GAID gaid
Device and Other Data
aif1 The Android Advertising ID 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 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 sometimes provided by old devices that do not support GAID)     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
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
_smtype Source Media Type: An optional parameter identifying the type of media this link is tracking. Singular uses the source media type to help partners adhere to privacy regulations, such as Apple's "user privacy and data use" guidelines for iOS 14+. The source media type allows Singular to identify which attribution methods can be used on iOS 14+ devices
Supported values: "1": paid, mobile web-to-app "2": paid, mobile app-to-app "3": owned, mobile web-to-app "4": owned, mobile app-to-app
See this matrix on attribution methods applied to each source media type.
Both partner links and custom source links default to "2"
        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 be enable deferred deep linking even if not enabled via the UI during creation         Singular Links Redirect Behavior
_fallback_redirect Fallback Redirect for all platforms (including 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
_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
_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
_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
          Website Links Parameters
utm_medium
          Website Links Parameters
utm_source
          Website Links Parameters
wpcid
Camapign ID         Website Links Parameters
wpcn
Campaign Name         Website Links Parameters
wpcrid
Creative/Ad ID         Website Links Parameters
wpkmatch
Match Type         Website Links Parameters
wpkwid
Target ID         Website Links Parameters
wpkwn
Search Keyword         Website Links Parameters
wpscid
Sub Campaign (a.k.a. Ad Group/Ad Set) ID         Website Links Parameters
wpscn
Sub Campaign (a.k.a. Ad Group/Ad Set) ID         Website Links Parameters
wpsnetn
Network         Website Links Parameters
Was this article helpful?