help center

| Submit or View Help Requests | Developer Docs |
| |

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 is 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] → 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.

    Select Save and Add Items to continue.

  5. 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.

  6. 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.

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:

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 [Drop-down menu] → Modify Terms. If you want to create new template terms, select Create Template Terms in the upper right corner.

  3. Select [Toggle on] to enable Payout Groups. Select Add New.

  4. In the first dropdown next to Rules, select List for Item Category.

  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.

  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.

Pixel tracking

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

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

FTP action reporting

For XML format, include the following line when reporting actions:

<CATEGORY>category_name<CATEGORY>

For CSV format, include the following header column:

Category

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] → 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 & 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.

    Select Save and Add Items to continue.

  5. 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.

  6. 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.

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 State 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

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:

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.

  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 [Drop-down menu] → Modify Terms. If you want to create new template terms, select Create Template Terms in the upper right corner.

  3. Select [Toggle on] to enable Payout Groups. Select Add New.

  4. In the first dropdown next to Rules, select List for Item SKU.

  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.

  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.