在 Android SDK 的自定义付费墙中启用购买功能

本指南介绍如何将 Adapty 集成到自定义付费墙中。你可以完全掌控付费墙的实现方式，同时由 Adapty SDK 负责获取产品、处理新购买以及恢复历史购买记录。

本指南适用于需要自行实现自定义付费墙的开发者。 如果你希望以最简便的方式开启购买功能，请使用 Adapty Flow Builder。使用 Flow Builder，你可以在无代码可视化编辑器中创建流程，Adapty 自动处理所有购买逻辑，并且无需重新发布应用即可测试不同的设计方案。

开始之前

设置产品

要启用应用内购买，你需要了解三个关键概念：

产品 – 用户可以购买的任何内容（订阅、消耗型商品、永久授权）
付费墙 – 定义向用户展示哪些产品的配置。在 Adapty 中，付费墙是获取产品的唯一方式，但这种设计让你无需修改应用代码就能调整产品、价格和优惠。
版位 – 应用中展示付费墙的位置和时机（如 main、onboarding、settings）。你在看板中为版位配置付费墙，然后在代码里通过版位 ID 请求对应的付费墙。这样就能轻松运行 A/B 测试，并向不同用户展示不同的付费墙。即使你使用自定义付费墙，也需要了解这些概念。简单来说，它们就是你在应用中管理所售产品的方式。

要实现自定义付费墙，你需要创建一个付费墙并将其添加到一个版位。这样才能获取你的产品。如果想了解需要在看板中完成哪些操作，请参考这里的快速入门指南。

管理用户

您可以选择在您的后端使用或不使用身份验证。

但是，Adapty SDK 对匿名用户和已识别用户的处理方式不同。请阅读用户识别快速入门指南以了解具体细节，确保您正确处理用户信息。

第一步：获取产品

要为自定义付费墙获取产品，你需要：

通过将版位 ID 传递给 getFlow 方法来获取 flow 对象。
使用 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();
            // 处理错误
        }
    });
}

第三步：恢复购买

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，其中演示了包含完善错误处理、UI 反馈和订阅管理的购买处理逻辑。接下来，检查用户是否已完成购买，以判断是否需要展示付费墙或开放付费功能。