Reports

Create a Report

Request Body (JSON)

date_from string, required	The start date in the format YYYY-MM-DD.
date_until string	The end date in the format YYYY-MM-DD. Defaults to today's date.
events array	An array containing the events you want to retrieve. See here below. Example: ["impressions","clicks"]
dimensions array, required	An array containing one or more dimensions for which you wish to retrieve the data. See here below. Example: ["day","campaign_id"]
filter object	An object used for filtering report data. See here below.

The events array

The following events are supported:

• ad_requests
• impressions
• clicks
• redirects
• conversions
• conversion_value
• value
• filled_impressions
• unfilled_impressions
• viewable_impressions
• measurable_impressions
• vast_skipped
• vast_skippable
• vast_started
• vast_q1
• vast_q2
• vast_q3
• vast_completed

The dimension array

The following dimensions are supported:

• year
• month
• day
• hour
• weekday
• hour
• campaign_id
• creative_id
• zone_id
• ad_format
• ad_size
• landing_url
• tier
• country
• region
• city
• language
• domain
• device
• browser

The filter object

You can filter the report data for campaigns or zones:

• campaign_id (array): an array with IDs (example: [123456789,987654321])
• zone_id (array): an array with IDs (example: [123456789,987654321])

Example Request

Example Response