Schema Reference

Objects

ActionTerm

Information about the limits an advertiser has set up and the commission rates that apply for a specific action tracker.

FieldTypeDescription
actionTrackerActionTracker!The action tracker this term applies to.
commissions[Commission!]!The commission rates and conditions that can apply for this action term.
idID!Action Term ID.
lockingMethodLockingMethod!Determines how actions tracked under this term will be locked.
performanceIncentives[PerformanceIncentive!]!Performance-based commission adjustments that apply when certain thresholds are met.
referralOccurrencesLongNumber of referrals.
referralPeriodLong!Referral period in days.

ActionTracker

Describes an advertiser's integration point with CJ — the action tracker that fires when a commissionable event occurs.

FieldTypeDescription
descriptionStringAction Tracker description.
idID!Action Tracker ID.
nameString!Action Tracker name.
typeActionTrackerType!Action Tracker type. See ActionTrackerType enum.

Commission

Different commission rates and conditions that can apply.

FieldTypeDescription
isViewThroughBoolean!true if this commission applies to view-through attribution (transaction attributed to an ad view rather than a click).
itemListItemListThe item list this commission rate applies to, if any.
promotionalProperties[PromotionalProperty!]!The promotional properties (PIDs) to which this commission rate applies. Empty if this rate applies to all properties.
rankLong!Commission rank. Higher rank = higher priority. When multiple commissions match, the highest-ranked one applies.
rateCommissionRate!The rate paid when all conditions match.
situationCommissionSituationThe situation condition that must be met for this rate to apply, if any.

CommissionRate

The rate that will get paid if all conditions match.

FieldTypeDescription
currencyStringCurrency for fixed commission types. null for percent-based commissions.
typeCommissionRateType!Commission type. See CommissionRateType enum.
valueBigDecimal!Commission value. Represents a percentage (e.g. 5 = 5%) for PERCENT type, or a fixed amount for FIXED and FIXED_PER_ORDER types.

CommissionSituation

A situation condition that an advertiser has set up to pay different commission rates based on certain conditions.

FieldTypeDescription
idID!Situation ID.
nameString!Situation name.

Contract

Contract for an advertiser, including program terms.

ArgumentTypeDescription
advertiserIdID!Company id for Advertiser associated with this contract.
endTimeISODateTimeDate for the contract end.
programTermsProgramTerms!The conditions that are agreed upon for this contract.
startTimeISODateTimeDate for the contract start.
statusContractStatus!Status of contract.

ContractList

List of contracts that match the query.

FieldTypeDescription
countLong!Count of contracts returned in this response.
resultList[Contract!]!List of contracts matching the query, each including program terms.
totalCountLong!Total count of all available contracts matching the query, regardless of limit.

ItemList

Advertisers can group items into item lists and apply different commission rates to the list.

FieldTypeDescription
idID!Item List ID.
nameString!Item List name.

LockingMethod

Determines how actions will be locked.

FieldTypeDescription
durationInDaysLongNumber of days before locking for Fixed Duration type.
typeLockingMethodType!
Determines how actions will be locked.

PerformanceIncentive

Different commission rates depending on factors such as number of actions, amount of commission, amount of sales.

FieldTypeDescription
currencyString!Incentive currency for fixed incentives and thresholds based on commissions or sales amounts.
rewardPerformanceIncentiveReward!The reward which gets applied once the performance incentive threshold is exceeded.
thresholdPerformanceIncentiveThreshold!The threshold from which the performance incentive gets applied.

PerformanceIncentiveReward

The reward which gets applied once the performance incentive threshold is exceeded.

FieldTypeDescription
commissionTypePerformanceIncentiveRewardCommissionType!Type of commission associated to the performance incentive.
typePerformanceIncentiveRewardType!Type of reward associated to the performance incentive.
valueBigDecimal!Reward value

PerformanceIncentiveThreshold

The threshold from which the performance incentive gets applied.

FieldTypeDescription
typePerformanceIncentiveThresholdType!Type of threshold associated to the performance incentive.
valueBigDecimal!Threshold value.

ProgramTerms

The conditions that are agreed upon for this contract.

FieldTypeDescription
actionTerms[ActionTerm!]!List of action terms.
idID!Program Terms id.
isDefaultBoolean!Default program terms gets assigned automatically when entering a relationship with the advertiser.
nameString!Program Terms name.
specialTermsSpecialTermsSpecial terms and conditions that apply to this program term. These are specified by the advertiser and are outside of the standard program term rules.

PromotionalProperty

The promotional properties to which this commission rate applies

FieldTypeDescription
idID!Promotional property id.
nameString!Promotional property name.

PublisherQueries

Publisher related operations.

FieldTypeDescription
contractsContractList!Returns one or more contracts filtered according to the supplied arguments.
ArgumentTypeDescription
filtersContractFiltersOptional set of filters.
limitIntHow many contracts to request at once.
offsetIntOffset in the list of contracts.
publisherIdID!Publisher to query for.

SpecialTerms

Special terms and conditions that apply to this program term. These are specified by the advertiser and are outside of the standard program term rules.

FieldTypeDescription
bodyStringBody text of the special terms.
nameStringName of the special terms.

Input Objects

ContractFilters

Optional set of filters

FieldTypeDescription
advertiserIdIDIf given, will return all contracts with this specific advertiser
activeAfterISODateTimeIf given, will return all contracts that are active after this given time
activeBeforeISODateTimeIf given, will return all contracts that are active before this given time

Enums

ActionTrackerType

ValueDescription
item_saleItem Sale action tracker
item_leadItem Lead action tracker
sim_leadSimple Lead action tracker
sim_saleSimple Sale action tracker
clickClick action tracker
impImpression action tracker

CommissionRateType

Commission Type

ValueDescription
FIXED_PER_ORDERFixed per order commission
FIXEDFixed per item commission
PERCENTPercent commission

ContractStatus

ValueDescription
PENDING_REVERSIONPending reversion contract
PENDING_OFFERPending publisher accept contract
CANCELLEDCancelled contract
EXPIREDExpired contract
ACTIVEActive contract

LockingMethodType

Determines how actions will be locked

ValueDescription
FIXED_DURATIONActions will be locked the specified number of days after event date
OPEN_ENDEDActions will be locked by advertisers
FIXED_DATEActions will be locked after the 10th of the month
IMMEDIATEActions will be locked as soon as they are posted or otherwise determined by CJ

PerformanceIncentiveRewardCommissionType

Type of commission associated to the performance incentive

ValueDescription
FIXEDWhen adjusted commission is expressed as a fixed amount, either increase to or bonus
PERCENTWhen adjusted commission is expressed as percent

PerformanceIncentiveRewardType

Type of reward associated to the performance incentive

ValueDescription
ONE_TIME_BONUSOne time bonus applied on top of existing commission
INCREASE_COMMISSION_TONew value of commission after applying performance incentive

PerformanceIncentiveThresholdType

Type of threshold associated to the performance incentive

ValueDescription
TOTAL_SALES_AMOUNTThreshold is based on amount of sales in given currency
TOTAL_COMMISSIONSThreshold is based on amount of commission in given currency
NUMBER_OF_ACTIONSThreshold is based on number of actions

Scalars

NameDescription
BigDecimalThe BigDecimal scalar type represents signed fractional values with arbitrary precision.
BooleanThe Boolean scalar type represents true or false.
IDThe ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.
ISODateTimeISO 8601 datetime. e.g. '1999-12-31T23:59:59Z'
IntThe Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
LongThe Long scalar type represents non-fractional signed whole numeric values. Long can represent values between -(2^63) and 2^63 - 1.
StringThe String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.


Did this page help you?