Contents

AppsKeywordReportResponse

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

Declaration

object AppsKeywordReportResponse

Properties

NameTypeDescription
resultAppsKeywordResultContainer

Contains the array of keyword report rows, each including keyword metadata, associated performance metrics, and an optional insights.bidRecommendation. If no rows match the request, result is returned as an empty object. See AppsKeywordResultContainer for details.

paginationResponsePagination

Provides pagination state for navigating large result sets. See ResponsePagination for details.

errorError

See ErrorResponse for details.

Discussion

Keyword reports support groupBy dimensions such as countryOrRegion and deviceClass, which adds those dimension values to each row’s metadata.

Example

{
  "result": {
    "rows": [
      {
        "metadata": {
          "id": 888999000,
          "text": "productivity app",
          "matchType": "BROAD",
          "adAccountId": 123456789,
          "campaignId": 444555666,
          "adGroupId": 555666777,
          "status": "ENABLED",
          "deleted": false
        },
        "totalMetrics": {
          "localSpend": {
            "amount": "75.00",
            "currency": "USD"
          },
          "impressions": 5000,
          "taps": 250,
          "ttr": 0.05,
          "cpt": {
            "amount": "0.30",
            "currency": "USD"
          },
          "tapInstalls": 60,
          "totalInstalls": 72
        },
        "granularMetrics": [
          {
            "date": "2025-01-01",
            "localSpend": {
              "amount": "2.40",
              "currency": "USD"
            },
            "impressions": 160,
            "taps": 8,
            "tapInstalls": 2
          }
        ],
        "insights": {
          "bidRecommendation": {
            "suggestedBidAmount": 1.25
          }
        }
      }
    ],
    "summary": {
      "grandTotal": {
        "localSpend": {
          "amount": "482.50",
          "currency": "USD"
        },
        "impressions": 152300,
        "taps": 3210,
        "ttr": 0.021,
        "totalInstalls": 768
      }
    }
  },
  "pagination": {
    "pageSize": 20,
    "offset": 0,
    "totalCount": 1
  }
}

See Also