Now Available

Promoting Your In-App Purchases

With iOS 11, users can browse in-app purchases directly on the App Store and start a purchase even before downloading your app. Promoted in-app purchases appear on your product page, can display in search results, and may be featured on the Today, Games, and Apps tabs. Learn how to effectively increase discoverability for content previously only found inside your app.

Overview

You can choose to promote up to 20 in-app purchases at a time on your product page, with additional in-app purchases approved and ready to promote. This gives you the flexibility to change the in-app purchases that appear on your product page at any time based on your business needs — for example, if you’re planning to launch a limited-time price promotion or offer exclusive content.

Promoting in-app purchases can also encourage downloads of your app. When a user doesn’t have your app installed but wants to buy a promoted in-app purchase, they'll receive a prompt to download the app first. Once the app is downloaded, the transaction will continue in the app.

To promote in-app purchases on your product page, your app needs to support a delegate method in SKPaymentTransactionObserver.

Use iTunes Connect to choose in-app purchases to promote and enter the related metadata. All in-app purchases and metadata are reviewed. You can submit up to 20 in-app purchases for review at a time. Learn more

Ensuring a Seamless Purchase Flow

When a user starts an in-app purchase on the App Store, they are taken into your app to continue the transaction. Consider presenting the payment sheet as soon as they are in the app to make the process of completing their purchase as easy as possible. Avoid unnecessary interstitials and messaging, as each extra step you require may decrease the likelihood that the user will complete the purchase.

Customizing Promoted In-App Purchases

You can customize which promoted in-app purchases a user sees on a specific device using the SKProductStorePromotionController API. For example, you can hide an item that a user already has on that device, or show the most relevant levels in a game based on their gameplay. Learn more by watching What's New in StoreKit.

Creating Effective Metadata

Promotional image. Each promoted in-app purchase requires a unique promotional image that best represents the in-app purchase. This image appears on your App Store product page; on the Today, Games, and Apps tabs if your content is featured; and can appear in search results.

Promotional images should not be screenshots, and should not be confused with your app icon.

We add a framing system to the image you upload to help convey that the in-app purchase is an addition to the app experience. When an in-app purchase appears on the App Store in places other than your product page — for example, in search results — your app icon is included in the lower left corner for further context. Ensure that your design isn’t obscured by the frame, and avoid putting important details in the lower left corner. We also recommend that you don’t overlay text on the image.

The file you upload will be a PNG or high-quality JPEG at 1024 x 1024 pixels. While this image is large for scaling purposes, your promotional image is usually seen at small sizes. Make sure that this image gracefully scales down to smaller sizes. For templates to help with the design of your promotional images, see Apple UI Design Resources.

Display name. For each in-app purchase you promote, create a display name that will be easily understood by your users. Avoid generic names like “100 gems” and tie the name to your app in some way. For auto-renewable subscriptions, include the duration of the in-app purchase. In-app purchase display names can be up to 30 characters long.

Description. Create descriptions for your in-app purchases that make it easy for users to distinguish the benefits of each offering. Descriptions can be up to 45 characters long.

To learn more about specifications for promotional images, display names, and descriptions, see iTunes Connect Developer Help.

In-app purchase metadata displayed on a product page.

In-app purchase metadata displayed in search results, Today, Games, and Apps tabs.