Attribution Data
Conversion data reference
Parameter Name | Type | Description | Required | Example Value | Notes |
---|---|---|---|---|---|
ClickId |
STRING (64) | An identifier for a referred click that represents the consumer's journey. When a visitor lands on your page via an impact.com tracking link, this value is generated and appended as a query string parameter, which should be captured for conversion reporting. | Required, unless another attribution parameter is provided Required when you or your partners are passing SubIds or a SharedId |
QiiWXOVnrQ3SQHl24jQjyxBGUkmzfJ3i1VHrWM0 |
If available, it's generally always recommended to pass the ClickId value when reporting a conversion. Also note that any generated ClickId value can be associated with multiple clicks — it is not unique to an individual click. |
CustomerId |
STRING (255) | A unique identifier that you (or your systems) generate for the customer driving this conversion. These IDs should be non-identifying (e.g. plain text email addresses are not permitted). | Required, unless another attribution parameter is provided | R523GSSD2342333FSCSA |
This key will be used for insights reporting along with conversion chaining. |
CustomProfileId |
STRING (70) | An id used to uniquely identify a user on your property (regardless of whether they are signed in or not). | Required, unless another attribution parameter is provided | POOWXOVnrQ3SQHl24jQjyxBGUkmzfJ3i1VHrWM0 |
Common examples include anonymous user cookies and IDFVs. |
OrderPromoCode || PromoCode |
STRING (255) | The promotional code associated with this conversion. Note that this only works as an attribution key if this code was assigned as a unique tracking code to a particular partner. In that case, that partner will win credit for this conversion. Otherwise, this will be reported as the promo code used for an order. | Required (if available), unless another attribution parameter is provided | ACMEPARTNER |
To use promo codes as an attribution key, they need to be configured in Ad Settings and validated in the Event Type Settings screen of the platform. When using, OrderPromoCode is preferred over PromoCode. |
UniqueUrl |
STRING (255) | Only used if you have issued unique URLs to partners for tracking purposes. You may send the unique URL here that referred this conversion. Note that these must first be set up in your account before they can be used for attribution. | Required (if available), unless another attribution parameter is provided | https://www.example.com/acmepartner | Learn more about Unique URLs. |
GoogAId |
STRING (36) | Google Advertising Id associated with the mobile device the customer converted on. | Required (if available), unless another attribution parameter is provided | cdda802e-fb9c-47ad-9866-0794d394c912 |
Used for attribution purposes. Typically only available for Android in-app conversions. |
AppleIfa |
STRING (36) | Apple Id for Advertising (IDFA) associated with the mobile device the customer converted on. | Required (if available), unless another attribution parameter is provided | EA7583CD-A667-48BC-B806-42ECB2B48606 |
Used for attribution purposes. Typically only available for iOS in-app conversions. |
AppleIfv |
STRING (36) | Apple ID for Vendors (IDFV) associated with the mobile device the customer converted on. | Required (if available), unless another attribution parameter is provided | AEBE52E7-03EE-455A-B3C4-E57283966239 |
Used for attribution purposes. Typically only available for iOS in-app conversions. |
MediaId || MediaPartnerId |
INTEGER (10) | ID of the partner or media source that will automatically receive credit for the conversion. By passing this value, you force them to win credit for this conversion, bypassing the consumer journey. Only used in specific cases where forced attribution is required — do not submit this value otherwise. | Only used and required for "Forced Attribution" (read description & notes) | 1234567 |
Only pass a value for this parameter if you have no other attribution keys or are forcing attribution to a specific partner or media source intentionally. Do not use this attribution parameter if you or your partners are passing any SubIds or SharedIds. |
IpAddress |
STRING (128) | The customer's public IP address when driving the conversion. The IP address is used to help the system identify fraudulent activity. The IP address will only be used for attribution in the case of installs. | Optional, primarily used for mobile app tracking | 72.194.216.61 || 2001:0db8:85a3:0000:0000:8a2e:0370:7334 |
Supports both IPv4 and IPv6 addresses. |
PhoneNumber |
STRING | Phone number the customer called in call tracking conversions. If call tracking is configured to use unique phone numbers, value is used to match the conversion to the originating call record. | Only used and required for Call Tracking (read description & notes) | 15558675309 |
|
CallerId |
STRING | Unique identifier of the customer in call tracking conversions. Value is used to match the conversion to the originating call record. | Only used and required for Call Tracking (read description & notes) | ||
CountryCode |
STRING (2) | Two-letter country code of the customer's phone country code; use ISO 3166-1 alpha-2. | Only used and required for Call Tracking (read description & notes) | US |
See countrycode.org |
Updated 19 days ago