Contents

BrandsAdReportResponse

The top-level response envelope for brands ad-level reports.

Declaration

object BrandsAdReportResponse

Properties

NameTypeDescription
resultBrandsAdResultContainer

Wraps the report rows, each including ad metadata (including creative type and the brands-specific groupBy dimensions deviceClass, locationId, and supplyPlacement) and associated performance metrics. If no rows match the request, result is returned as an empty object. See BrandsAdResultContainer for details.

paginationResponsePagination

See ResponsePagination for details.

errorError

See ErrorResponse for details.

Discussion

Note that ad-level reports don’t support HOURLY granularity.

Example

{
  "result": {
    "rows": [
      {
        "totalMetrics": {
          "date": "2025-01-10",
          "localSpend": {
            "amount": "845.50",
            "currency": "USD"
          },
          "impressions": 620000,
          "taps": 9800,
          "ttr": 0.0158,
          "cpt": {
            "amount": "0.09",
            "currency": "USD"
          },
          "cpm": {
            "amount": "1.36",
            "currency": "USD"
          }
        },
        "granularMetrics": [],
        "metadata": {
          "id": 555666777,
          "name": "AwayFinder - Brands Ad",
          "deleted": false,
          "status": "ENABLED",
          "systemStatus": "RUNNING",
          "adAccountId": 123456789,
          "campaignId": 987654321,
          "adGroupId": 111222333,
          "creationTime": "2025-01-10T08:00:00.000",
          "modificationTime": "2025-01-10T08:00:00.000",
          "displayStatus": "RUNNING",
          "creative": {
            "creativeType": "LOCAL_ADS_SEARCH_CREATIVE"
          },
          "deviceClass": "IPHONE",
          "locationId": 444555666,
          "supplyPlacement": "MAPS_SEARCH_RESULTS"
        }
      }
    ],
    "summary": {
      "grandTotal": {
        "date": "2025-01-10",
        "localSpend": {
          "amount": "845.50",
          "currency": "USD"
        },
        "impressions": 620000,
        "taps": 9800,
        "ttr": 0.0158,
        "cpt": {
          "amount": "0.09",
          "currency": "USD"
        },
        "cpm": {
          "amount": "1.36",
          "currency": "USD"
        }
      }
    }
  },
  "pagination": {
    "pageSize": 20,
    "offset": 0,
    "totalCount": 1
  }
}

See Also