Reports

The API provides access to reporting on a campaign that is in planning, currently live, or completed.

Campaign Reporting

All report endpoints will return a CSV file with the respective report as it's contents.

GET /reports/:campaign_token #=> Get a report at campaign level
GET /reports/:campaign_token/:plan_token #=> Get a report at plan level

The endpoint for campaign and plans is the same. If you only pass campaign_token the report will be scoped to campaign level, merging data from all plans. Optionally you can add plan_token to scope the report to a specific plan.

get campaign report

get
Path parameters
campaign_tokenstringRequired
campaign_typestringRequired
report_typestringRequired
Header parameters
X-PARTNER-TOKENstringOptional
Responses
200
successful
text/csv
get
GET /v1/reports/{campaign_token} HTTP/1.1
Host: api.adquick.com
Accept: */*
200

successful

{
  "report_type": "text",
  "campaign_type": "text",
  "campaign_token": "text",
  "plan_token": null
}
Expects:
- campaign_token: The campaign token can be found on the campaign endpoint
- campaign_type: rtb | direct
- report_type: The report varies based on the campaign_type

Returns: csv with the expected report type as its content

get plan report

get
Path parameters
campaign_tokenstringRequired
plan_tokenstringRequired
campaign_typestringRequired
report_typestringRequired
Header parameters
X-PARTNER-TOKENstringOptional
Responses
200
successful
text/csv
get
GET /v1/reports/{campaign_token}/{plan_token} HTTP/1.1
Host: api.adquick.com
Accept: */*
200

successful

{
  "report_type": "text",
  "campaign_type": "text",
  "campaign_token": "text",
  "plan_token": null
}
Expects

- campaign_token: The campaign token can be found on the campaign endpoint
- plan_token: The plan token can be found on the campaign endpoint
- campaign_type: rtb | direct
- report_type: The report varies based on the campaign_type

Returns: csv with the expected report type as its content

Report Types

Report types can vary depending on campaign_type parameter.

For RTB we provide the following reports:

matched_screen_locations
active_screen_locations
creative_specs
media
screen_report
overall_results
plan_report

For Direct we provide the following reports:

booked_units
daily_delivery

Report Type Details

[DIRECT] Booked Units

This reports filter units that were booked for a direct/guaranteed buy campaign

Expected headers:

Geopath tab panel ID, Face ID, Location Description, Market, Size, Screen Type, Unit Type, Vendor, Start date, End date, Price for duration, 4 Week rate card price

[DIRECT] Daily Delivery

The daily_delivery report provides a refined view of campaign performance for Direct campaigns on our OOH platform. In Direct campaigns, impressions and spend are initially distributed linearly across the campaign's duration due to upfront planning and payment. To better align with actual exposure patterns, we generate an impression report after the campaign ends — these are built by capturing daily exposure counts per unit via device ids from mobile location data. We filter the exposures by playlog data provided by the suppliers for digital units. These playlogs indicate when and where ads played on digital screens throughout the booking period. We use this data to weight the linear impressions and spend, producing a more accurate daily distribution while preserving the total campaign-level numbers. Scenarios where the daily_delivery report might be incomplete or linear: 1. digital units playlogs are incomplete 2. unavailable exposures for the units are not collected or unavailable to be collected

This report will output a daily aggregation of Spend and Impressions grouped by Markets. The report will be available one day after the Campaign end date. Expected headers:

date, plan_name, market_name, impressions, spend

[RTB] Matched Screen Locations

This reports filter screens that match all the filters for a plan

Expected headers:

name, plan_name, screen_id, screen_name, device_id, direction, address, lat, lon, screen_is_active, video, audio, banner, venue_type, market, publisher, Dimensions (WxH), impressions, average_cpm, daily_spend, last_active

[RTB] Active Screen Locations

This report filter screens that match all the filters for a plan, and cross against screens that were recently used across other plans

Expected headers:

campaign_name, plan_name, screen_id, screen_name, device_id, direction, address, lat, lon, screen_is_active, video, audio, banner, venue_type, market, publisher, Dimensions (WxH), impressions, average_cpm, daily_spend, last_active

[RTB] Creative Specs

This report shows creative details for the screens on a plan

Expected headers:

Campaign, Plan, Network, Venue Type, Width, Height, Supports Video, Supports Audio, Supports Image, Min Duration, Max Duration, Screens

[RTB] Media

This report returns high level operational details for a plan, like location, audiences and day parting

Plan, Name,	Market,	POI radius,	Dates, Day Parting, Audiences, Screen type, Estimated Impressions, Available Screens, Estimated CPM ($), Media Budget, Campaign Link	

[RTB] Screen Report

This report returns details about screens that went to production on a plan

campaign, plan, id, device_id, screen_name, programmatic_publisher_id, lat, lon, created_at, updated_at, video, banner, ssp_id, address, venue_type, group, image_url, plays, play_time, delivered_impressions, delivered_cpm

[RTB] Overall Results

This report return details about the results that were obtained from a successful launched plan, like delivered impressions, how many times the ad was played, the number of unique screens that were executed

date, publisher, venue_type, geography, campaign, plan, impressions, plays, unique_screens, spend, cpm

Last updated