Contents

ImpressionShareQueryResponse

The impression share query endpoint returns this response wrapper.

Declaration

object ImpressionShareQueryResponse

Properties

NameTypeDescription
resultImpressionShareResultContainer

See ImpressionShareResultContainer. If no rows match the request, result is returned as { "rows": [] }, not an empty object.

paginationResponsePagination

See ResponsePagination.

errorError

See Error. Present only on failure.

Response Structure

Top-Level Fields

The ImpressionShareResultContainer wrapping result exposes a single field.

Field

Type

Description

rows

array

Array of Impressionsharerow objects, one per date + search term + country combination

Each ImpressionShareRow in rows carries the following fields.

Field

Type

Description

day

string

Date (YYYY-MM-DD). Present when granularity is DAILY.

week

string

Week start date, Sunday (YYYY-MM-DD). Present when granularity is WEEKLY_SUN_SAT.

appName

string

Display name of the promoted app.

promotedObjectId

string

Adam ID of the promoted app.

countryOrRegion

string

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

searchTerm

string

The search term. Suppressed for terms with fewer than 10 impressions in the aggregation period.

lowImpressionShare

number

Lower bound of impression share. See encoding table below.

highImpressionShare

number

Upper bound of impression share. See encoding table below.

rank

integer

App’s impression share rank for this search term and country. 1 = highest share.

searchPopularity1to5

integer

Relative search volume on a 1–5 scale. 5 = most popular.

Impression Share Encoding

The lowImpressionShare and highImpressionShare fields use a tiered encoding. They are not always a range:

Impression Share

lowImpressionShare

highImpressionShare

0%

0

0

1% – 90%

x (for example, 0.23)

x (same value)

91% – 100%

0.91

1

For 1–90%, both fields carry the same single-digit value. The 91–100% bucket retains a range because accuracy of the estimated metric declines near full market saturation, and reporting a precise value there would overstate confidence.

Parsing tip: lowImpressionShare == highImpressionShare and value < 0.91 → precise single-digit percentage. highImpressionShare == 1 → app has >90% impression share.

The pagination object included in the response reports the following.

Field

Type

Description

totalCount

integer

Total number of rows matching the query

offset

integer

Current page offset

pageSize

integer

Number of rows returned in this response

See Also