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

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

本指南面向正在实现自定义付费墙的开发者。 如果您想以最简便的方式启用购买功能，请使用 Adapty 付费墙编辑工具。借助付费墙编辑工具，您可以在无代码可视化编辑器中创建付费墙，Adapty 会自动处理所有购买逻辑，且无需重新发布应用即可测试不同设计。

开始之前

配置产品

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

产品 – 用户可以购买的任何内容（订阅、消耗型商品、永久授权）
付费墙 – 定义要展示哪些产品的配置。在 Adapty 中，付费墙是获取产品的唯一途径，但这种设计让您无需修改应用代码即可调整产品、价格和优惠。
版位 – 您在应用中展示付费墙的时机和位置（如 main、onboarding、settings）。您在看板中为版位配置付费墙，然后在代码中通过版位 ID 请求它们。这使得运行 A/B 测试和向不同用户展示不同付费墙变得轻而易举。

即使您使用自定义付费墙，也请务必理解这些概念。基本上，它们只是您管理应用内销售产品的方式。

要实现自定义付费墙，您需要创建一个付费墙并将其添加到版位中。此配置允许您获取产品。要了解在看板中需要执行哪些操作，请参阅此处的快速入门指南。

管理用户

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

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

步骤 1：获取产品

要获取自定义付费墙的产品，您需要：

将版位 ID 传递给 getPaywall 方法以获取 paywall 对象。
使用 getPaywallProducts 方法获取该付费墙的产品数组。

import com.adapty.Adapty
import com.adapty.models.AdaptyPaywall
import com.adapty.models.AdaptyPaywallProduct
import com.adapty.utils.AdaptyResult

fun loadPaywall() {
    Adapty.getPaywall("YOUR_PLACEMENT_ID") { result ->
        when (result) {
            is AdaptyResult.Success -> {
                val paywall = result.value
                Adapty.getPaywallProducts(paywall) { 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
            }
        }
    }
}

import com.adapty.Adapty;
import com.adapty.models.AdaptyPaywall;
import com.adapty.models.AdaptyPaywallProduct;
import com.adapty.utils.AdaptyError;
import com.adapty.utils.AdaptyResult;

import java.util.List;

public void loadPaywall() {
    Adapty.getPaywall("YOUR_PLACEMENT_ID", result -> {
        if (result instanceof AdaptyResult.Success) {
            AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
            
            Adapty.getPaywallProducts(paywall, 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 方法。这将处理购买流程并返回更新后的用户画像。

import android.app.Activity
import com.adapty.Adapty
import com.adapty.models.AdaptyPaywallProduct
import com.adapty.models.AdaptyPurchaseResult
import com.adapty.utils.AdaptyResult

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
            }
        }
    }
}

import android.app.Activity;
import com.adapty.Adapty;
import com.adapty.models.AdaptyPaywallProduct;
import com.adapty.models.AdaptyProfile;
import com.adapty.models.AdaptyPurchaseResult;
import com.adapty.utils.AdaptyError;
import com.adapty.utils.AdaptyResult;

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();
                // Purchase successful, profile updated
            } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
                // User canceled the purchase
            } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
                // Purchase is pending (e.g., user will pay offline with cash)
            }
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Handle the error
        }
    });
}

步骤 3：恢复购买

Google Play 及其他应用商店要求所有包含订阅功能的应用提供用户恢复购买的途径。

当用户点击恢复按钮时，调用 restorePurchases 方法。这将把他们的购买历史与 Adapty 同步，并返回更新后的用户画像。

import com.adapty.Adapty
import com.adapty.utils.AdaptyResult

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
            }
        }
    }
}

import com.adapty.Adapty;
import com.adapty.models.AdaptyProfile;
import com.adapty.utils.AdaptyError;
import com.adapty.utils.AdaptyResult;

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 反馈和订阅管理的购买处理。

接下来，检查用户是否已完成购买，以确定是否显示付费墙或授予对付费功能的访问权限。