Skip to main content
Promoted in-app purchases appear on your app page and can be displayed in search results. App Store promoted purchases are enabled by default. If a user starts an in-app purchase from the App Store, the purchase flow begins when a user opens your app.
Kindly note that the scenario described below is related only to the iOS platform.

iOS

Set delegate

If you need additional logic, set QONPromoPurchasesDelegate.

Add the following function to handle promoted purchases

Flutter

Listen to the promo purchase stream

Qonversion.promoPurchasesStream emits AppStore productID whenever a promoted purchase flow is triggered. Listen to the stream to handle promoted purchases.

Complete the purchase

Call Qonversion.promoPurchase when you want to initialize the purchase (for example, immediately after the onboarding screens) and pass the AppStore productID as the parameter. Alternatively, call this method immediately on the app start.

React Native and Cordova

Listen to promo purchases events

Provide PromoPurchasesDelegate to get notified whenever a promoted purchase flow is triggered.

Complete the purchase

Call the promoPurchaseExecutor provided to the delegate right in the delegate method or later when you want to initialize the purchase (for example, immediately after the onboarding screens) and pass the AppStore productId as the parameter.

Unity

Handle events

Qonversion.PromoPurchasesReceived sends the event when a user initiates a promotional in-app purchase from the App Store. Declare a delegate to handle promo purchases. Promo purchases will proceed automatically if you are not using thePromoPurchasesReceived event.

Complete the purchase

Call startPromoPurchase when you want to initialize the purchase (for example, immediately after the onboarding screens).

App Store Privacy App Store Small Business Program