/report/insight/metrics

Daily page impressions, ad unit loads, ad loads and misses, and ad impressions. Month and quarter grouping return daily averages, not totals

GET /v1/report/insight/metrics

/report/insight/metrics

cURL

curl --request GET \
  --url https://api.tagdeliver.com/v1/report/insight/metrics \
  --header 'Authorization: Bearer <token>'

200

{
  "results": {
    "dates": [
      "2026-10-19",
      "2026-10-20",
      "2026-10-21"
    ],
    "ad_impression": [
      337505,
      334937,
      311016
    ],
    "ad_unit_load": [
      412880,
      398214,
      377502
    ],
    "ad_unit_load_saas": [
      10412,
      9877,
      9530
    ],
    "ad_load": [
      27631,
      35567,
      27385
    ],
    "ad_load_saas": [
      4210,
      3988,
      3874
    ],
    "ad_miss": [
      21109,
      18888,
      13678
    ],
    "ad_miss_saas": [
      1302,
      1251,
      1187
    ],
    "page_impression": [
      274979,
      240515,
      215180
    ]
  },
  "success": true
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

uid · string

One or more publisher IDs, comma-separated. Defaults to all publishers in your organisation

range · enum<string>

Date range to report on. Preset ranges end yesterday. month_to_date is the current month so far and week_to_date is the current week so far. month_on_month and quarter_on_quarter return the daily average for each month or quarter, with the latest period incomplete. custom requires start and end (YYYY-MM-DD). Other values return a 400 error

Available options: custom, all_time, seven_days, fourteen_days, thirty_days, three_months, six_months, week_to_date, month_to_date, quarter_to_date, year_to_date, last_week, last_month, last_quarter, last_year, month_on_month, quarter_on_quarter, yesterday

start · string<date>

Start date when range=custom

end · string<date>

End date when range=custom

date_group · enum<string> · default: day

Groups the series by day, month or quarter. Month and quarter values are daily averages. month_on_month and quarter_on_quarter group automatically

Available options: day, month, quarter

environment · enum<string> · default: all

Environment or platform to report from

Available options: all, app, web

Response

200 - application/json

results · object · required

Show child attributes

success · boolean · required