View an Ad Candidate List

Overview

You can view an ad candidate list (a list of all eligible creatives for a given request) using a combination of adChain and a Decision API request. This will show you a list of the possible creatives that could serve given their targeting criteria, such as geo-targeting, custom targeting, etc.

Create Candidate List

1. All the candidate creatives must be in flights in the same adChain-enabled priority.
2. The priority must be the top priority in the channel. Otherwise, the request could contain ads from outside the candidate list.

To Retrieve a Candidate List

1. Make a Decision API request for a site in the channel that contains the candidate list.
2. The response will make a decision in the div object. This is one of the eligible creatives.
3. The remainder of the eligible creatives will be listed in the adChain object.