Управление сообщениями App Store в iOS SDK

App Store иногда должен показывать пользователям сообщения о подписке: запросить согласие на повышение цены, сообщить о проблемах с оплатой или представить win-back offer. По умолчанию StoreKit показывает эти сообщения самостоятельно, пока открыто приложение — даже поверх пейвола, онбординга или оформления заказа.

Чтобы выбирать момент показа самостоятельно, переключите Adapty SDK в режим ручной обработки сообщений. Тогда SDK добавляет каждое сообщение в список ожидающих, а приложение показывает этот список при вызове showStoreMessages.

Прежде чем начать

Вам понадобится:

• Adapty iOS SDK 4.2 или новее: более ранние версии не поддерживают API сообщений стора.
• iOS 16, Mac Catalyst 16 или visionOS 1 и новее на устройстве пользователя: StoreKit не доставляет сообщения приложениям на более ранних версиях. API сообщений стора недоступен на macOS.

Включение ручной обработки

Чтобы перехватывать сообщения App Store, установите значение storeMessagesHandling равным .manual при активации SDK:

let configurationBuilder = AdaptyConfiguration
    .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
    .with(storeMessagesHandling: .manual) // .auto is the default

SDK начинает перехватывать сообщения в момент активации и хранит их в памяти в течение текущей сессии приложения. При значении по умолчанию .auto SDK ничего не перехватывает, а getPendingStoreMessageTypes и showStoreMessages ничего не делают.

Получение типов ожидающих сообщений

Чтобы узнать, есть ли ожидающие сообщения, вызовите getPendingStoreMessageTypes. Метод возвращает типы ожидающих сообщений, не показывая и не удаляя их:

let pendingTypes = await Adapty.getPendingStoreMessageTypes()

if pendingTypes.contains(.billingIssue) {
    // For example, skip the upsell and show the billing message first
}

Каждое сообщение относится к одному из следующих типов:

Тип сообщения, который SDK не распознаёт, имеет значение storekit_<number>.

Показ ожидающих сообщений

Когда ваше приложение достигает точки, в которой системное окно не прервёт пользователя — например, после того как пользователь закрыл флоу или завершил онбординг — вызовите showStoreMessages:

struct HomeView: View {
    @Environment(\.displayStoreKitMessage) private var displayStoreKitMessage

    var body: some View {
        Text("Home")
            .task {
                do {
                    try await Adapty.showStoreMessages(using: displayStoreKitMessage)
                } catch {
                    // handle the error
                }
            }
    }
}

do {
    try await Adapty.showStoreMessages(in: view.window?.windowScene)
} catch {
    // handle the error
}

SDK показывает сообщения одно за другим. После того как StoreKit отображает сообщение, SDK удаляет его из списка ожидания. Если StoreKit не может показать сообщение, SDK записывает ошибку в лог Adapty, сохраняет сообщение для следующего вызова и продолжает обработку остальных сообщений.

Показывать только определённые типы сообщений

Чтобы показывать только часть ожидающих сообщений, передайте нужные типы в for. Остальные сообщения останутся в очереди:

try await Adapty.showStoreMessages(
    for: [.billingIssue, .priceIncreaseConsent],
    using: displayStoreKitMessage
)

Без for SDK показывает все ожидающие сообщения, включая типы, которые он не распознаёт.

Ошибки

showStoreMessages выбрасывает AdaptyError с одним из следующих кодов: