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

# ImpressionShareRow

A single impression share data row.

## Declaration

```data
object ImpressionShareRow
```

## Properties

day: Date in YYYY-MM-DD format. Present when granularity is DAILY. Read-only. week: Week start date (Sunday) in YYYY-MM-DD format. Present when granularity is WEEKLY_SUN_SAT. Read-only. appName: Display name of the promoted app. Read-only. promotedObjectId: The Adam ID (App Store app identifier) of the promoted app. Serialized as a JSON string representation of an int64. Read-only. countryOrRegion: ISO 3166-1 alpha-2 country or region code (for example, US, CA, GB). Read-only. searchTerm: The search term. Privacy-filtered: suppressed for terms with fewer than 10 impressions. Read-only. lowImpressionShare: Lower bound of the app’s impression share (0–1). See encoding table above. Read-only. highImpressionShare: Upper bound of the app’s impression share (0–1). See encoding table above. Read-only. rank: Stack-ranked position by impression share for this search term and country combination. Rank 1 = highest impression share. Read-only. searchPopularity1to5: Relative search popularity for the search term on a 1–5 scale. 5 = most popular. Read-only.

## Discussion

Discussion Each ImpressionShareRow represents one combination of date, search term, and country or region in an impression share report. The date field present depends on the granularity chosen in ImpressionShareTimeRange: day for DAILY granularity, week for WEEKLY_SUN_SAT granularity. Impression share encoding The lowImpressionShare and highImpressionShare fields use a tiered encoding:  |  |   |  |   |  |   |  |  When both fields are equal and less than 0.91, the value is a precise single-digit percentage. When highImpressionShare is 1, the app holds more than 90% impression share for that term. Example {   "day": "2025-01-10",   "appName": "AwayFinder",   "promotedObjectId": "123456789",   "countryOrRegion": "US",   "searchTerm": "travel planner",   "lowImpressionShare": 0.23,   "highImpressionShare": 0.23,   "rank": 1,   "searchPopularity1to5": 4 }

## See Also

- [ImpressionShareQueryRequest](apple-ads-platform-api/impressionsharequeryrequest.md)
- [ImpressionShareQueryResponse](apple-ads-platform-api/impressionsharequeryresponse.md)
- [ImpressionShareTimeRange](apple-ads-platform-api/impressionsharetimerange.md)
- [ImpressionShareOptions](apple-ads-platform-api/impressionshareoptions.md)
- [SearchTermPopularityQueryRequest](apple-ads-platform-api/searchtermpopularityqueryrequest.md)
- [SearchTermPopularityQueryResponse](apple-ads-platform-api/searchtermpopularityqueryresponse.md)
- [SearchTermPopularityRow](apple-ads-platform-api/searchtermpopularityrow.md)
- [SearchTermPopularityTimeRange](apple-ads-platform-api/searchtermpopularitytimerange.md)
- [ImpressionShareResultContainer](apple-ads-platform-api/impressionshareresultcontainer.md)
- [SearchTermPopularityResultContainer](apple-ads-platform-api/searchtermpopularityresultcontainer.md)
- [KeywordInsights](apple-ads-platform-api/keywordinsights.md)
- [ReportingKeywordBidRecommendation](apple-ads-platform-api/reportingkeywordbidrecommendation.md)