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.
|A count of impressions for the time period — the number of times an
impressionUrl was fired
|A count of clicks for the time period — the number of times a
clickUrl was fired
|A count of conversions for the time period — the sum of Event IDs 1, 2, and 3 fired (see Event ID definitions)
|A count of revenue for the time period
|A count of gross merchandise value for the time period if GMV is passed on events
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.
|A count of Unique Clicks
|A count of Raw Clicks
|A count of Invalid User Agent Clicks
|A count of Duplicate Impression Clicks
|A count of Suspicious Clicks
|400 Error Message
Does not exist
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 that doesn't exist using a POST endpoint