> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contentignite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /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



## OpenAPI

````yaml /openapi.json get /v1/report/insight/metrics
openapi: 3.0.1
info:
  title: CI Public API
  description: >-
    # Introduction

    Welcome to the Content Ignite API. A central place for all Content Ignite
    functionality. 


    This API enforces a separation between function and form, meaning anything
    you can do in our platforms can be replicated in your own bespoke solution.


    # Authentication

    Authentication is handled via JWTs. You can retrieve your unique JSON Web
    Token from the settings page in the platform, which needs to be passed in
    with every request.

    To do this, simple include it in an Authorization header with the "Bearer"
    key word.


    Please contact support for help getting started.


    # Error Codes

    This is a fully RESTful API, so prepare for a number of different HTTP
    status codes.


    There is also a standard "success" field returned for each request. This
    boolean value can provide a first check against a response.


    # Rate limit

    We reserve the right to block requests if we deem a client to be abusing the
    API.
  version: 1.0.0
servers:
  - url: https://api.tagdeliver.com
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Reporting
  - name: Reporting/Revenue Reports
  - name: Reporting/Experiment Reporting
  - name: Reporting/Campaign Reports
  - name: Reporting/Health Check
  - name: Reporting/Ads.txt
  - name: Reporting/Utility
  - name: Reporting/Insights Hub
  - name: Reporting/Insights Hub/SSP Insights
  - name: Reporting/Insights Hub/Core Web Vitals
  - name: Reporting/Insights Hub/Ads.txt Insights
  - name: Reporting/Insights Hub/Live Insights
  - name: Reporting/Insights Hub/Metrics
  - name: Reporting/Insights Hub/Diagnostics
  - name: Reporting/Insights Hub/Revenue Insights
  - name: Reporting/Insights Hub/Revenue Analytics
  - name: Reporting/Insights Hub/Demand Mix
  - name: Reporting/Insights Hub/Benchmarking
  - name: Organisation
  - name: Organisation/Organisation Meta
  - name: Organisation/Pricing
  - name: Ad Stack
  - name: Ad Stack/Integration
  - name: Publisher
  - name: Publisher/Publisher Stack
  - name: Publisher/Publisher Tag
  - name: Publisher/Publisher Meta
  - name: Publisher/Experiment
  - name: Publisher/Config (Ad unit)
  - name: Publisher/App Placement
  - name: AI
  - name: AI/Activity
  - name: Billing
  - name: Billing/Invoice
  - name: Audit Log
  - name: '[IN PROGRESS] Integration'
  - name: '[IN PROGRESS] Integration/Mapping'
  - name: '[IN PROGRESS] User'
  - name: '[IN PROGRESS] User/Account'
  - name: public
paths:
  /v1/report/insight/metrics:
    get:
      tags:
        - Reporting/Insights Hub/Metrics
        - public
      summary: /report/insight/metrics
      description: >-
        Daily page impressions, ad unit loads, ad loads and misses, and ad
        impressions. Month and quarter grouping return daily averages, not
        totals
      parameters:
        - name: uid
          in: query
          description: >-
            One or more publisher IDs, comma-separated. Defaults to all
            publishers in your organisation
          required: false
          schema:
            type: string
        - name: range
          in: query
          description: >-
            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
          required: false
          schema:
            type: string
            enum:
              - 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
        - name: start
          in: query
          description: Start date when range=custom
          required: false
          schema:
            type: string
            format: date
        - name: end
          in: query
          description: End date when range=custom
          required: false
          schema:
            type: string
            format: date
        - name: date_group
          in: query
          description: >-
            Groups the series by day, month or quarter. Month and quarter values
            are daily averages. `month_on_month` and `quarter_on_quarter` group
            automatically
          required: false
          schema:
            type: string
            enum:
              - day
              - month
              - quarter
            default: day
        - name: environment
          in: query
          description: Environment or platform to report from
          required: false
          schema:
            type: string
            enum:
              - all
              - app
              - web
            default: all
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: object
                    properties:
                      dates:
                        type: array
                        description: >-
                          Dates for the series (YYYY-MM-DD), or the first day of
                          each month or quarter when grouped. Every other array
                          has one value per date, with 0 where there's no data.
                          All arrays are empty when the range has no data
                        items:
                          type: string
                          format: date
                      ad_impression:
                        type: array
                        description: Ad server impressions
                        items:
                          type: number
                      ad_unit_load:
                        type: array
                        description: Ad units loaded on the page (Plug&Play)
                        items:
                          type: number
                      ad_unit_load_saas:
                        type: array
                        description: Ad units loaded on the page (SaaS)
                        items:
                          type: number
                      ad_load:
                        type: array
                        description: Ads loaded (Plug&Play)
                        items:
                          type: number
                      ad_load_saas:
                        type: array
                        description: Ads loaded (SaaS)
                        items:
                          type: number
                      ad_miss:
                        type: array
                        description: Ad requests that came back empty (Plug&Play)
                        items:
                          type: number
                      ad_miss_saas:
                        type: array
                        description: Ad requests that came back empty (SaaS)
                        items:
                          type: number
                      page_impression:
                        type: array
                        description: Pages the tag loaded on
                        items:
                          type: number
                    required:
                      - dates
                      - ad_impression
                      - ad_unit_load
                      - ad_unit_load_saas
                      - ad_load
                      - ad_load_saas
                      - ad_miss
                      - ad_miss_saas
                      - page_impression
                  success:
                    type: boolean
                required:
                  - results
                  - success
              example:
                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
          headers: {}
      deprecated: false
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.