<!--
{
  "documentType" : "article",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/Apple_Ads/impression-share-reports",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Impression Share Reports"
}
-->

# Impression Share Reports

Obtain metrics with impression share insights.

## Discussion

Impression share reports provide insights into opportunities to scale keywords and optimize maximum CPT bids and budgets for your search results campaigns. The reports also show you how your app ranks in terms of impression share compared to other apps in the same countries and regions.

Use the [`Impression Share Report`](/documentation/apple_ads/Impression-Share-Report) endpoint to obtain a report `ID` to use with [`Get a Single Impression Share Report`](/documentation/apple_ads/Get-a-Single-Impression-Share-Report), or use [`Get All Impression Share Reports`](/documentation/apple_ads/Get-All-Impression-Share-Reports) without a report `ID`.

Use [`CustomReportRequest`](/documentation/apple_ads/CustomReportRequest) for formatting guidance on selector structure. For metrics descriptions, see [`CustomReportResponse`](/documentation/apple_ads/CustomReportResponse).

## Topics

### Impression Share Report Endpoints

[`Impression Share Report`](/documentation/apple_ads/Impression-Share-Report)

Obtain a report ID.

[`Get a Single Impression Share Report`](/documentation/apple_ads/Get-a-Single-Impression-Share-Report)

Fetches a single Impression Share report containing metrics and metadata.

[`Get All Impression Share Reports`](/documentation/apple_ads/Get-All-Impression-Share-Reports)

Fetches all Impression Share reports containing metrics and metadata.

### Impression Share Report Request and Response Objects

[`CustomReportRequest`](/documentation/apple_ads/CustomReportRequest)

The Impression Share report request body.

[`CustomReportResponse`](/documentation/apple_ads/CustomReportResponse)

A container for Impression Share report metrics.

[`CustomReportResponseBody`](/documentation/apple_ads/CustomReportResponseBody)

A container for the Impression Share report response body.

[`SovCondition`](/documentation/apple_ads/SovCondition)

The list of condition objects that allow users to filter a list of records.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)