More Guides for Integrated Partners • More Guides on Singular Links for Customers
Tracking link parameters play a crucial role in ensuring accurate data collection and attribution for ad network partners. Singular tracking links support a wide variety of parameters that allows ad networks to append valuable information about clicks and impressions. By populating these parameters, ad networks can pass critical data to Singular, enabling more precise measurement of campaign performance.
Once a tracking link is triggered, the Singular tracker processes the embedded parameters and utilizes them in various ways, such as:
- Improving deterministic or probabilistic attribution accuracy
- Enabling deeper campaign insights: 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 aggregated reports and user-level logs (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.
Tracking links are a key component of your integration as an integrated media source with Singular. They allow you to pass essential data about clicks and impressions, ensuring accurate attribution and campaign measurement. If your company also supports postbacks, be sure to review the Postback Macros and Passthrough Parameters for Ad Networks section before you submit an integration request with Singular. Once you have gathered all the necessary details, you can apply here to be an integrated media source with Singular.
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 options:
|
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 |