---
title: AppsSearchTermReportRow
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/appssearchtermreportrow
---

# AppsSearchTermReportRow

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

## Declaration

```data
object AppsSearchTermReportRow
```

## Properties

totalMetrics: See AppsMetrics for details. granularMetrics: 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. metadata: See ReportingSearchTerm for details.

## Discussion

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

- [AppsReportingRequest](apple-ads-platform-api/appsreportingrequest.md)
- [AppsReportingCampaign](apple-ads-platform-api/appsreportingcampaign.md)
- [AppsReportingAdGroup](apple-ads-platform-api/appsreportingadgroup.md)
- [AppsReportingAd](apple-ads-platform-api/appsreportingad.md)
- [AppsReportingCreative](apple-ads-platform-api/appsreportingcreative.md)
- [AppsCampaignReportResponse](apple-ads-platform-api/appscampaignreportresponse.md)
- [AppsCampaignReportRow](apple-ads-platform-api/appscampaignreportrow.md)
- [AppsCampaignReportSummary](apple-ads-platform-api/appscampaignreportsummary.md)
- [AppsCampaignResultContainer](apple-ads-platform-api/appscampaignresultcontainer.md)
- [AppsAdGroupReportResponse](apple-ads-platform-api/appsadgroupreportresponse.md)
- [AppsAdGroupReportRow](apple-ads-platform-api/appsadgroupreportrow.md)
- [AppsAdGroupReportSummary](apple-ads-platform-api/appsadgroupreportsummary.md)
- [AppsAdGroupResultContainer](apple-ads-platform-api/appsadgroupresultcontainer.md)
- [AppsAdReportResponse](apple-ads-platform-api/appsadreportresponse.md)
- [AppsAdReportRow](apple-ads-platform-api/appsadreportrow.md)