Contents

AppsSearchTermReportRow

A single row in an Apps search term report, pairing search-term metadata with total and granular performance metrics.

Declaration

object AppsSearchTermReportRow

Properties

NameTypeDescription
totalMetricsAppsMetrics

See AppsMetrics for details.

granularMetrics[AppsMetrics]

Time-series metrics broken down by the requested granularity (for example, DAILY, WEEKLY). Present only when a granularity is specified in the request. When it isn’t, this field is absent and all data appears in totalMetrics instead.

metadataReportingSearchTerm

See ReportingSearchTerm for details.

Discussion

The metadata field captures the search term text and its associated keyword and ad group context at report time. The totalMetrics field contains the aggregated performance figures across the full reporting period.

Example

{
  "totalMetrics": {
    "localSpend": {
      "amount": "482.50",
      "currency": "USD"
    },
    "impressions": 152300,
    "taps": 3210,
    "ttr": 0.021,
    "cpt": {
      "amount": "0.15",
      "currency": "USD"
    },
    "cpm": {
      "amount": "3.17",
      "currency": "USD"
    },
    "tapInstalls": 640,
    "tapInstallCPI": {
      "amount": "0.75",
      "currency": "USD"
    },
    "totalNewDownloads": 710,
    "totalRedownloads": 58,
    "viewInstalls": 128,
    "totalInstalls": 768,
    "tapNewDownloads": 592,
    "tapRedownloads": 48,
    "viewNewDownloads": 118,
    "viewRedownloads": 10,
    "totalAvgCPI": {
      "amount": "0.63",
      "currency": "USD"
    },
    "totalInstallRate": 0.2393,
    "tapInstallRate": 0.1994,
    "tapPreOrdersPlaced": 22,
    "viewPreOrdersPlaced": 4,
    "totalPreOrdersPlaced": 26
  },
  "granularMetrics": [
    {
      "date": "2025-01-10",
      "localSpend": {
        "amount": "241.25",
        "currency": "USD"
      },
      "impressions": 76150,
      "taps": 1605,
      "ttr": 0.021,
      "cpt": {
        "amount": "0.15",
        "currency": "USD"
      },
      "cpm": {
        "amount": "3.17",
        "currency": "USD"
      },
      "tapInstalls": 320,
      "tapInstallCPI": {
        "amount": "0.75",
        "currency": "USD"
      },
      "totalNewDownloads": 355,
      "totalRedownloads": 29,
      "viewInstalls": 64,
      "totalInstalls": 384,
      "tapNewDownloads": 296,
      "tapRedownloads": 24,
      "viewNewDownloads": 59,
      "viewRedownloads": 5,
      "totalAvgCPI": {
        "amount": "0.63",
        "currency": "USD"
      },
      "totalInstallRate": 0.2393,
      "tapInstallRate": 0.1994,
      "tapPreOrdersPlaced": 11,
      "viewPreOrdersPlaced": 2,
      "totalPreOrdersPlaced": 13
    }
  ],
  "metadata": {
    "campaignId": 123456789,
    "adAccountId": 987654321,
    "searchTermText": "awayfinder travel app",
    "searchTermSource": "SEARCH",
    "keyword": {
      "id": 555666777,
      "campaignId": 123456789,
      "adAccountId": 987654321,
      "deleted": false,
      "text": "awayfinder travel app",
      "status": "ENABLED",
      "matchType": "BROAD",
      "bid": {
        "currency": "USD",
        "amount": "1.50"
      },
      "adGroupId": 234567891,
      "modificationTime": "2025-01-10T08:00:00.000",
      "creationTime": "2025-01-05T08:00:00.000",
      "displayStatus": "RUNNING",
      "adGroup": {
        "name": "AwayFinder Search - Broad",
        "deleted": false
      },
      "countryOrRegion": "US",
      "deviceClass": "IPHONE"
    },
    "adGroupId": 234567891,
    "adGroup": {
      "name": "AwayFinder Search - Broad",
      "deleted": false
    },
    "countryOrRegion": "US",
    "deviceClass": "IPHONE"
  }
}

See Also