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 | |||
| amid |
Amazon Advertising ID | AMID |
Device and Other Data | |||
| sng_ref |
The Google Play Install Referrer. Use this parameter if you have an S2S 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 | ||
| _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 | ||||
| wpsrc |
Network | Website Links Parameters | ||||
