---
title: CustomReportResponse
framework: Apple Ads
role: symbol
role_heading: Object
platforms: [search ads 4.7+]
path: apple_ads/customreportresponse
---

# CustomReportResponse

A container for Impression Share report metrics.

## Declaration

```data
object CustomReportResponse
```

## Properties

creationTime: The timestamp for the creation of the report in the format of YYYY-MM-DD’T’HH:mm:ss.SSS. dimensions: downloadUri: The report download link.  The state of the report needs to be COMPLETED for a valid URL to return when calling Get a Single Impression Share Report or Get All Impression Share Reports. A response of null means the report generation is still in progress. URLs expire 90 seconds after creation. Reports remain active for 2 days. endTime: The end time of the report. The format is YYYY-MM-DD, such as 2024-06-30. granularity: The report data organized by day or week. id: The report id is a unique identifier per report. metrics: Impression Share is a daily aggregation with a range in deciles, such as 11–20% and 21–30%. App impressions for search terms correlate by country or region and organization against the total requests for country- or region-search term combinations. Search terms need to have more than 10 impressions per day for inclusion in a daily  Impression Share report. modificationTime: The most recent timestamp of report modifications in the format of YYYY-MM-DD’T’HH:mm:ss.SSS. name: A free-text field. The maximum length is 50 characters. selector: Selector is an optional parameter to filter API results using the CountryOrRegion and adamId fields. For CountryOrRegion, use alpha-2 country code values. The IN operator is available to use with Impression Share reports. See SovCondition for selector descriptions and see Selector for structural guidance with selectors. startTime: The start time of the report. The format is YYYY-MM-DD, such as 2024-06-01. state: The state of the report. A value of COMPLETED has a report link in the downloadUri field.

## Discussion

Discussion See also Impression Share Report,  Get a Single Impression Share Report, Get All Impression Share Reports, and CustomReportRequest.

## Topics

### Objects

- [CustomReportResponse.Selector](apple_ads/customreportresponse/selector-data.dictionary.md)

## See Also

### Impression Share Report Request and Response Objects

- [CustomReportRequest](apple_ads/customreportrequest.md)
- [CustomReportResponseBody](apple_ads/customreportresponsebody.md)
- [SovCondition](apple_ads/sovcondition.md)