Help Center

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

Set Payout Rules Using Payout Groups

Payout Groups are a way 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 one 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 (e.g., "Customer Status is New & Order Total ≥ $200") at the top, and the more common criteria (e.g., "Order Total ≥ $200") near the bottom.

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 Contracts → Template Terms.

  2. Create a 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-solid.svg [Toggle on] Set up customized payout groups.

  5. To add payout groups one at a time, select Add New.

    • Select the payout group rule(s) from the first drop-down menu.

      • Payout rules vary based on your account edition. Refer to Payout group rule descriptions for more information.

      • Select how the rule should apply to your payout group.

        Payout group rule descriptions

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

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

        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.

    • Enter the payout amount.

    • In the bottom right corner of the modal, select Add.

      Note: If you add multiple rules to one payout group, all rules must apply for the payout group to apply.

  6. To create another group, select Add new again. If you have multiple rules, you can click and drag them around to change their rank.

  7. Continue creating your template term.

    Screenshot_2024-02-06_at_09_39_39.png

Note: You can use the wildcard option when setting up a Referral URL, which will match any former or following characters. For example: *facebook* as the wildcard 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, Roadrunning will be interpreted as Item Category is ACME OR Roadrunning). You can get around this by placing quotation marks around your rule containing a comma (Item Category is "ACME,Roadrunning").

Did you find it helpful? Yes No

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