Help Center

| Submit or View Help Requests | Developer Docs |

View desktop instructions
View mobile app instructions
Create Category & SKU Exception Lists

Category exception lists (and SKU exception lists) can be used to pay partners different rates based on the category or the SKU associated with the action they drove.

When would I use this feature?

  • Lead Gen: Category-based payouts may be implemented for lead generation campaigns that wish to vary payouts according to demographics. For example, your business may have a higher lead conversion rate for customers from the United States as compared to other countries. You could then decide to assign a higher category payout to leads for customers in the US.

  • Sales: Let's say Product A has a larger profit margin than Product B, and you want to reward partners that drive actions for Product A. You could use an SKU-based exception list to detect for actions that include Product A and increase your payout.

The above are just a couple of the common use cases—there are a range of other ways this feature can be used as well.

Create a category exception list

This feature is only accessible to specific impact.com editions or add-ons. Contact us to upgrade your account and get access!
  1. From the left navigation bar, select [Menu] [Menu] → Settings.

  2. In the Program column, scroll to Exception Lists and select Category.

  3. In the upper right corner, select Add New Category List.

  4. Fill out the following information:

    List Name

    Add a name for this list—this will only appear internally to you and other account members; partners will not see it.

    Associate Event Type

    Select the event type(s) you want to associate with this exception list.

    Match Expression

    [Advanced & Optional] Enables the system to match only on a part of the category value via specifying a regular expression with ONE grouping. The value represented by the grouping will be matched against the SKU value in this list. If you have a use case for regex but are unsure how to configure it, contact support.

  5. Select Save and Add Items to continue.

  6. You can add Categories and optional Display Values using the fields in the UI, or you can Upload a CSV or Excel file with your categories.

  7. Once you've added items or uploaded a file, select Save to complete the process. You'll now see your new category exception list on the Category Lists screen.

    63d3b8f486e96.png

Category exception list format

Create a .CSV or .XLS/.XLSX file using the two column names below.

Column

Type

Required

Description

Category

String

Yes

The value that is included in tracking conversion data.

Display Value

String

No

Enter a display value if you want to show a different value in reporting. For example, if the Category value is some sort of computer generated value, then you might want to enter a display value to make it easier to understand in reporting.

For example:

63d3b8f79de2f.png

Typically payout rates are based on item categories; however, you can also set a payout rate for a specific item. You would need to create an item category for each item you want to have a specific payout. When you create template terms, you'll need to specify payout rates for each category list. All category names associated with a category list will have the same payout rate per the contract.

Set payouts for a category exception list

When you create template terms that include an event type with category payouts, you'll be able to enter payout rates for each category. Make sure the correct category names are included in action data that is submitted to impact.com—otherwise your category-based payout rates won't apply.

Payout Group Logic

If a payout group's condition is met, it will apply the payout change at the same level (order or item) as the template term's default payout. For example, if your default payout applies a payout at the item level, specific items will have their payouts changed if they fall into the category entered in that payout group.

  1. From the left navigation menu, select Contracts → Template Terms.

  2. Find the template terms you want to add the Category Exception List to. In the Actions column, select [Down caret] [Drop-down menu] → Modify Terms. If you want to create new template terms, select Create Template Terms in the upper right corner.

  3. [Toggle on] [Toggle on] Set up customized payout groups to enable payout groups then select Add New.

  4. In the Rules field, select Item Catalog Category from the drop-down menu and in the second drop-down menu select is.

  5. In the third text field, enter the Name of your Category Exception List. A list of your existing lists will appear when you start typing, which you can select.

    Screenshot_2024-10-04_at_12_09_35.png
  6. Set the Payout you want for items on the list.

  7. Select Add to complete the process.

From here, you can continue modifying (or creating) your template terms as usual.

Warning: When you submit your conversion data to impact.com, you must include the correct category name that exactly matches how it appears in your category list. If we can't find a match then the system will apply your default payout rate instead.

The item category value must be included in the JavaScript tracking code:

irEvent.addItem("<category_name>", "sku", "amount", "qty")

Create a SKU exception list

This feature is only accessible to specific impact.com editions or add-ons. Contact us to upgrade your account and get access!
  1. From the left navigation bar, select [Menu] [Menu] → Settings.

  2. In the Program column, scroll to Exception Lists and select SKU.

  3. In the upper right corner, select Add New SKU List.

  4. Fill out the following information:

    List Name

    Add a name for this list—this will only appear internally to you and other account members; partners will not see it.

    Associate Event Type

    Select the event type(s) you want to associate with this exception list.

    Match Expression

    [Advanced &amp; Optional] Enables the system to match only on a part of the SKU value via specifying a regular expression with ONE grouping. The value represented by the grouping will be matched against the SKU value in this list. If you have a use case for regex but are unsure how to configure it, contact support.

  5. Select Save and Add Items to continue.

  6. You can add a SKU and optional Display Values using the fields in the UI, or you can Upload a CSV or Excel file with your SKUs.

  7. Once you've added items or uploaded a file, select Save to complete the process. You'll now see your new category exception list on the SKU Lists screen.

    63d3b8fa9a00a.png

SKU exception list format

Create a .CSV or .XLS/.XLSX file using the column names below.

Column

Type

Required

Description

SKU

String

Yes

The value that is included in tracking conversion data.

Display Value

String

No

Enter a display value if you want to show a different value in reporting. For example, if the Category value is some sort of computer generated value, then you might want to enter a display value to make it easier to understand in reporting.

Active Start Date

Date

No

Gives you the ability to schedule this item. This is an ISO 8601 format. Example format: 2038-01-19T12:00:00-07:00

Active End Date

Date

Only if Start Date is provided

Gives you the ability to schedule this item. This is an ISO 8601 format. Example format: 2038-01-19T23:59:59-07:00

When setting end dates to SKUs, any SKUs that expire (passes the set end date) will not trigger any payouts stipulated in the contract. Be sure to remove expired SKUs to avoid payouts from not triggering as stipulated in your terms.

Example: If you want to run a promotion for a limited time on selected SKUs, you can create a SKU exception list and schedule times for when the promotion is valid for on each related SKU. Then you can set a payout group to pay the different payouts on the various SKUs. If an order with a SKU on this list is tracked outside of the scheduled time, it will not trigger the promotional payout.

Timezone

String

No

Timezone is derived from the start date, but if you want to override it with a specific timezone, enter the full name here, e.g. "America/New_York"

For example:

63d3b8fc4a97c.png

Set payouts for a SKU exception list

Once a SKU exception list is active, you can add it to template terms under the Payout Groups option.

SKUs added to exception lists with an active end date will still appear in your template terms under the payout groups to which they were added, even after the end date expires. To avoid expired SKUs appearing in your payout groups, you must manually remove those whose end dates have expired. You will be able to view all expired and valid SKUs but partners can only see valid SKUs.

  1. From the left navigation menu, select Contracts → Template Terms.

  2. Find the template terms you want to add the SKU exception list to. In the Actions column, select [Down caret] [Drop-down menu] → Modify Terms. If you want to create new template terms, select Create Template Terms in the upper right corner.

  3. [Toggle on] [Toggle on] Set up customized payout groups to enable payout groups then select Add New.

  4. In the Rules field, select Item Catalog Category from the drop-down menu and in the second drop-down menu select is.

  5. In the third text field, enter the Name of your SKU Exception List. A list of your existing lists will appear when you start typing, which you can select.

    Screenshot_2024-10-04_at_12_09_35.png
  6. Set the Payout you want for items on the list.

  7. Select Add to complete the process.

From here, you can continue modifying (or creating) your template terms as usual.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.