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

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

Этот гайд предназначен для разработчиков, которые реализуют кастомные пейволы. Если вы хотите подключить покупки самым простым способом, используйте Adapty Flow Builder. С Flow Builder вы создаёте флоу в визуальном редакторе без кода, Adapty берёт на себя всю логику покупок, а тестировать разные дизайны можно без повторной публикации приложения.

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

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

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

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

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

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

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

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

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

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

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


fun loadPaywall() {
    Adapty.getFlow("YOUR_PLACEMENT_ID") { result ->
        when (result) {
            is AdaptyResult.Success -> {
                val flow = result.value
                Adapty.getPaywallProducts(flow) { productResult ->
                    when (productResult) {
                        is AdaptyResult.Success -> {
                            val products = productResult.value
                            // Use products to build your custom paywall UI
                        }
                        is AdaptyResult.Error -> {
                            val error = productResult.error
                            // Handle the error
                        }
                    }
                }
            }
            is AdaptyResult.Error -> {
                val error = result.error
                // Handle the error
            }
        }
    }
}



public void loadPaywall() {
    Adapty.getFlow("YOUR_PLACEMENT_ID", result -> {
        if (result instanceof AdaptyResult.Success) {
            AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) result).getValue();
            
            Adapty.getPaywallProducts(flow, productResult -> {
                if (productResult instanceof AdaptyResult.Success) {
                    List<AdaptyPaywallProduct> products = ((AdaptyResult.Success<List<AdaptyPaywallProduct>>) productResult).getValue();
                    // Use products to build your custom paywall UI
                } else if (productResult instanceof AdaptyResult.Error) {
                    AdaptyError error = ((AdaptyResult.Error) productResult).getError();
                    // Handle the error
                }
            });
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Handle the error
        }
    });
}

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

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


fun purchaseProduct(activity: Activity, product: AdaptyPaywallProduct) {
    Adapty.makePurchase(activity, product) { result ->
        when (result) {
            is AdaptyResult.Success -> {
                when (val purchaseResult = result.value) {
                    is AdaptyPurchaseResult.Success -> {
                        val profile = purchaseResult.profile
                        // Purchase successful, profile updated
                    }
                    is AdaptyPurchaseResult.UserCanceled -> {
                        // User canceled the purchase
                    }
                    is AdaptyPurchaseResult.Pending -> {
                        // Purchase is pending (e.g., user will pay offline with cash)
                    }
                }
            }
            is AdaptyResult.Error -> {
                val error = result.error
                // Handle the error
            }
        }
    }
}


public void purchaseProduct(Activity activity, AdaptyPaywallProduct product) {
    Adapty.makePurchase(activity, product, null, result -> {
        if (result instanceof AdaptyResult.Success) {
            AdaptyPurchaseResult purchaseResult = ((AdaptyResult.Success<AdaptyPurchaseResult>) result).getValue();
            
            if (purchaseResult instanceof AdaptyPurchaseResult.Success) {
                AdaptyProfile profile = ((AdaptyPurchaseResult.Success) purchaseResult).getProfile();
                // Покупка успешна, профиль обновлён
            } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
                // Пользователь отменил покупку
            } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
                // Покупка ожидает обработки (например, пользователь оплатит наличными офлайн)
            }
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Обработать ошибку
        }
    });
}

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

Google Play и другие сторы требуют, чтобы все приложения с подписками предоставляли пользователям возможность восстановить покупки.

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


fun restorePurchases() {
    Adapty.restorePurchases { result ->
        when (result) {
            is AdaptyResult.Success -> {
                val profile = result.value
                // Restore successful, profile updated
            }
            is AdaptyResult.Error -> {
                val error = result.error
                // Handle the error
            }
        }
    }
}


public void restorePurchases() {
    Adapty.restorePurchases(result -> {
        if (result instanceof AdaptyResult.Success) {
            AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
            // Restore successful, profile updated
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Handle the error
        }
    });
}

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

Есть вопросы или возникли проблемы? Загляните на наш форум поддержки, где можно найти ответы на распространённые вопросы или задать свой. Наша команда и сообщество всегда готовы помочь!

Ваш пейвол готов к отображению в приложении. Протестируйте покупки в Google Play Store, чтобы убедиться, что тестовая покупка с пейвола проходит успешно. Чтобы увидеть, как это работает в готовом к продакшену приложении, изучите ProductListFragment.kt в нашем примере приложения — там показана обработка покупок с полноценной обработкой ошибок, обратной связью с интерфейсом и управлением подписками. Затем проверьте, завершил ли пользователь покупку, чтобы определить, показывать ли пейвол или предоставлять доступ к платным функциям.