Contents

ImpressionShareRow

A single impression share data row.

Declaration

object ImpressionShareRow

Properties

NameTypeDescription
daydate

Date in YYYY-MM-DD format. Present when granularity is DAILY. Read-only.

weekdate

Week start date (Sunday) in YYYY-MM-DD format. Present when granularity is WEEKLY_SUN_SAT. Read-only.

appNamestring

Display name of the promoted app. Read-only.

promotedObjectIdstring

The Adam ID (App Store app identifier) of the promoted app. Serialized as a JSON string representation of an int64. Read-only.

countryOrRegionstring

ISO 3166-1 alpha-2 country or region code (for example, US, CA, GB). Read-only.

searchTermstring

The search term. Privacy-filtered: suppressed for terms with fewer than 10 impressions. Read-only.

lowImpressionSharedouble

Lower bound of the app’s impression share (0–1). See encoding table above. Read-only.

highImpressionSharedouble

Upper bound of the app’s impression share (0–1). See encoding table above. Read-only.

rankinteger

Stack-ranked position by impression share for this search term and country combination. Rank 1 = highest impression share. Read-only.

searchPopularity1to5integer

Relative search popularity for the search term on a 1–5 scale. 5 = most popular. Read-only.

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:

Impression share

lowImpressionShare

highImpressionShare

0%

0

0

1% – 90%

x (for example, 0.23)

x (same value)

91% – 100%

0.91

1

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