Contents

AppsAdReportResponse

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

Declaration

object AppsAdReportResponse

Properties

NameTypeDescription
resultAppsAdResultContainer

Wraps the array of ad report rows, each containing ad metadata and associated metrics. If no rows match the request, result is returned as an empty object. See AppsAdResultContainer for details.

paginationResponsePagination

Allows paging through all matching ads. See ResponsePagination for details.

errorError

Populated with an ErrorResponse when the request fails. See ErrorResponse for details.

Discussion

Check for error before processing result. Note that ad-level reports don’t support HOURLY granularity.

Example

{
  "result": {
    "rows": [
      {
        "metadata": {
          "id": 234567891,
          "name": "AwayFinder Default Ad",
          "adAccountId": 123456789,
          "campaignId": 444555666,
          "adGroupId": 555666777,
          "status": "ENABLED",
          "deleted": false
        },
        "totalMetrics": {
          "localSpend": {
            "amount": "150.00",
            "currency": "USD"
          },
          "impressions": 10000,
          "taps": 500,
          "ttr": 0.05,
          "cpt": {
            "amount": "0.30",
            "currency": "USD"
          },
          "tapInstalls": 120,
          "totalInstalls": 145
        },
        "granularMetrics": [
          {
            "date": "2025-01-01",
            "localSpend": {
              "amount": "4.80",
              "currency": "USD"
            },
            "impressions": 330,
            "taps": 16,
            "tapInstalls": 4
          }
        ]
      }
    ],
    "summary": {
      "grandTotal": {
        "localSpend": {
          "amount": "150.00",
          "currency": "USD"
        },
        "impressions": 10000,
        "taps": 500,
        "tapInstalls": 120
      }
    }
  },
  "pagination": {
    "offset": 0,
    "pageSize": 20,
    "totalCount": 1
  }
}

See Also