The Kevel Developer Hub

Welcome to the Kevel developer hub. You'll find comprehensive guides and documentation to help you start working with Kevel as quickly as possible, as well as support if you get stuck. Let's jump right in!

Decision Explainer UI

The Decision Explainer UI helps you debug why a particular ad is winning or losing on your ad requests. It is a standalone user interface that makes an ad request against your network using the Decision Explainer mode to get an explanation of why each candidate ad did or did not serve. It is a quick and easy visual way to answer questions like "why didn't this particular ad serve?"

Sample output of Decision Explainer UISample output of Decision Explainer UI

Sample output of Decision Explainer UI

Under the hood, the Decision Explainer UI uses the JavaScript Decision SDK SDK and JavaScript Management SDK to make calls to the Decision API and Management APIs. It is an example application as well as a useful tool in its own right.

How to Use

First enter your API key and a JSON ad request. Note that any valid JSON ad request will work. All features are supported including multiple placements and multi-winner placements.

Optionally, if you have been using the explainer mode directly via API or SDK, then you can either paste or upload your JSON response directly to the tool on the "Paste Explainer Result" or "Load Explainer Result" tabs.

Using the Output

The explainer output is displayed in the following tabs:

  • Results: This quickly displays your ad response and includes convenient links to open campaigns, flights, etc. in the main Kevel UI.

  • Candidates: This tab shows a list of "buckets" (Channel & Priority pairs) from highest to lowest priority. Selecting a "bucket" displays the list of any candidate ads within that bucket. This is where you are likely to spend most of your time as you will quickly be able to go through all your candidate ads to discover why some were filtered out, selected, or not selected.

  • Decision Response JSON: This tab shows the "raw" JSON of the response including both the winning ads and the explanation metadata.

Updated 3 months ago

Decision Explainer UI

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.