Help Center

| Submit or View Help Requests | Developer Docs |

View desktop instructions
View mobile app instructions
Set Payout Rules Using Payout Groups

Payout Groups allow you to set rules on partner payouts for actions they drive and they are included in your template terms. 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.

Only 1 payout group can apply at a time. Customized payout groups work best when they're mutually exclusive, so if payout groups have overlapping conditions, place the more specific payout group criteria at the top (e.g., "Customer Status is New & Order Total ≥ $200"), and the more common criteria near the bottom (e.g., "Order Total ≥ $200").

Add a payout group to a template term

This feature is only accessible to specific impact.com editions or add-ons. Contact us to upgrade your account and get access!

Warning: Adding additional payout rules might require some technical knowledge. If you want to configure additional payout rules, contact support.

Payout groups are usually added when you create a template term, but you can always switch out contracts later.

  1. From the left navigation bar, select [Engage] [Engage] → Contracts → Template Terms.

  2. In the upper-right, select Create Template Term.

  3. Next to Event Type, select the event type this template term will be for.

  4. Next to Payout Groups, toggle [Toggle on] [Toggle on] Set up customized payout groups.

  5. To add a payout group, select Add new.

  6. Set up the payout group's payout rules using the [Drop-down menu] [Drop-down menus] and fields.

    Payout rules reference

    Payout rule

    Description

    Currency

    The currency in which the purchase was made. This is used to calculate exchange rates into funding and payment currencies if needed.

    If this is not sent, your account’s default currency will be used.

    Customer City

    City the customer specified in the conversion.

    Customer Country/Region

    The location the customer specified in the conversion.

    Customer Postcode

    Postal (or ZIP) code the customer specified in the conversion.

    Customer Region

    Region code of the customer in the conversion.

    Customer Status

    Status of the customer (e.g., New, Returning, etc.).

    These values must be configured in the Customer Status Mapping section when editing an event type.

    Date1-10

    General date field that accepts a date or datetime you want to send. These values appear in your reports.

    Derived Browser

    Browser determined by the user's IP address at the time of the conversion.

    Derived Country/Region

    Country or region determined by the user's IP address at the time of the conversion.

    Derived Device Type

    The electronic device determined by the user's IP address at the time of the conversion.

    Derived OS

    The device operating system determined by the user's IP address at the time of the conversion.

    Derived State/Region

    The geographical state or region determined by the user's IP address at the time of the conversion.

    Gift Purchase

    If you're tracking gift purchases, you can mark the order in the conversion as a gift purchase.

    Hear About US

    Used to capture how the customer heard about your business.

    Item Brand

    The brand's name associated with the product.

    Item Category

    Category for the product referenced at the item level.

    Item Delivery Type

    The delivery method specified for a product.

    Item Discount

    Discount applied to each item purchased.

    Item Name

    The purchased product's name.

    Item Price

    Individual unit price for each product.

    Item Quantity

    Quantity of the item that was purchased in the order, expressed as a whole number.

    Item SKU

    Unique stock-keeping unit (SKU) value of the product referenced at the item level.

    Item Subcategory

    If applicable, the subcategory for the product referenced at the item level.

    Item Subtotal

    Total price for this line item (all products purchased of this type). The final value will be determined by subtracting the corresponding discounts from this value.

    Money1-3

    General numeral field that accepts strings of any money or financial data you want to send. These values appear in your reports.

    Note

    General field used to pass information for event-level reporting purposes.

    Numeric1-10

    General numeral field that accepts strings of any numeric data you want to send. These values appear in your reports.

    Order Discount

    For sales, this is the discount applied to the order overall. The 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.

    Generally, shipping discounts are excluded.

    Order Location Id

    Used primarily for travel, this specifies the unique identifier for the location for this purchase.

    Order Location Name

    Used primarily for travel, this specifies the location for the purchase.

    Order Location Type

    Used primarily for travel, this specifies the type of location for the purchase.

    Order Payment Type

    How the customer paid for their order.

    Order Promo Code

    The action includes a promo code used by the customer.

    Order Shipping

    Primarily used for retail sales with shipping costs for a conversion. The total sale amount used for payout purposes will not include shipping costs.

    Order Tax

    Primarily used for retail sales with tax costs for a conversion. The total sale amount used for payout purposes will not include tax costs.

    Order Total

    The amount before tax is deducted and after any discount is deducted.

    Referral Ad

    The ad name and ID that triggered the click.

    Referral Ad Campaign

    The ad campaign name of the ad triggering the click (third party/ad server notion of ad and campaign).

    Referral Ad Group

    The third-party ad group that this step in the conversion path is contained in (e.g., Paid Search).

    Referral Group Id

    Google's ID for the third-party ad group.

    Referral Ad Keyword

    Keywords used in Paid Search efforts.

    Referral Ad Placement

    The location of the ad on the partner's page. Typical values are "Home", and "Forum".

    Referral Ad Type

    Which third-party ad distributor served the ad (e.g., Google Ads).

    Referral Deal

    Type of the deal associated with the ad.

    Referral Derived Browser

    The browser determined by the user's IP address at the time of the click.

    Referral Derived Country/Region

    The country or region determined by the user's IP address at the time of the click.

    Referral Derived Device Type

    The device type determined by the user's IP address at the time of the click.

    Referral Derived OS

    The operating system determined by the user's IP address at the time of the click.

    Referral Derived State/Region

    The state determined by the user's IP address at the time of the click.

    Referral Landing Page

    The landing page's URL for the event.

    Referral Param1-4

    Values that partners can include in the click query string and can be anything they want them to be.

    Referral SharedId

    General SharedId field that accepts strings of any SharedIds you want to send. Appears in your reports.

    Referral SKU

    Unique identifier for the item—usually the stock-keeping unit (SKU) identifier of the product being promoted.

    Referral Subaccount ID

    Id of the partner or media source that drove the action.

    Referral Subaccount Name

    Name of the partner or media source that drove the step.

    Referral Traffic Type

    Where users come from when a partner directs them to your site.

    Referral Traffic Source

    Where on the referral site the ad is hosted.

    Referral URL

    The Uniform Resource Locator or link of the website that referred the customer.

    Site Category

    The category associated with your site.

    Site Version

    Specifies the version of the site this customer visited.

    Text1-3

    General text field that accepts strings of any text data you want to send. These values appear in your reports.

    * The following payout rules are only available to specific impact.com editions:

    List for Order Promo Code

    Promo code exception list used to pay partners at different rates based on promo codes associated with actions they drove.

    List for Item SKU

    SKU exception list used to pay partners at different rates based on the SKU associated with the action they drove.

    List for Item Category

    Category exception list used to pay partners at different rates based on the category associated with the action they drove.

    Item Catalog Manufacturer

    The entity that manufactures the item.

    Item Catalog Original Format Category

    The item's category from the original format of the product/item catalog.

    Item Catalog Subcategory

    The second or third level of categorization for a product store.

    Path Channel Count

    How many channels were involved in the conversion path.

    Path Closing Channels

    The channel that drove the partner to the last click (winner) referral.

    Path Closing Groups

    The group that drove the partner to the last click (winner) referral.

    Path Closing Media

    The media channel that drove the partner to the last click (winner) referral.

    Path Impact Partner Count

    The number of partners in the click path determined by impact.com

    Path Introducing Channels

    The channel that introduced the first partner in the click path

    Path Introducing Groups

    The group that introduced the first partner in the click path

    Path Introducing Media

    The media that introduced the first partner in the click path

    Path Media Count

    How many partners and media sources were involved in the conversion path.

    Path Participating Channels

    The channel that brought any partner between introducing and the last (winner) referral.

    Path Participating Groups

    The group that brought any partner between introducing and the last (winner) referral.

    Path Participating Media

    The media that brought any partner between introducing and the last (winner) referral.

    Path Partner Count

    The number of partners in the click path.

    Path Steps

    How many activities (e.g., Impressions) occurred in the conversion path.

    • Optionally, select [Add] [Add another] to create a second rule within the same payout group.

    • If you add multiple rules to 1 payout group, all rules must apply for the payout group to apply.

  7. Enter the Payout amount, and if given the option, specify Limits on payable items.

    • If you don't see the Limits toggle in the modal, contact support to request that the feature be added to your account.

    Screenshot_2024-10-23_at_6_20_11_PM.png
  8. In the lower-right corner of the modal, select Add to save the payout group.

  9. To create another payout group, select Add new. If you create multiple groups, you can click and drag them around to change their rank.

  10. Continue creating your template term.

Note: When setting up a payout group using the Referral URL parameter, you can use the wildcard option to match despite any former or following characters. For example, use *facebook* to match for any Referral URL coming from Facebook.

Combine payout group criteria

Commas in your payout group criteria will not combine the two criteria (e.g., Item Category is ACME, Anvils will be interpreted as Item Category is ACME OR Anvils). You can get around this by placing quotation marks around your rule containing a comma (Item Category is "ACME,Anvils").

Did you find it helpful? Yes No

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