The contract object holds information for a contract. You can retrieve a contract’s object as well as list all contract objects. You can also download an active contract and the public or custom terms of a contract in PDF format via API.
Attributes
Id
string
Id
stringUnique identifier for the object referred to as the impact.com Contract Id.
CampaignId
integer
CampaignId
integerThe unique identifier of the program (formerly known as campaigns) that you have partnered with.
Status
enum
Status
enumStatus of the contract.
Possible enum values | |
---|---|
ACTIVE | Contract is currently active. |
PENDING | Contract is pending, awaiting an action from either the brand or the partner. |
UPCOMING | Contract that has been approved by both sides but has yet to reach its start date. |
DECLINED | Contract was rejected by a party. |
EXPIRED | Contract is no longer active. |
StartDate
datetime
StartDate
datetimeStart date and time of the contract. See ISO-8601.
EndDate
datetime
EndDate
datetimeIf Status=EXPIRED
, the end date and time of the contract. See ISO-8601.
BrandSignatory
string
BrandSignatory
stringBrand representative that agreed to the contract.
BrandSignatoryDate
datetime
BrandSignatoryDate
datetimeDate and time the brand representative agreed to the contract. See ISO-8601.
PartnerSignatory
string
PartnerSignatory
stringPartner representative that agreed to the contract.
PartnerSignatoryDate
datetime
PartnerSignatoryDate
datetimeDate and time the partner representative agreed to the contract. See ISO-8601.
DateCreated
datetime
DateCreated
datetimeDate and time the contract was created. See ISO-8601.
DateLastUpdated
datetime
DateLastUpdated
datetimeDate and time the contract was last updated. See ISO-8601. Will be empty if the contract has not been updated. Contracts are immutable—any changes made to the contract aside from EndDate
will generate a new contract.
EventPayouts
array
EventPayouts
arrayPayout details for the event type(s) used in the contract.
View child attributes
EventTypeId
integer
EventTypeId
integerEvent type’s impact.com-assigned Id.
EventTypeName
string
EventTypeName
stringName of the event type.
EventCategory
enum
EventCategory
enumWhat type of event type is used in the contract.
Possible enum values | |
---|---|
LEAD | Contract pays out for sale leads. |
SALE | Contract pays out for online sales. |
DOWNLOAD | Contract pays out for consumer downloads. |
PAGE_VISIT | Contract pays out for traffic driven to a specific website. |
CALL_PER_RING | Contract pays out for each phone call regardless of call outcome. |
CALL_PER_DURATION | Contract pays out for total call time. |
CALL_PER_CONVERSATION | Contract pays out for each call conversation. |
PARTNER_REFERRAL | Contract pays out for partner referrals. |
DATA_POST | Contract pays out for leads generated from partner data forms. |
OFFLINE | Contract pays out for offline conversions. |
CLICK | Contract pays out for clicks. |
MOBILE_APP | Contract pays out for mobile app installs. |
DefaultPayout
decimal
DefaultPayout
decimalIf the contract's payout type is Fixed
, this is the default payout amount. If present, DefaultPayoutRate
will not be.
DefaultPayoutRate
decimal
DefaultPayoutRate
decimalIf the contract's payout type is Percent
, this is the default percent of the sale that will become the payout. If present, DefaultPayout
will not be.
PayoutLevel
enum
PayoutLevel
enumThe order level that the contract pays out at.
Possible enum values | |
---|---|
ITEM | Payouts will be based on the items sold within an order. |
ORDER | Payouts will be based on the order as a whole. |
CLICK | Contract pays out for clicks. |
CALL | Contract pays out for calls. |
PayoutGroups
array
PayoutGroups
arrayPayout groups that the contract has set up.
View child attributes
Id
string
Id
stringPayout group’s Id.
Rank
integer
Rank
integerRank order of a payout group.
Rules
array
Rules
arrayRules for how a specific payout group is triggered.
View child attributes
Variable
enum
Variable
enumWhat the payout group looks for.
Possible enum values | |
---|---|
ITEM_SKU | SKU number of the item. |
ITEM_SKU_LIST | Array of item SKU numbers. |
ITEM_CATEGORY | Category that the item is listed in. |
ITEM_CATEGORY_LIST | Category list an item is placed in. |
ITEM_SUBCATEGORY | Subcategory an item is placed in. |
ITEM_BRAND | Brand that makes an item. |
ITEM_PRICE | Price of an item. |
ITEM_QUANTITY | Quantity of an item. |
ITEM_PROMO_CODE | Promo code associated with an item. |
ITEM_PROMO_CODE_LIST | Promo code list associated with an item. |
ITEM_DISCOUNT | Item’s discount. |
ITEM_SUBTOTAL | Item’s subtotal before any deals or fees are applied. |
ITEM_CATALOG_CATEGORY | The catalog category an item was placed in. |
ITEM_CATALOG_ORIGINAL_FORMAT_CATEGORY | The original catalog category an item was placed in. |
ITEM_CATALOG_SUBCATEGORY | The catalog subcategory an item was placed in. |
ITEM_CATALOG_MANUFACTURER | The item’s manufacturer as it is listed in a product catalog. |
ORDER_PROMO_CODE | Promo code used in the order. |
ORDER_PROMO_CODE_LIST | List a promo code used was placed in. |
ORDER_DISCOUNT | Order’s discount. |
ORDER_SHIPPING | Order’s shipping cost. |
ORDER_TAX | Tax applied to an order. |
ORDER_PAYMENT_TYPE | How a customer pays for an order. |
ORDER_LOCATION_ID | The location Id an order was placed in. |
ORDER_LOCATION_NAME | The location name an order was placed in. |
ORDER_LOCATION_TYPE | The location type an order was placed in. |
ORDER_TOTAL | The order total. |
GIFT_PURCHASE | If the product purchased is intended to be a gift. |
CURRENCY | The currency used to purchase the product. |
CUSTOMER_CITY | The city a customer purchased the product from. |
CUSTOMER_REGION | Region the customer purchased from. |
CUSTOMER_POSTCODE | Postal code the customer purchased from. |
CUSTOMER_COUNTRY | Country the customer purchased from. |
CUSTOMER_STATUS | If the customer is new, existing, re-engaged, frequent, or another status. |
MONEY1 | A unique money value. |
MONEY2 | A unique money value. |
MONEY3 | A unique money value. |
DATE1 | A custom date value. See ISO 8601. |
DATE2 | A custom date value. See ISO 8601. |
DATE3 | A custom date value. See ISO 8601. |
NUMERIC1 | A custom numeric value. |
NUMERIC2 | A custom numeric value. |
NUMERIC3 | A custom numeric value. |
TEXT1 | A custom text value. |
TEXT2 | A custom text value. |
TEXT3 | A custom text value. |
SITE_CATEGORY | The category a site was placed in. |
SITE_VERSION | A website’s version. |
HEAR_ABOUT_US | How a customer heard about the brand or product. |
NOTE | A note. |
DERIVED_COUNTRY | What country the payout group is derived from. |
DERIVED_STATE_REGION | What state or region the payout group is derived from. |
DERIVED_DEVICE_TYPE | What device type the payout group is derived from. |
DERIVED_BROWSER | What browser the payout group is derived from. |
DERIVED_OS | What operating system the payout group is derived from. |
REFERRAL_TYPE | How the customer was referred to the product. |
REFERRAL_AD | Ad associated with the referring action. |
REFERRAL_DEAL | Deal associated with the referring action. |
REFERRAL_SHARED_ID | SharedId associated with the referring action. |
REFERRAL_TRAFFIC_CATEGORY | Traffic category associated with the referring action. |
REFERRAL_TRAFFIC_SOURCE | Traffic source associated with the referring action. |
REFERRAL_SKU | SKU code associated with the referring action. |
REFERRAL_URL | URL associated with the referring action. |
REFERRAL_LANDING_PAGE | Landing page associated with the referring action. |
REFERRAL_AD_PLACEMENT | Ad placement associated with the referring action. |
REFERRAL_AD_TYPE | Ad type associated with the referring action. |
REFERRAL_AD_KEYWORD | Ad keyword associated with the referring action. |
REFERRAL_AD_CAMPAIGN | Ad program (formerly known as campaign) associated with the referring action. |
REFERRAL_AD_CAMPAIGN_ID | Ad program (formerly known as campaign) Id associated with the referring action. |
REFERRAL_AD_GROUP | Ad group associated with the referring action. |
REFERRAL_AD_GROUP_ID | Ad group Id associated with the referring action. |
REFERRAL_PARAM1 | Param parameter associated with the referring action. |
REFERRAL_PARAM2 | Param parameter associated with the referring action. |
REFERRAL_PARAM3 | Param parameter associated with the referring action. |
REFERRAL_PARAM4 | Param parameter associated with the referring action. |
REFERRAL_SUB_ACCOUNT_ID | Sub account Id associated with the referring action. |
REFERRAL_SUB_ACCOUNT_NAME | Sub account name associated with the referring action. |
REFERRAL_DERIVED_COUNTRY | Payout group’s derived country associated with the referring action. |
REFERRAL_DERIVED_STATE_REGION | Payout group’s derived state or region associated with the referring action. |
REFERRAL_DERIVED_DEVICE_TYPE | Payout group’s derived device type associated with the referring action. |
REFERRAL_DERIVED_BROWSER | Payout group’s derived web browser associated with the referring action. |
REFERRAL_DERIVED_OS | Payout group’s derived operating system associated with the referring action. |
CALLER_COUNTRY | Country the caller called from. |
CALLED_COUNTRY | Country of the call recipient. |
CALLED_NUMBER | Phone number of the call recipient. |
CALL_DURATION | Duration of the phone call. |
CALL_TALK_DURATION | Duration of the phone conversation. |
CALL_PHONE_TYPE | Type of phone the call recipient used. |
CALL_KEY1 | A custom call key. |
CALL_KEY2 | A custom call key. |
CALL_KEY3 | A custom call key. |
CALL_KEY4 | A custom call key. |
CALL_TRAFFIC_SOURCE | Traffic source associated with the phone call. |
PATH_PARTICIPATION_CHANNELS | What channels were involved in a customer’s journey. |
PATH_PARTICIPATING_MEDIA | What partner(s) were involved in a customer’s journey. |
PATH_PARTICIPATING_GROUPS | What partner groups were involved in a customer’s journey. |
PATH_STEPS | Amount of steps a customer took on their journey. |
PATH_INTRODUCING_MEDIA | Partner(s) that started a customer’s journey. |
PATH_INTRODUCING_GROUPS | Comma-separated list of the partner group(s) that began a customer’s journey. |
PATH_INTRODUCING_CHANNELS | Comma-separated list of the channel(s) that began a customer’s journey. |
PATH_CLOSING_MEDIA | Partner that closed a customer journey. |
PATH_CLOSING_GROUPS | Comma-separated list of the partner group(s) that closed the sale. |
PATH_CLOSING_CHANNELS | Comma-separated list of channels that closed the sale. |
PATH_MEDIA_COUNT | How many media pieces were involved in the customer’s journey. |
PATH_IMPACT_PARTNER_COUNT | How many partners were involved in the customer’s journey. |
PATH_PARTNER_COUNT | How many partners were involved in a customer’s journey. |
PATH_CHANNEL_COUNT | How many steps the customer took on their purchase journey. |
Operator
enum
Operator
enumHow the Variable
is applied.
Possible enum values | |
---|---|
IS | Variable must be Value . |
IS_NOT | Variable cannot be Value . |
IS_NOT_WHEN_PRESENT | If Variable is present, it cannot be Value . Only for string Values . |
IS_PRESENT | If Variable is present. |
IS_NOT_PRESENT | If Variable is not present. |
RANGE | Number range that Value can land in. Only for integer Values .
|
LESS_THAN | Variable must be lower than Value . Only for integer Values . |
GREATER_THAN | Variable must be greater than Value . Only for integer Values . |
DATE_RANGE | Variable must land within the date range defined in Value . |
DATE_LESS_THAN | Variable must be before the date defined in Value . |
DATE_GREATER_THAN | Variable Value. |
WILDCARD | If the listed character string(s) appear anywhere in Value . Only for string Values . |
BEGINS_WITH | If Value begins with certain characters. Only for string Values . |
ENDS_WITH | If Value ends with certain characters. Only for string Values .
|
CONTAINS | If Value contains certain characters. Only for string Values .
|
DOES_NOT_CONTAIN | If Value does not contain certain characters. Only for string Values .
|
COLLECTION_CONTAINS | If Value is contained within the collection. |
COLLECTION_DOES_NOT_CONTAIN | If Value is not contained in the collection. |
Values
array
Values
arrayWhat Variable
is looking for. Will be empty if Variable: IS_PRESENT
or Variable: IS_NOT_PRESENT
.
Payout
decimal
Payout
decimalThe payout amount if the payout rule is applied. If present, PayoutRate
will not be.
PayoutRate
integer
PayoutRate
integerOrder percentage that will become the payout if the tier is met. If present, Payout
will not be.
Limits
array
Limits
arrayRules that limit the payout group applying to an action.
View child attributes
Type
enum
Type
enumHow the limit is applied.
Possible enum values | |
---|---|
CLICKS | Click count will be limited. |
ITEM | Item count will be limited. |
PAYOUT | An action’s payout will be limited. |
ACTION | Amount of actions payable will be limited. |
CONCURRENT_CALLS | Number of concurrent call will be limited. |
Subtype
enum
Subtype
enumAny additional scope on what the limit rules look for.
Possible enum values | |
---|---|
SKU | An item's SKU number. |
CATEGORY | Category an item is placed in. |
TEXT2 | A custom text value. |
Value
decimal
Value
decimalIf Type="PAYOUT"
, then the payout maximum. If Type="ACTIONS"
, then the maximum amount of payable actions.
LimitBy
enum
LimitBy
enumWhat level Value
is applied to.
Possible enum values | |
---|---|
ITEM | LimitBy is applied to each item. |
ORDER | LimitBy is applied to the entire order. |
CUSTOMER | LimitBy is applied to each customer. |
CLICK | LimitBy is applied to each click. |
CALLER_ID | LimitBy is applied to each caller Id. |
Period
enum
Period
enumHow often the limit resets. If LimitBy="CLICK"
, will not appear.
Possible enum values | |
---|---|
DAY | Payout limit resets daily. |
WEEK | Payout limit resets weekly. |
MONTH | Payout limit resets monthly. |
QUARTER | Payout limit resets quarterly. |
CONTRACT_DURATION | Limit lasts the duration of the contract. |
WeekendOverrideValue
integer
WeekendOverrideValue
integerWhat the limit becomes during the weekends.
Tiers
array
Tiers
arrayPayout tiers of the payout group. These tiers will apply based on the performance of the component items or variables within the rule. As partners drive more traffic, events, or conversions, they can reach higher payout tiers (which would change their payouts or payout rates).
View child attributes
RevenueThreshold
decimal
RevenueThreshold
decimalMinimum revenue needed for the next payout group tier to initiate. If used, neither ActionThreshold
nor ParentTier
will appear for this payout group.
ActionThreshold
integer
ActionThreshold
integerMinimum number of actions needed for the next payout group tier to initiate. If used, neither RevenueThreshold
nor ParentTier
will appear for this payout group.
ParentTier
integer
ParentTier
integerMinimum number of actions needed for all payout groups to collectively advance to their next respective tier. All payout groups contribute to the same ParentTier
. If used, neither RevenueThreshold
nor ActionThreshold
will appear for this payout group.
Payout
decimal
Payout
decimalThe payout amount if the tier is met. If present, PayoutRate
will not be.
PayoutRate
decimal
PayoutRate
decimalOrder percentage that will become the payout if the tier is met. If present, Payout
will not be.
PayoutAdjustments
array
PayoutAdjustments
arrayConditions that can change an action’s payout details.
View child attributes
Id
string
Id
stringPayout adjustment’s Id.
Rules
array
Rules
arrayRules for how the payout adjustment applies.
View child attributes
Variable
enum
Variable
enumWhat the payout group looks for.
Possible enum values | |
---|---|
ITEM_SKU | SKU number of the item. |
ITEM_SKU_LIST | Array of item SKU numbers. |
ITEM_CATEGORY | Category that the item is listed in. |
ITEM_CATEGORY_LIST | Category list an item is placed in. |
ITEM_SUBCATEGORY | Subcategory an item is placed in. |
ITEM_BRAND | Brand that makes an item. |
ITEM_PRICE | Price of an item. |
ITEM_QUANTITY | Quantity of an item. |
ITEM_PROMO_CODE | Promo code associated with an item. |
ITEM_PROMO_CODE_LIST | Promo code list associated with an item. |
ITEM_DISCOUNT | Item’s discount. |
ITEM_SUBTOTAL | Item’s subtotal before any deals or fees are applied. |
ITEM_CATALOG_CATEGORY | The catalog category an item was placed in. |
ITEM_CATALOG_ORIGINAL_FORMAT_CATEGORY | The original catalog category an item was placed in. |
ITEM_CATALOG_SUBCATEGORY | The catalog subcategory an item was placed in. |
ITEM_CATALOG_MANUFACTURER | The item’s manufacturer as it is listed in a product catalog. |
ORDER_PROMO_CODE | Promo code used in the order. |
ORDER_PROMO_CODE_LIST | List a promo code used was placed in. |
ORDER_DISCOUNT | Order’s discount. |
ORDER_SHIPPING | Order’s shipping cost. |
ORDER_TAX | Tax applied to an order. |
ORDER_PAYMENT_TYPE | How a customer pays for an order. |
ORDER_LOCATION_ID | The location Id an order was placed in. |
ORDER_LOCATION_NAME | The location name an order was placed in. |
ORDER_LOCATION_TYPE | The location type an order was placed in. |
ORDER_TOTAL | The order total. |
GIFT_PURCHASE | If the product purchased is intended to be a gift. |
CURRENCY | The currency used to purchase the product. |
CUSTOMER_CITY | The city a customer purchased the product from. |
CUSTOMER_REGION | Region the customer purchased from. |
CUSTOMER_POSTCODE | Postal code the customer purchased from. |
CUSTOMER_COUNTRY | Country the customer purchased from. |
CUSTOMER_STATUS | If the customer is new, existing, re-engaged, frequent, or another status. |
MONEY1 | A unique money value. |
MONEY2 | A unique money value. |
MONEY3 | A unique money value. |
DATE1 | A custom date value. See ISO 8601. |
DATE2 | A custom date value. See ISO 8601. |
DATE3 | A custom date value. See ISO 8601. |
NUMERIC1 | A custom numeric value. |
NUMERIC2 | A custom numeric value. |
NUMERIC3 | A custom numeric value. |
TEXT1 | A custom text value. |
TEXT2 | A custom text value. |
TEXT3 | A custom text value. |
SITE_CATEGORY | The category a site was placed in. |
SITE_VERSION | A website’s version. |
HEAR_ABOUT_US | How a customer heard about the brand or product. |
NOTE | A note. |
DERIVED_COUNTRY | What country the payout adjustment is derived from. |
DERIVED_STATE_REGION | What state or region the payout adjustment is derived from. |
DERIVED_DEVICE_TYPE | What device type the payout adjustment is derived from. |
DERIVED_BROWSER | What browser the payout adjustment is derived from. |
DERIVED_OS | What operating system the payout adjustment is derived from. |
REFERRAL_TYPE | How the customer was referred to the product. |
REFERRAL_AD | Ad associated with the referring action. |
REFERRAL_DEAL | Deal associated with the referring action. |
REFERRAL_SHARED_ID | SharedId associated with the referring action. |
REFERRAL_TRAFFIC_CATEGORY | Traffic category associated with the referring action. |
REFERRAL_TRAFFIC_SOURCE | Traffic source associated with the referring action. |
REFERRAL_SKU | SKU code associated with the referring action. |
REFERRAL_URL | URL associated with the referring action. |
REFERRAL_LANDING_PAGE | Landing page associated with the referring action. |
REFERRAL_AD_PLACEMENT | Ad placement associated with the referring action. |
REFERRAL_AD_TYPE | Ad type associated with the referring action. |
REFERRAL_AD_KEYWORD | Ad keyword associated with the referring action. |
REFERRAL_AD_CAMPAIGN | Ad program (formerly known as campaign) associated with the referring action. |
REFERRAL_AD_CAMPAIGN_ID | Ad program (formerly known as campaign) Id associated with the referring action. |
REFERRAL_AD_GROUP | Ad group associated with the referring action. |
REFERRAL_AD_GROUP_ID | Ad group Id associated with the referring action. |
REFERRAL_PARAM1 | Param parameter associated with the referring action. |
REFERRAL_PARAM2 | Param parameter associated with the referring action. |
REFERRAL_PARAM3 | Param parameter associated with the referring action. |
REFERRAL_PARAM4 | Param parameter associated with the referring action. |
REFERRAL_SUB_ACCOUNT_ID | Sub account Id associated with the referring action. |
REFERRAL_SUB_ACCOUNT_NAME | Sub account name associated with the referring action. |
REFERRAL_DERIVED_COUNTRY | Payout adjustment's derived country associated with the referring action. |
REFERRAL_DERIVED_STATE_REGION | Payout adjustment's derived state or region associated with the referring action. |
REFERRAL_DERIVED_DEVICE_TYPE | Payout adjustment's derived device type associated with the referring action. |
REFERRAL_DERIVED_BROWSER | Payout adjustment's derived web browser associated with the referring action. |
REFERRAL_DERIVED_OS | Payout adjustment's derived operating system associated with the referring action. |
CALLER_COUNTRY | Country the caller called from. |
CALLED_COUNTRY | Country of the call recipient. |
CALLED_NUMBER | Phone number of the call recipient. |
CALL_DURATION | Duration of the phone call. |
CALL_TALK_DURATION | Duration of the phone conversation. |
CALL_PHONE_TYPE | Type of phone the call recipient used. |
CALL_KEY1 | A custom call key. |
CALL_KEY2 | A custom call key. |
CALL_KEY3 | A custom call key. |
CALL_KEY4 | A custom call key. |
CALL_TRAFFIC_SOURCE | Traffic source associated with the phone call. |
PATH_PARTICIPATION_CHANNELS | What channels were involved in a customer’s journey. |
PATH_PARTICIPATING_MEDIA | What partner(s) were involved in a customer’s journey. |
PATH_PARTICIPATING_GROUPS | What partner groups were involved in a customer’s journey. |
PATH_STEPS | Amount of steps a customer took on their journey. |
PATH_INTRODUCING_MEDIA | Partner(s) that started a customer’s journey. |
PATH_INTRODUCING_GROUPS | Comma-separated list of the partner group(s) that began a customer’s journey. |
PATH_INTRODUCING_CHANNELS | Comma-separated list of the channel(s) that began a customer’s journey. |
PATH_CLOSING_MEDIA | Partner that closed a customer journey. |
PATH_CLOSING_GROUPS | Comma-separated list of the partner group(s) that closed the sale. |
PATH_CLOSING_CHANNELS | Comma-separated list of channels that closed the sale. |
PATH_MEDIA_COUNT | How many media pieces were involved in the customer’s journey. |
PATH_IMPACT_PARTNER_COUNT | How many partners were involved in the customer’s journey. |
PATH_PARTNER_COUNT | How many partners were involved in a customer’s journey. |
PATH_CHANNEL_COUNT | How many steps the customer took on their purchase journey. |
Operator
enum
Operator
enumHow the Variable
is applied.
Possible enum values | |
---|---|
IS | Variable must be Value . |
IS_NOT | Variable cannot be Value . |
IS_NOT_WHEN_PRESENT | If Variable is present, it cannot be Value . Only for string Values . |
IS_PRESENT | If Variable is present. |
IS_NOT_PRESENT | If Variable is not present. |
RANGE | Number range that Value can land in. Only for integer Values .
|
LESS_THAN | Variable must be lower than Value . Only for integer Values . |
GREATER_THAN | Variable must be greater than Value . Only for integer Values . |
DATE_RANGE | Variable must land within the date range defined in Value . |
DATE_LESS_THAN | Variable must be before the date defined in Value . |
DATE_GREATER_THAN | Variable Value. |
WILDCARD | If the listed character string(s) appear anywhere in Value . Only for string Values . |
BEGINS_WITH | If Value begins with certain characters. Only for string Values . |
ENDS_WITH | If Value ends with certain characters. Only for string Values .
|
CONTAINS | If Value contains certain characters. Only for string Values .
|
DOES_NOT_CONTAIN | If Value does not contain certain characters. Only for string Values .
|
COLLECTION_CONTAINS | If Value is contained within the collection. |
COLLECTION_DOES_NOT_CONTAIN | If Value is not contained in the collection. |
Values
array
Values
arrayWhat Variable
is looking for. Will be empty if Variable: IS_PRESENT
or Variable: IS_NOT_PRESENT
.
Direction
enum
Direction
enumHow the payout is adjusted.
Possible enum values | |
---|---|
INCREASE | Raise the payout by a certain percentage. |
DECREASE | Lower the payout by a certain percentage. |
ADD | Add a fixed amount to the payout. |
SUBTRACT | Remove a fixed amount from the payout. |
Amount
decimal
Amount
decimalIf Direction: "ADD || SUBTRACT"
, then the fixed amount change will appear.
Rate
integer
Rate
integerIf Direction: "INCREASE || DECREASE"
, then the percent change will appear.
PerformanceBonus
array
PerformanceBonus
arrayAdditional payments to partners if they drive enough actions.
View child attributes
Type
enum
Type
enumTo which actions a performance will be based on.
Possible enum values | |
---|---|
ALL_ACTIONS | Bonus is based on all actions driven. |
SUBSEQUENT_ACTIONS | Bonus is based on all actions after a certain goal is hit. |
FIXED | Bonus is a fixed amount. |
Basis
enum
Basis
enumWhat the bonus is based on. Defaults to REVENUE
.
Possible enum values | |
---|---|
REVENUE | Bonus is based on revenue brought in. |
ACTIONS | Bonus is based on total actions. |
Period
enum
Period
enumHow often a bonus can be granted. Will always be CALENDAR_MONTH
.
BonusTiers
array
BonusTiers
arrayTiering system for the bonus.
View child attributes
RevenueThreshold
decimal
RevenueThreshold
decimalMinimum revenue needed for the next bonus tier to initiate. If used, ActionThreshold
will not appear for this payout group.
ActionThreshold
will not appear for this payout group.ActionThreshold
integer
ActionThreshold
integerMinimum number of actions needed for the next bonus tier to initiate. If used, RevenueThreshold
will not appear for this payout group.
RevenueThreshold
will not appear for this payout group.Payout
decimal
Payout
decimalThe payout amount if the tier is met. If present, PayoutRate
will not be.
PayoutRate
decimal
PayoutRate
decimalOrder percentage that will become the payout if the tier is met. If present, Payout
will not be.
PayoutRestrictions
array
PayoutRestrictions
arrayCustomer order conditions that can prevent a partner from getting paid out.
View child attributes
Id
string
Id
stringId for a specific payout restriction.
Rules
array
Rules
arrayHow a payout restriction is applied.
View child attributes
Variable
enum
Variable
enumWhat the payout group looks for.
Possible enum values | |
---|---|
ITEM_SKU | SKU number of the item. |
ITEM_SKU_LIST | Array of item SKU numbers. |
ITEM_CATEGORY | Category that the item is listed in. |
ITEM_CATEGORY_LIST | Category list an item is placed in. |
ITEM_SUBCATEGORY | Subcategory an item is placed in. |
ITEM_BRAND | Brand that makes an item. |
ITEM_PRICE | Price of an item. |
ITEM_QUANTITY | Quantity of an item. |
ITEM_PROMO_CODE | Promo code associated with an item. |
ITEM_PROMO_CODE_LIST | Promo code list associated with an item. |
ITEM_DISCOUNT | Item’s discount. |
ITEM_SUBTOTAL | Item’s subtotal before any deals or fees are applied. |
ITEM_CATALOG_CATEGORY | The catalog category an item was placed in. |
ITEM_CATALOG_ORIGINAL_FORMAT_CATEGORY | The original catalog category an item was placed in. |
ITEM_CATALOG_SUBCATEGORY | The catalog subcategory an item was placed in. |
ITEM_CATALOG_MANUFACTURER | The item’s manufacturer as it is listed in a product catalog. |
ORDER_PROMO_CODE | Promo code used in the order. |
ORDER_PROMO_CODE_LIST | List a promo code used was placed in. |
ORDER_DISCOUNT | Order’s discount. |
ORDER_SHIPPING | Order’s shipping cost. |
ORDER_TAX | Tax applied to an order. |
ORDER_PAYMENT_TYPE | How a customer pays for an order. |
ORDER_LOCATION_ID | The location Id an order was placed in. |
ORDER_LOCATION_NAME | The location name an order was placed in. |
ORDER_LOCATION_TYPE | The location type an order was placed in. |
ORDER_TOTAL | The order total. |
GIFT_PURCHASE | If the product purchased is intended to be a gift. |
CURRENCY | The currency used to purchase the product. |
CUSTOMER_CITY | The city a customer purchased the product from. |
CUSTOMER_REGION | Region the customer purchased from. |
CUSTOMER_POSTCODE | Postal code the customer purchased from. |
CUSTOMER_COUNTRY | Country the customer purchased from. |
CUSTOMER_STATUS | If the customer is new, existing, re-engaged, frequent, or another status. |
MONEY1 | A unique money value. |
MONEY2 | A unique money value. |
MONEY3 | A unique money value. |
DATE1 | A custom date value. See ISO 8601. |
DATE2 | A custom date value. See ISO 8601. |
DATE3 | A custom date value. See ISO 8601. |
NUMERIC1 | A custom numeric value. |
NUMERIC2 | A custom numeric value. |
NUMERIC3 | A custom numeric value. |
TEXT1 | A custom text value. |
TEXT2 | A custom text value. |
TEXT3 | A custom text value. |
SITE_CATEGORY | The category a site was placed in. |
SITE_VERSION | A website’s version. |
HEAR_ABOUT_US | How a customer heard about the brand or product. |
NOTE | A note. |
DERIVED_COUNTRY | What country the payout group is derived from. |
DERIVED_STATE_REGION | What state or region the payout group is derived from. |
DERIVED_DEVICE_TYPE | What device type the payout group is derived from. |
DERIVED_BROWSER | What browser the payout group is derived from. |
DERIVED_OS | What operating system the payout group is derived from. |
REFERRAL_TYPE | How the customer was referred to the product. |
REFERRAL_AD | Ad associated with the referring action. |
REFERRAL_DEAL | Deal associated with the referring action. |
REFERRAL_SHARED_ID | SharedId associated with the referring action. |
REFERRAL_TRAFFIC_CATEGORY | Traffic category associated with the referring action. |
REFERRAL_TRAFFIC_SOURCE | Traffic source associated with the referring action. |
REFERRAL_SKU | SKU code associated with the referring action. |
REFERRAL_URL | URL associated with the referring action. |
REFERRAL_LANDING_PAGE | Landing page associated with the referring action. |
REFERRAL_AD_PLACEMENT | Ad placement associated with the referring action. |
REFERRAL_AD_TYPE | Ad type associated with the referring action. |
REFERRAL_AD_KEYWORD | Ad keyword associated with the referring action. |
REFERRAL_AD_CAMPAIGN | Ad program (formerly known as campaign) associated with the referring action. |
REFERRAL_AD_CAMPAIGN_ID | Ad program (formerly known as campaign) Id associated with the referring action. |
REFERRAL_AD_GROUP | Ad group associated with the referring action. |
REFERRAL_AD_GROUP_ID | Ad group Id associated with the referring action. |
REFERRAL_PARAM1 | Param parameter associated with the referring action. |
REFERRAL_PARAM2 | Param parameter associated with the referring action. |
REFERRAL_PARAM3 | Param parameter associated with the referring action. |
REFERRAL_PARAM4 | Param parameter associated with the referring action. |
REFERRAL_SUB_ACCOUNT_ID | Sub account Id associated with the referring action. |
REFERRAL_SUB_ACCOUNT_NAME | Sub account name associated with the referring action. |
REFERRAL_DERIVED_COUNTRY | Payout restriction's derived country associated with the referring action. |
REFERRAL_DERIVED_STATE_REGION | Payout restriction's derived state or region associated with the referring action. |
REFERRAL_DERIVED_DEVICE_TYPE | Payout restriction's derived device type associated with the referring action. |
REFERRAL_DERIVED_BROWSER | Payout restriction's derived web browser associated with the referring action. |
REFERRAL_DERIVED_OS | Payout restriction's derived operating system associated with the referring action. |
CALLER_COUNTRY | Country the caller called from. |
CALLED_COUNTRY | Country of the call recipient. |
CALLED_NUMBER | Phone number of the call recipient. |
CALL_DURATION | Duration of the phone call. |
CALL_TALK_DURATION | Duration of the phone conversation. |
CALL_PHONE_TYPE | Type of phone the call recipient used. |
CALL_KEY1 | A custom call key. |
CALL_KEY2 | A custom call key. |
CALL_KEY3 | A custom call key. |
CALL_KEY4 | A custom call key. |
CALL_TRAFFIC_SOURCE | Traffic source associated with the phone call. |
PATH_PARTICIPATION_CHANNELS | What channels were involved in a customer’s journey. |
PATH_PARTICIPATING_MEDIA | What partner(s) were involved in a customer’s journey. |
PATH_PARTICIPATING_GROUPS | What partner groups were involved in a customer’s journey. |
PATH_STEPS | Amount of steps a customer took on their journey. |
PATH_INTRODUCING_MEDIA | Partner(s) that started a customer’s journey. |
PATH_INTRODUCING_GROUPS | Comma-separated list of the partner group(s) that began a customer’s journey. |
PATH_INTRODUCING_CHANNELS | Comma-separated list of the channel(s) that began a customer’s journey. |
PATH_CLOSING_MEDIA | Partner that closed a customer journey. |
PATH_CLOSING_GROUPS | Comma-separated list of the partner group(s) that closed the sale. |
PATH_CLOSING_CHANNELS | Comma-separated list of channels that closed the sale. |
PATH_MEDIA_COUNT | How many media pieces were involved in the customer’s journey. |
PATH_IMPACT_PARTNER_COUNT | How many partners were involved in the customer’s journey. |
PATH_PARTNER_COUNT | How many partners were involved in a customer’s journey. |
PATH_CHANNEL_COUNT | How many steps the customer took on their purchase journey. |
Operator
enum
Operator
enumHow the Variable
is applied.
Possible enum values | |
---|---|
IS | Variable must be Value . |
IS_NOT | Variable cannot be Value . |
IS_NOT_WHEN_PRESENT | If Variable is present, it cannot be Value . Only for string Values . |
IS_PRESENT | If Variable is present. |
IS_NOT_PRESENT | If Variable is not present. |
RANGE | Number range that Value can land in. Only for integer Values .
|
LESS_THAN | Variable must be lower than Value . Only for integer Values . |
GREATER_THAN | Variable must be greater than Value . Only for integer Values . |
DATE_RANGE | Variable must land within the date range defined in Value . |
DATE_LESS_THAN | Variable must be before the date defined in Value . |
DATE_GREATER_THAN | Variable Value. |
WILDCARD | If the listed character string(s) appear anywhere in Value . Only for string Values . |
BEGINS_WITH | If Value begins with certain characters. Only for string Values . |
ENDS_WITH | If Value ends with certain characters. Only for string Values .
|
CONTAINS | If Value contains certain characters. Only for string Values .
|
DOES_NOT_CONTAIN | If Value does not contain certain characters. Only for string Values .
|
COLLECTION_CONTAINS | If Value is contained within the collection. |
COLLECTION_DOES_NOT_CONTAIN | If Value is not contained in the collection. |
Values
array
Values
arrayWhat Variable
is looking for. Will be empty if Variable: IS_PRESENT
or Variable: IS_NOT_PRESENT
.
Limits
array
Limits
arrayRules on how a payout can be limited.
View child attributes
Type
enum
Type
enumHow the limit is applied.
Possible enum values | |
---|---|
CLICKS | Click count will be limited. |
ITEM | Item count will be limited. |
PAYOUT | An action’s payout will be limited. |
ACTION | Amount of actions payable will be limited. |
CONCURRENT_CALLS | Number of concurrent call will be limited. |
Subtype
enum
Subtype
enumAny additional scope on what the limit rules look for.
Possible enum values | |
---|---|
SKU | An item's SKU number. |
CATEGORY | Category an item is placed in. |
TEXT2 | A custom text value. |
Value
decimal
Value
decimalIf Type="PAYOUT"
, then the payout maximum. If Type="ACTIONS"
, then the maximum amount of payable actions.
LimitBy
enum
LimitBy
enumWhat level Value
is applied to.
Possible enum values | |
---|---|
ITEM | LimitBy is applied to each item. |
ORDER | LimitBy is applied to the entire order. |
CUSTOMER | LimitBy is applied to each customer. |
CLICK | LimitBy is applied to each click. |
CALLER_ID | LimitBy is applied to each caller Id. |
Period
enum
Period
enumHow often the limit resets. If LimitBy="CLICK"
, will not appear.
Possible enum values | |
---|---|
DAY | Payout limit resets daily. |
WEEK | Payout limit resets weekly. |
MONTH | Payout limit resets monthly. |
QUARTER | Payout limit resets quarterly. |
CONTRACT_DURATION | Limit lasts the duration of the contract. |
WeekendOverrideValue
integer
WeekendOverrideValue
integerWhat the limit becomes during the weekends.
Locking
array
Locking
arrayAction locking rules for the contract.
View child attributes
Basis
enum
Basis
enumWhen the action locking period begins. Defaults to TRACKED
.
Possible enum values | |
---|---|
TRACKED | When the action is initially tracked by or reported to impact.com. |
APPROVED | When the action has been approved by an account user. |
COMMISSIONABLE | When the action is eligible for commission. |
Period
enum
Period
enumIf there is a delay between the action Basis
occurring and the action locking period beginning. Defaults to MONTH
.
Possible enum values | |
---|---|
DAY | `Period` is measured in days. |
WEEK | `Period` is measured in weeks. |
HALF_MONTH | `Period` is measured in half-months. |
MONTH | `Period` is measured in months. |
MonthOffset
integer
MonthOffset
integerHow many months the action locking period will last. Defaults to 1
.
DayOffset
integer
DayOffset
integerHow many days after the last offset month the action locking period will last. Defaults to 0
.
OpenEndedAutoLockingMode
enum
OpenEndedAutoLockingMode
enumWhat happens to an action at the end of the Open-ended locking period.
Possible enum values | |
---|---|
APPROVE | Actions are defaulted to approved. |
REJECT | Actions are defaulted to rejected. |
MaxMonthsOpenEndedPeriod
integer
MaxMonthsOpenEndedPeriod
integerHow many months an action can stay in open-ended locking.
PayoutScheduling
array
PayoutScheduling
arrayPayout scheduling rules for the contract.
View child attributes
Basis
enum
Basis
enumWhen the payout scheduling period begins. Defaults to LOCKED
.
Possible enum values | |
---|---|
LOCKED | When the action has completed the action locking period. |
INVOICED | When the action has been added to an invoice. |
Period
enum
Period
enumIf there is a delay between the action Basis
occurring and the payout scheduling period beginning.
Possible enum values | |
---|---|
END_OF_DAY | Payout scheduling period will begin at the end of the day the `Basis` event happens. |
END_OF_MONTH | Payout scheduling period will begin at the end of the month the `Basis` event happens. |
MonthOffset
integer
MonthOffset
integerHow many months the payout scheduling period will last. Defaults to 1
.
DayOffset
integer
DayOffset
integerHow many days after the last offset month the payout scheduling period will last. Defaults to 0
.
LocationRequirementType
enum
LocationRequirementType
enumWhat countries must/must not be included in the contract.
Possible enum values | |
---|---|
INCLUDE | Listed countries must be included in potential consumer country list. |
EXCLUDE | Listed countries must be excluded from potential consumer country list. |
LocationRequirementCountries
string
LocationRequirementCountries
stringList of countries that must be included in/excluded from the potential consumer country list.
CreditPolicy
enum
CreditPolicy
enumHow the contract pays out for actions driven.
Possible enum values | |
---|---|
LAST_REFERRER | Last partner to refer the customer gets the sale. |
FIRST_REFERRER | First partner to refer the customer gets the sale. |
LAST_TO_CART | Last partner to get the consumer to add to their cart gets the sale. |
FIRST_TO_CART | First partner to get the consumer to add to their cart gets the sale. |
PARENT_ACTION | Whoever drove the parent action gets the sale. |
ValidReferrals
array
ValidReferrals
arrayHow the contract decides which partner(s) gets credited.
View child attributes
Type
enum
Type
enumAction the contract looks at to decide who gets credited.
Possible enum values | |
---|---|
PARENT_ACTIONS | Contract looks at parent actions. |
CLICKS | Contract looks at clicks. |
IMPRESSIONS | Contract looks at impressions. |
Window
integer
Window
integerMaximum time that a partner can still be credited for driving an action if they drove a customer to take that action.
WindowUnit
enum
WindowUnit
enumThe unit of time for Window
.
Possible enum values | |
---|---|
HOUR | |
DAY |
SpecialTermsList
array
SpecialTermsList
arrayAny custom terms for the contract.
View child attributes
TermsName
string
TermsName
stringCustom terms name.
TermsType
enum
TermsType
enumType of custom terms.
View possible enum values | |
---|---|
CUSTOM | General custom terms. |
EMAIL | Custom terms apply to any emailing. |
COPYWRITING | Custom terms apply to all copywriting. |
PAID_SEARCH | Custom terms apply to any paid search efforts. |
SEO | Custom terms apply SEO efforts. |
TRADEMARK | Custom terms apply to trademarked terms. |
APPROVAL | Custom terms are in regards to the approval process a partner must adhere to. |
TermsContent
string
TermsContent
stringAll of the custom terms.
TermsPdfUri
string
TermsPdfUri
stringThe contract’s custom terms' direct URI to download a PDF copy.
ChangeNotificationPeriod
integer
ChangeNotificationPeriod
integerThe minimum notification time a partner gets to have if the contract terms change.
ReturnPolicy
enum
ReturnPolicy
enumHow much of an action payout recoverable if a customer makes a return.
View possible enum values | |
---|---|
ALWAYS_OK | Payouts on returned orders are always recoverable up to the percentage in MaxReturnPercentage . |
MP_APPROVAL_REQ | Partner approves requested payout returns. |
NO_RETURNS | Partners never need to return payouts for driven actions. |
MaxReturnPercentage
decimal
MaxReturnPercentage
decimalMaximum percentage of payouts returnable per month in the case of customer-returned orders.
ActionLimit
integer
ActionLimit
integerHow many actions a partner can be paid out for in a given time period decided in ActionLimitPeriod
.
ActionLimitPeriod
enum
ActionLimitPeriod
enumHow often the ActionLimit
refreshes.
View possible enum values | |
---|---|
DAY | Action limit resets daily. |
WEEK | Action limit resets weekly. |
MONTH | Action limit resets monthly. |
QUARTER | Action limit resets quarterly. |
IO_DURATION | Limit lasts the duration of the contract. |
SpendLimit
decimal
SpendLimit
decimalMaximum payout to a given partner in a given time period decided in SpendLimitPeriod
.
SpendLimitPeriod
enum
SpendLimitPeriod
enumHow often the SpendLimit
refreshes.
View possible enum values | |
---|---|
DAY | Spend limit resets daily. |
WEEK | Spend limit resets weekly. |
MONTH | Spend limit resets monthly. |
QUARTER | Spend limit resets quarterly. |
IO_DURATION | Limit lasts the duration of the contract. |
MinEarningPerClick
decimal
MinEarningPerClick
decimalPartner’s guaranteed earnings for driving a click.
ContractStartSlottingFee
decimal
ContractStartSlottingFee
decimalPayment to a partner to begin the contract.
FirstActionSlottingFee
decimal
FirstActionSlottingFee
decimalPayment to a partner after they drive their first action.
MonthlySlottingFee
decimal
MonthlySlottingFee
decimalMonthly payment to a partner.
CustomCreativePayer
enum
CustomCreativePayer
enumWho pays for or creates ad creative. Defaults to ADVERTISER
.
View possible enum values | |
---|---|
ADVERTISER | Brand (formerly known as advertiser) pays for ad creative creation. |
PUBLISHER | Partner (formerly known as publisher) pays for ad creative creation. |
NOT_APPLICABLE | Ad creative creation payments are not applicable to the contract. |
PdfUri
string
PdfUri
stringThe contract’s direct URI to download a PDF copy of the contract.
Uri
string
Uri
stringThe contract’s direct URI to view only that contract.
{
"Id": "S-1234567",
"CampaignId": "8882",
"Status": "ACTIVE",
"StartDate": "2021-03-04T16:42:58-05:00",
"EndDate": "",
"BrandSignatory": "ACME Inc",
"BrandSignatoryDate": "2021-03-04T16:37:01-05:00",
"PartnerSignatory": "Wile E Coyote",
"PartnerSignatoryDate": "2021-03-04T16:42:58-05:00",
"DateCreated": "2021-03-04T16:42:58-05:00",
"DateLastUpdated": "2021-03-04T16:42:58-05:00",
"Terms": {
"Currency": "USD",
"EventPayouts": [
{
"EventTypeId": "16027",
"EventTypeName": "Sale",
"EventCategory": "SALE",
"DefaultPayoutRate": "0",
"PayoutLevel": "ITEM",
"PayoutGroups": [
{
"Id": "66bb9761-2760-4c7f-afb9-1ff70c9c8850",
"Rank": "1",
"Rules": [
{
"Variable": "CUSTOMER_CITY",
"Operator": "IS",
"Values": [
"Santa Barbara"
]
}
],
"PayoutRate": "1"
}
],
"PayoutAdjustments": [
{
"Id": "dd926935-2762-426a-910a-a3aabdc57ee4",
"Rules": [
{
"Variable": "DERIVED_BROWSER",
"Operator": "IS",
"Values": [
"FIREFOX"
]
}
],
"Direction": "INCREASE",
"Rate": "1"
}
],
"PerformanceBonus": {
"Type": "SUBSEQUENT_ACTIONS",
"Basis": "ACTIONS",
"Period": "CALENDAR_MONTH",
"Tiers": [
{
"ActionThreshold": "2147483647",
"PayoutRate": "0"
}
]
},
"PayoutRestrictions": [
{
"Id": "08707ac6-ae02-4da2-b009-a0ebf3a38db6",
"Rules": [
{
"Variable": "CUSTOMER_CITY",
"Operator": "IS",
"Values": [
"Los Angeles"
]
}
]
}
],
"Limits": [
{
"Type": "ACTION",
"SubType": "SKU",
"Value": "250.0",
"LimitBy": "CUSTOMER",
"Period": "DAY",
"WeekendOverrideValue": "500"
}
],
"Locking": {
"Basis": "TRACKED",
"Period": "DAY",
"DayOffset": "30"
},
"PayoutScheduling": {
"Basis": "LOCKED",
"Period": "END_OF_DAY",
"DayOffset": "3"
},
"CreditPolicy": "LAST_REFERRER",
"ValidReferrals": [
{
"Type": "CLICKS",
"Window": "30",
"WindowUnit": "DAY"
}
]
}
],
"SpecialTermsList": [
{
"TermsName": "Special Terms",
"TermsType": "CUSTOM",
"TermsPdfUri": "/Mediapartners/<AccountSID>/Campaigns/8882/CustomTerms/10500/Download"
}
],
"ChangeNotificationPeriod": "0",
"ReturnPolicy": "ALWAYS_OK",
"MaxReturnPercentage": "100",
"ActionLimit": "1000",
"ActionLimitPeriod": "MONTH",
"CustomCreativePayer": "ADVERTISER"
},
"PdfUri": "/Mediapartners/<AccountSID>/Campaigns/8882/Contracts/S-9558520/Download",
"Uri": "/Mediapartners/<AccountSID>/Contracts/S-9558520"
}