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

# AppsKeywordReportRow

A single row in an apps keyword report, containing keyword metadata, performance metrics, and optional bid recommendation insights.

## Declaration

```data
object AppsKeywordReportRow
```

## 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 ReportingKeyword for details. insights: Optional keyword insights, including a bidRecommendation suggested bid amount for the keyword. See KeywordInsights for details.

## Discussion

Discussion The metadata field captures keyword identifiers and configuration at report time, and totalMetrics contains the aggregated performance figures across the full reporting period. Example {   "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     }   } }

## 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)