API Reference

Daily

Daily granularity is the default granularity for reports.

Daily granularity data is available for the past 15 months up to yesterday (in UTC time).

Hourly

Hourly granularity takes effect when the HOUR dimension is selected. This returns data for all hours within the given startDate and endDate interval.

Hourly granularity data is available for the previous day and the current day (in UTC time).

It is possible to report on either a single hour or multiple hours for a given day. To do so:

  • Add an HOUR filter to your query
  • Since the filter is applicable to a single day, the startDate and endDate args must match
  • Since filtering by multiple hours is allowed, the HOUR dimension must be selected to receive data split by hour

e.g., An hourly granularity query filtered by hour:

query {
  asyncDownloadPublisherNetworkReport(
    sellerMemberId: "YOUR_MEMBER_ID",
    startDate: "2023-03-09",
    endDate: "2023-03-09",
    dimensions: [
      HOUR
      DEVICE_TYPE
    ],
    metrics: [
      IMPRESSIONS
    ],
    filters: [
      {
        dimension: HOUR,
        values: ["0", "12", "23"]
      }
    ]
  )
}

e.g., The resulting hourly granularity report:

HOUR,DEVICE_TYPE,IMPRESSIONS
0,Desktop,15
0,Phone,25
12,Desktop,16
12,Phone,26
23,Desktop,17
23,Phone,27