Decision API

📘

If the request does not contain a user key, one is automatically generated in the response. UserKeys are important for Frequency Capping and UserDB.

👍

Note

API Key authentication is not required when making a Decision API request. For added security, Kevel has the option to require API Key authentication. Please reach out to your CSM or [email protected] to enable.

For more on authenticating requests, see this page.

Error Handling

MessageReason(s)
Out of n% placements on the request, none were valid
  • The siteId has been deleted
  • The siteId is not active
  • No siteId on the request
Keywords must be an array or stringKeywords are not a string or an array of strings
invalid JSONJSON is not valid
Request received with no placements definedThe placements object or the request body is missing
No sites foundInvalid SiteId provided in the request
Count must be an integer in the interval [1, 20]placements.count in the request is not between 1 and 20
Event multiplier must be an integer in the interval [1, 100000000]placements.eventMultiplier in the request is not between 1 and 100000000
Path Params
int32
required
Body Params
placements
array of objects
required
placements*
user
object
keywords
array of strings
keywords
string
string
string
boolean
Defaults to false
boolean
Defaults to false
boolean
Defaults to false
boolean
Defaults to false
boolean
consent
object
string
boolean
Defaults to false
float
float
float
integer
string
block
object
Response

Language
LoadingLoading…
Response
Choose an example:
application/json