<!--
{
  "documentType" : "article",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/Apple_Ads/custom-product-pages",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Custom Product Pages"
}
-->

# Custom Product Pages

View Custom Product Page details.

## Discussion

In iOS 15 and later, you can use [custom product pages](https://developer.apple.com/app-store/product-page/) that you build in [App Store Connect](https://appstoreconnect.apple.com) to create ad variations in the Apple Search Ads Campaign Management API to promote your apps.

To create a custom product page ad, use the following workflow:

![A diagram showing the five-step workflow for creating a custom product page ad.](images/com.apple.appleads/media-3921834@2x.png)

1. Use [`Get Product Pages`](/documentation/apple_ads/Get-Product-Pages) to fetch your `productPageId`.
2. Use [`Get Product Page Locales`](/documentation/apple_ads/Get-Product-Page-Locales) to fetch locale metadata and supported languages. Verify that your custom product page locale and asset data match the language and device types in your campaign [`AdGroup`](/documentation/apple_ads/AdGroup).
3. Use [`Create a Creative`](/documentation/apple_ads/Create-a-Creative) with your `productPageId` to obtain a `creativeId`.
4. Use [`Create an Ad`](/documentation/apple_ads/Create-an-Ad) with a `creativeId` to assign a custom product page to an [`AdGroup`](/documentation/apple_ads/AdGroup). Each ad group can have one custom product page. For information about how to update a custom product page ad group assignment, see [`Update an Ad`](/documentation/apple_ads/Update-an-Ad).
5. Use [`Get Ad-Level Reports`](/documentation/apple_ads/Get-Ad-Level-Reports) to track the performance of ads in your campaigns. These details help you optimize your Apple Search Ads campaigns to deliver a contextualized customer experience.

> Note:
> If you’ve been using Creative Sets with the API, see section 4.1 in  <doc://com.apple.appleads/documentation/Apple_Ads/apple-search-ads-campaign-management-api-4> for Creative Sets deprecation details.

## Topics

### Product Page Endpoints

[`Get Product Pages`](/documentation/apple_ads/Get-Product-Pages)

Fetches metadata of all your custom product pages.

[`Get Product Pages by Identifier`](/documentation/apple_ads/Get-Product-Pages-by-Identifier)

Fetches metadata for a specific product page.

[`Get Product Page Locales`](/documentation/apple_ads/Get-Product-Page-Locales)

Fetches product page locales by identifier.

[`Get Supported Countries or Regions`](/documentation/apple_ads/Get-Supported-Countries-or-Regions)

Fetches supported languages and language codes.

[`Get App Preview Device Sizes`](/documentation/apple_ads/Get-App-Preview-Device-Sizes)

Fetches supported app preview device-size mappings.

### Product Page Request and Response Objects

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

The supported languages and language codes.

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

The supported locales of a product page.

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

A container for product page responses.

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

The app preview or screenshot asset detail.

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

The product page locale metadata on App Store Connect.

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

The product page metadata.

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

The product page asset metadata.

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

A container for product page responses.

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

A container for product page responses.

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

A container for product page responses.

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

A container for product page responses.

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

The ad creative rejection reason based on a product page.



---

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)