Conversions
Unique identifier for the event type (action tracker).
8180Configurable string code for the event type.
ACME_SALEUnique identifier of a referring click.
QiiWXOVnrQ3SQHl24jQjyxBGUkmzfJ3i1VHrWM0Your unique, non-PII identifier for the customer.
BCZ2WVSH674563PDPYOTM3AXDQUnique identifier for a visitor on your website.
a1b2c3d4e5f6Promo code used for the order. Used for attribution if assigned to a specific partner.
10OFF-ROCKETUnique URL of a partner that referred the conversion.
Google Advertising ID.
38400000-8cf0-11bd-b23e-10b96e40000dApple ID for Advertising (IDFA).
38400000-8cf0-11bd-b23e-10b96e40000dApple ID for Vendors (IDFV).
38400000-8cf0-11bd-b23e-10b96e40000dForce attribution to a specific partner ID. Use with caution.
10000Only used if you are specifying the MediaId directly and have no other means to tie this conversion to a click or impression. Custom text field typically used by partners to segment their traffic.
subid1valueOnly used if you are specifying the MediaId directly and have no other means to tie this conversion to a click or impression. Custom text fields typically used by partners to segment their traffic.
subid2valueOnly used if you are specifying the MediaId directly and have no other means to tie this conversion to a click or impression. Custom text field typically used by partners to segment their traffic.
subid3valueOnly used if you are specifying the MediaId directly and have no other means to tie this conversion to a click or impression. Custom text field typically used by partners to share traffic segments with the brands they work with.
sharedidvaluePhone number called for call tracking conversions.
8051234567Unique identifier of the customer in call tracking conversions.
8051234567Primarily used for conversions over the phone, this is the ISO 3166-1 alpha-2 two-letter country code of the number called by the customer.
USCustomer's IP address. Used for fraud detection and install attribution.
72.194.216.61Timestamp of when the conversion occurred (ISO 8601).
2023-02-15T22:55:32-08:00Unique identifier for your program/campaign.
3641Your unique identifier for the order.
9217374917471Customer's email, must be sent as a SHA1 or SHA256 hash. Plaintext emails are not accepted.
4db6c86b5d02c22ab6c5e1b1a0b82a7b5d4ef068Status of the customer, such as NEW or EXISTING. Before being passed, values must be configured in the Customer Status Mapping section when editing an event type, found in the event type settings section of the platform.
NEWCity of the customer, such as Santa Barbara.
Santa BarbaraPostal (or "ZIP") code of the customer, such as 93101.
93101Country of the customer, such as USA.
USARegion of the customer, such as AMER.
AMERFor sales, this is the discount applied to the order overall. Amount is automatically subtracted from the order total on processing. If item amounts are used, this discount will be subtracted proportionally from each item amount sent in. Note that typically you will want to exclude shipping discounts from this field.
5Used when reporting conversions at the order-level (i.e., no item reporting). The subtotal of the order after discounts, taxes, shipping, and any other costs. If you're submitting item-level data, this value should not be submitted.
95Primarily used for retail sales. This is the cost of shipping for this conversion. Note that the total sale amount used for payout purposes will not include shipping costs.
5Primarily used for retail sales. This is the cost of tax for this conversion. Note that the total sale amount used for payout purposes will not include shipping costs.
8Primarily used for retail sales. This is the total margin made on the conversion (revenue less costs). Typically this is provided either at an item level through the ItemMargin field or through the product catalog.
30The discount rate (%) applied to the order.
10This method of payment used for this conversion (e.g. Credit).
CREDIT_CARDIf you're tracking gift purchases, you can submit true to mark the order in the conversion as a gift purchase. Submit false if the order isn't a gift purchase.
false3-character ISO 4217 currency code of the purchase.
USDThis is the total order sale amount made on an item or order level of the conversion.
123SKU for the item (e.g., ItemSku1, ItemSku2).
Promotional code applied to the item for the order. Note that this parameter does not work with unique tracking codes setup for particular partners.
10OFF-ACMEThe name for the product referenced. Can also be automatically appended through uploading a product catalog.
Category of the item.
If applicable, the subcategory for the product referenced at the item level. Can also be automatically pulled if a product catalog has been uploaded.
TennisManufacturer part number (MPN) for the product referenced. Can also be automatically pulled if a product catalog has been uploaded.
ACME-MPN-101Brand name for the product referenced. Can also be automatically pulled if a product catalog has been uploaded.
AcmeNumber of units for this line item.
Unit price for the item. Do not send if ItemSubTotal[i] is passed.
Total price for the line item. Do not send if ItemPrice[i] is passed.
Discount applied to each item purchased of this type (not to the entire line item).
The discount rate (%) applied to each item purchased.
10Discount applied to this line item (not just for each product of this type). Note that this amount is automatically subtracted from the ItemSubTotal to determine the final sale amount for payout and reporting purposes.
Type of delivery method specified for this item (e.g. INSTORE).
INSTOREYou can associate up to 50 custom text fields with each line item using the ItemText{i}_[x] parameter syntax, where {i} is the line item index and [x] is the custom text parameter index (1 to 50). For example, ItemText1_1 is custom text parameter 1 for line item 1, and ItemText2_40 is custom text parameter 40 for line item 2. Appears in your reports.
itemtext1_2=Blue (Custom text parameter 2 for line item 1)General numeral field associated with a specific line item, using the ItemNumeric{i}_[x] parameter syntax, where {i} is the line item index and [x] is the numeric parameter index (1 to 10). Appears in your reports.
100.5General date and time field (ISO 8601 format) associated with a specific line item, using the ItemDate{i}_[x] parameter syntax, where {i} is the line item index and [x] is the date parameter index (1 to 10). Appears in your reports.
2026-09-10T22:55:32-08:00General monetary field associated with a specific line item, using the ItemMoney{i}_[x] parameter syntax, where {i} is the line item index and [x] is the money parameter index (1 to 3). Appears in your reports.
50User agent of the customer, used to provide device reporting.
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36Mobile device's manufacturer. Pass android.os.Build.MANUFACTURER on Android or "Apple" on iOS.
AppleMobile device's model. Pass android.os.Build.MODEL on Android or the value from systemInfo.machine on iOS.
iPhone 15For mobile app conversions, this value is the "System App ID" of your app in impact.com. Found in Settings → Mobile Apps.
12345Package name for the mobile app the user installed. Only for mobile conversions. Note that this is also picked up through the PropertyId field.
com.acme.appOnly for Android conversions. Install referrer passed from the Google Play Store when the app is installed. Usually, the value passed from impact.com tracking links will be ClickId={clickidvalue}.
ClickId=QiiWXOVnrQ3SQHl24jQjyxBGUkmzfJ3i1VHrWM0Version of the mobile app. Only for mobile conversions.
1.2.3Primarily used for accommodations, this is the unique identifier for the location specified in this conversion.
LOC-12345Primarily used for accommodations, this is the name for the location specified in this conversion.
Acme Resort Santa BarbaraPrimarily used for accommodations, this is the category for the location specified in this conversion.
HOTELIndicates whether the user has provided consent to be tracked at the moment of the request. Derived from your consent management platform or through frameworks like Apple's ATT (App Tracking Transparency) available on iOS.
trueGeneral field used to pass information for event-level reporting purposes.
Customer confirmed delivery.If you have a custom disposition code configured in event type settings, you can submit that value as a default disposition for the action that results from this conversion.
DEFAULTGeneral text field that accepts strings of any text data you want to send. Appears in your reports. There are 50 of these fields, from Text1 to Text50.
text1valueGeneral numeral field that accepts any numeric data you want to send. Appears in your reports.
100.5General numeral field that accepts any numeric data you want to send. Appears in your reports.
20General numeral field that accepts any numeric data you want to send. Appears in your reports.
30General numeral field that accepts any numeric data you want to send. Appears in your reports.
40General numeral field that accepts any numeric data you want to send. Appears in your reports.
50General numeral field that accepts any numeric data you want to send. Appears in your reports.
60General numeral field that accepts any numeric data you want to send. Appears in your reports.
70General numeral field that accepts any numeric data you want to send. Appears in your reports.
80General numeral field that accepts any numeric data you want to send. Appears in your reports.
90General numeral field that accepts any numeric data you want to send. Appears in your reports.
100General money field that accepts any monetary numeric data you want to send. Appears in your reports.
50General money field that accepts any monetary numeric data you want to send. Appears in your reports.
50General money field that accepts any monetary numeric data you want to send. Appears in your reports.
75General field that accepts a date and time in ISO 8601 format you want to send. Appears in your reports.
2026-09-10T22:55:32-08:00General field that accepts a date and time in ISO 8601 format you want to send. Appears in your reports.
2026-09-10T22:55:32-08:00General field that accepts a date and time in ISO 8601 format you want to send. Appears in your reports.
2026-09-10T22:55:32-08:00General field that accepts a date and time in ISO 8601 format you want to send. Appears in your reports.
2026-09-10T22:55:32-08:00General field that accepts a date and time in ISO 8601 format you want to send. Appears in your reports.
2026-09-10T22:55:32-08:00General field that accepts a date and time in ISO 8601 format you want to send. Appears in your reports.
2026-09-10T22:55:32-08:00General field that accepts a date and time in ISO 8601 format you want to send. Appears in your reports.
2026-09-10T22:55:32-08:00General field that accepts a date and time in ISO 8601 format you want to send. Appears in your reports.
2026-09-10T22:55:32-08:00General field that accepts a date and time in ISO 8601 format you want to send. Appears in your reports.
2026-09-10T22:55:32-08:00General field that accepts a date and time in ISO 8601 format you want to send. Appears in your reports.
2026-09-10T22:55:32-08:00The conversion event has been successfully queued for processing.
Indicates whether the conversion was successfully queued.
QUEUEDThe unique reference to the queued submission.
/Advertisers/<AccountSID>/APISubmissions/<SubmissionID>Bad Request. The request was invalid, likely due to missing required fields or incorrect data formats.
Last updated