Reporting Stats Service

Overview

Reporting Stats API returns report data consisting of statistics derived from the data collected by the Adform tracking code. Each report is organized as dimensions and metrics. Metrics are the individual measurements of user activity on your property, such as impressions, clicks and conversions. Dimensions break down metrics across some common criteria, such as campaign or line item. When you build a query, you specify which dimensions and metrics you want in your report data.

Currently, two workflows of Reporting Stats API are supported:

Request syntax for ordering data is the same in both workflows.

For synchronous Reporting Stats API, each user has to have "Reporting Stats API" enabled in User Management section.

List of services

Request structure

Response structure

Limitations

  • In every request, date period filter and at least one metric must be specified.
  • A maximum number of 8 dimensions and 10 metrics can be queried in one request.
  • Paging is applied for the results.
ServiceDate rangeNumber of dimensionsNumber of metricsMax rows per pageDefault rows per page

Reporting Stats API (synchronous)

365 days back from today8 dimensions10 metrics3 000250

​Reporting Stats API (asynchronous)

397 days back from todayUnlimited*100 000

*Unlimited response syntax:


        {
   "paging": {
      "limit": 0 // 0 for unlimited response
   }
}
    

Quota

Daily exceeded quota is reset after 24 hours from the first request (e.g., if the first request is made at 10:00 AM, 13/11/2017, the daily quota is reset at 10:00 AM, 14/11/2017).

Quota limits specific to Reporting Stats API applies to all users within one agency:

  • 10 requests per minute;
  • 500 requests per day.
URLLimit

POST https://api.adform.com/v1/reportingstats/agency/reportdata

POST https://api.adform.com/v1/buyer/stats/data

10 requests per minute
500 requests per day
GET https://api.adform.com/v1/buyer/stats/data10 requests per minute
GET https://api.adform.com/v1/buyer/stats/operations10 requests per second
Help

Still have questions?

If you can't find an answer to your question here, email our Support team