Real Time Reporting API

The Real Time Reporting API delivers reporting data about advertisers, campaigns, flights and ads within minutes of events after being recorded in our system. While this data is not as comprehensive as Kevel Reporting or Data Shipping, it enables near-instant feedback on the performance of your ads. Data is delivered as a JSON object.

📘

Real Time Reporting API data is a cumulative count of all the impressions, clicks, etc. since either:

  • The creation of your advertiser/campaign/etc.
  • June 1, 2016

To get data for a custom time period, use the parameters described in the endpoints. Data for a custom period is provided only for the past 90 days.

🚧

Real time data is updated approximately every five minutes.

Parameters

Parameter

Description

impressions

A count of impressions for the time period

clicks

A count of clicks for the time period

conversions

A count of conversions for the time period

revenue

A count of revenue for the time period

gmv

A count of gross merchandise value for the time period if GMV is passed on events

Click Bucketing Parameters

These counts originate from the click bucketing feature. Refer to that page for full definitions. Click bucketing data in the Real Time Reporting API is not available prior to June 1, 2021.

Parameter

Description

uniqueclicks

A count of Unique Clicks

fraudclicks

TBA

rawclicks

A count of Raw Clicks

invaliduaclicks

A count of Invalid User Agent Clicks

duplicateimpressionclicks

A count of Duplicate Impression Clicks

testclicks

TBA

suspiciousclicks

A count of Suspicious Clicks

Error Handling

400 Error Message

Likely Cause

Does not exist

Requesting an id that doesn't exist using a GET endpoint

Cannot request data more than 90 days old

Requesting a custom time period outside of past 90 day range

Start date must be before end date

Requesting a start date that's later than the end date

No data for id returned

Requesting an id that doesn't exist using a POST endpoint