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

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

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

Настройте продукты

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

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

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

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

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

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

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

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

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

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

func loadPaywall() async {
    do {
        let paywall = try await Adapty.getPaywall("YOUR_PLACEMENT_ID")
        let products = try await Adapty.getPaywallProducts(paywall: paywall)
        
        // Use products to build your custom paywall UI
    } catch {
        // Handle the error
    }
}

func loadPaywall() {
    Adapty.getPaywall("YOUR_PLACEMENT_ID") { result in
        switch result {
        case let .success(paywall):
            Adapty.getPaywallProducts(paywall: paywall) { 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:
            // User canceled the purchase
            break
        case .pending:
            // Purchase is pending (e.g., awaiting parental approval)
            break
        case let .success(profile, transaction):
            // Purchase successful, profile updated
            break
        }
    } catch {
        // Handle the error
    }
}

func purchaseProduct(_ product: AdaptyPaywallProduct) {
    Adapty.makePurchase(product: product) { result in
        switch result {
        case let .success(purchaseResult):
            switch purchaseResult {
            case .userCancelled:
                // User canceled the purchase
                break
            case .pending:
                // Purchase is pending (e.g., awaiting parental approval)
                break
            case let .success(profile, transaction):
                // Purchase successful, profile updated
                break
            }
        case let .failure(error):
            // Handle the 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):
            // Restore successful, profile updated
        case let .failure(error):
            // Handle the error
        }
    }
}

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

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

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