Get campaign insights

Why a campaign is or is not delivering, from the DSP's own auction report: the auction requests it passed on and why, the requests each of its creatives was ruled out on and why, how it did by site, device, creative and size, and the impressions the DSP filtered out.

These numbers come from the DSP's report, so they can differ slightly from the delivery counts on /performance, which come from our own event files. Days are Pacific time, the DSP's own, unless you send tz: then skip reasons and creative filter reasons follow your days and the other sections stay Pacific. A section the DSP did not report for the range is null, never an empty list.

Default date range is the last 30 days.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Campaign ID (UUID).

Query Params
date

Start of the date range, YYYY-MM-DD. Defaults to 30 days before today (UTC).

date

End of the date range, YYYY-MM-DD. Defaults to today (UTC).

string

IANA time zone name, such as America/New_York. With it, start_date and end_date are calendar days in that zone, and skip_reasons and creative_filter_reasons, which the DSP reports by the hour, cover midnight on the first day to midnight after the last there. sites, devices, creatives, sizes and filter_reasons cover the Pacific days that overlap most of yours: the DSP reports them only per Pacific day. Those are the same dates in the Americas and Europe, and the day before for a zone well east of Pacific (Tokyo's 2026-10-05 reads Pacific 2026-10-04). For a range already under way, Pacific days that would run past the current one shift back, keeping their number, to end on it: just after midnight in Berlin, its today reads the Pacific today. Unlike the performance reads, tz has no earliest start date here.

Responses

401

Missing or invalid authentication.

403

Caller is not a member of the campaign's project.

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json