Включение покупок в кастомном пейволе в iOS SDK

В этом гайде описана интеграция Adapty в кастомные пейволы. Вы сохраняете полный контроль над реализацией пейвола, а SDK Adapty берёт на себя загрузку продуктов, обработку новых покупок и восстановление предыдущих.

Перед началом работы

Настройка продуктов

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

• Продукты – всё, что пользователи могут купить (подписки, расходуемые покупки, пожизненный доступ)
• Пейволы – конфигурации, определяющие, какие продукты предлагать. В Adapty пейволы — единственный способ получить продукты, но такой подход позволяет менять продукты, цены и офферы без изменений в коде приложения.
• Плейсменты – где и когда показывать пейволы в приложении (например, main, onboarding, settings). Вы настраиваете пейволы для плейсментов в дашборде, а затем запрашиваете их по ID плейсмента в коде. Это упрощает проведение A/B-тестов и показ разных пейволов разным пользователям. Убедитесь, что вы разобрались с этими концепциями, даже если используете собственный пейвол. По сути, это просто способ управлять продуктами, которые вы продаёте в приложении.

Чтобы реализовать собственный пейвол, нужно создать пейвол и добавить его в плейсмент. Это позволит вам получать свои продукты. Чтобы понять, что нужно сделать в дашборде, следуйте quickstart-гайду здесь.

Управление пользователями

Вы можете работать как с backend-аутентификацией на вашей стороне, так и без неё.

Однако Adapty SDK по-разному обрабатывает анонимных и идентифицированных пользователей. Прочитайте гайд по идентификации, чтобы разобраться в особенностях и правильно работать с пользователями.

Шаг 1. Получите продукты

Чтобы получить продукты для вашего кастомного пейвола, нужно:

1. Получить объект flow, передав ID плейсмента в метод getFlow.
2. Получить массив продуктов для этого флоу с помощью метода getPaywallProducts.

func loadPaywall() async {
    do {
        let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")
        let products = try await Adapty.getPaywallProducts(flow: flow)

        // Use products to build your custom paywall UI
    } catch {
        // Handle the error
    }
}

func loadPaywall() {
    Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID") { result in
        switch result {
        case let .success(flow):
            Adapty.getPaywallProducts(flow: flow) { result in
                switch result {
                case let .success(products):
                    // Use products to build your custom paywall UI
                case let .failure(error):
                    // Handle the error
                }
            }
        case let .failure(error):
            // Handle the error
        }
    }
}

Шаг 2. Обработка покупок

Когда пользователь нажимает на продукт в вашем кастомном пейволе, вызовите метод makePurchase с выбранным продуктом. Это запустит процесс покупки и вернёт обновлённый профиль.

func purchaseProduct(_ product: AdaptyPaywallProduct) async {
    do {
        let purchaseResult = try await Adapty.makePurchase(product: product)
        
        switch purchaseResult {
        case .userCancelled:
            // Пользователь отменил покупку
            break
        case .pending:
            // Покупка ожидает подтверждения (например, требуется разрешение родителей)
            break
        case let .success(profile, transaction):
            // Покупка успешна, профиль обновлён
            break
        }
    } catch {
        // Обработка ошибки
    }
}

func purchaseProduct(_ product: AdaptyPaywallProduct) {
    Adapty.makePurchase(product: product) { result in
        switch result {
        case let .success(purchaseResult):
            switch purchaseResult {
            case .userCancelled:
                // Пользователь отменил покупку
                break
            case .pending:
                // Покупка ожидает подтверждения (например, ожидает родительского одобрения)
                break
            case let .success(profile, transaction):
                // Покупка успешна, профиль обновлён
                break
            }
        case let .failure(error):
            // Обработка ошибки
        }
    }
}

Шаг 3. Восстановление покупок

Apple требует, чтобы все приложения с подписками предоставляли пользователям возможность восстановить свои покупки. Хотя покупки восстанавливаются автоматически при входе в систему через Apple ID, вы всё равно обязаны добавить кнопку восстановления в своё приложение.

Вызывайте метод restorePurchases, когда пользователь нажимает на кнопку восстановления. Это синхронизирует историю покупок с Adapty и вернёт обновлённый профиль.

func restorePurchases() async {
    do {
        let profile = try await Adapty.restorePurchases()
        // Restore successful, profile updated
    } catch {
        // Handle the error
    }
}

func restorePurchases() {
    Adapty.restorePurchases { result in
        switch result {
        case let .success(profile):
            // Восстановление прошло успешно, профиль обновлён
        case let .failure(error):
            // Обработка ошибки
        }
    }
}

Следующие шаги

Ваш пейвол готов к отображению в приложении. Протестируйте покупки в режиме песочницы, чтобы убедиться, что вы можете выполнить тестовую покупку через пейвол.

Затем проверьте, совершили ли пользователи покупку, чтобы решить, показывать пейвол или предоставить доступ к платным функциям.