Kích hoạt mua hàng trong paywall tùy chỉnh của bạn trên Android SDK

Hướng dẫn này mô tả cách tích hợp Adapty vào các paywall tùy chỉnh của bạn. Bạn vẫn toàn quyền kiểm soát việc triển khai paywall, trong khi Adapty SDK lo việc lấy sản phẩm, xử lý các giao dịch mua mới và khôi phục các giao dịch trước đó.

Hướng dẫn này dành cho các developer đang triển khai paywall tùy chỉnh. Nếu bạn muốn cách đơn giản nhất để bật tính năng mua hàng, hãy sử dụng Adapty Flow Builder. Với Flow Builder, bạn tạo flow trong trình chỉnh sửa trực quan không cần code, Adapty xử lý toàn bộ logic mua hàng tự động, và bạn có thể thử nghiệm các thiết kế khác nhau mà không cần phát hành lại ứng dụng.

Trước khi bắt đầu

Thiết lập sản phẩm

Để kích hoạt in-app purchase, bạn cần nắm rõ ba khái niệm quan trọng:

Sản phẩm – bất kỳ thứ gì người dùng có thể mua (gói đăng ký, consumable, quyền truy cập trọn đời)
Paywalls – cấu hình xác định sản phẩm nào sẽ được hiển thị. Trong Adapty, paywall là cách duy nhất để lấy sản phẩm, nhưng thiết kế này cho phép bạn thay đổi sản phẩm, giá cả và ưu đãi mà không cần chỉnh sửa code.
Placements – vị trí và thời điểm hiển thị paywall trong ứng dụng (ví dụ: main, onboarding, settings). Bạn thiết lập paywall cho các placement trên dashboard, sau đó gọi chúng theo placement ID trong code. Điều này giúp bạn dễ dàng chạy A/B test và hiển thị các paywall khác nhau cho từng nhóm người dùng. Hãy đảm bảo bạn hiểu các khái niệm này ngay cả khi bạn dùng paywall tự tạo. Về cơ bản, đây chỉ là cách bạn quản lý các sản phẩm bán trong ứng dụng.

Để triển khai paywall tự tạo, bạn cần tạo một paywall và thêm nó vào một placement. Thiết lập này cho phép bạn lấy danh sách sản phẩm. Để hiểu những gì cần làm trong dashboard, hãy xem hướng dẫn quickstart tại đây.

Quản lý người dùng

Bạn có thể làm việc có hoặc không có xác thực backend ở phía mình.

Tuy nhiên, Adapty SDK xử lý người dùng ẩn danh và người dùng đã xác định theo các cách khác nhau. Đọc hướng dẫn khởi đầu nhanh về nhận dạng người dùng để hiểu rõ sự khác biệt và đảm bảo bạn đang làm việc với người dùng đúng cách.

Bước 1. Lấy danh sách sản phẩm

Để lấy danh sách sản phẩm cho paywall tùy chỉnh của bạn, bạn cần:

Lấy đối tượng flow bằng cách truyền ID placement vào phương thức getFlow.
Lấy mảng sản phẩm cho flow này bằng phương thức 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
        }
    });
}

Bước 2. Xử lý giao dịch mua

Khi người dùng nhấn vào một sản phẩm trong paywall tùy chỉnh của bạn, hãy gọi phương thức makePurchase với sản phẩm đã chọn. Phương thức này sẽ xử lý luồng mua hàng và trả về hồ sơ người dùng đã được cập nhật.


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();
                // Mua hàng thành công, hồ sơ người dùng đã được cập nhật
            } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
                // Người dùng đã hủy giao dịch
            } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
                // Giao dịch đang chờ xử lý (ví dụ: người dùng sẽ thanh toán offline bằng tiền mặt)
            }
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Xử lý lỗi
        }
    });
}

Bước 3. Khôi phục giao dịch mua

Google Play và các cửa hàng ứng dụng khác yêu cầu tất cả ứng dụng có gói đăng ký phải cung cấp cách để người dùng khôi phục giao dịch mua của họ.

Gọi phương thức restorePurchases khi người dùng nhấn nút khôi phục. Thao tác này sẽ đồng bộ lịch sử giao dịch mua của họ với Adapty và trả về hồ sơ người dùng đã được cập nhật.


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

Các bước tiếp theo

Bạn có câu hỏi hoặc gặp sự cố? Hãy xem diễn đàn hỗ trợ của chúng tôi — nơi bạn có thể tìm câu trả lời cho các câu hỏi thường gặp hoặc đặt câu hỏi của riêng mình. Đội ngũ và cộng đồng của chúng tôi luôn sẵn sàng giúp đỡ!

Paywall của bạn đã sẵn sàng để hiển thị trong ứng dụng. Kiểm tra giao dịch mua hàng trên Google Play Store để đảm bảo bạn có thể hoàn tất một giao dịch mua thử từ paywall. Để xem cách hoạt động trong một triển khai thực tế, hãy xem ProductListFragment.kt trong ứng dụng mẫu của chúng tôi, nơi minh họa cách xử lý giao dịch mua hàng với xử lý lỗi phù hợp, phản hồi giao diện người dùng và quản lý gói đăng ký. Tiếp theo, kiểm tra xem người dùng đã hoàn tất giao dịch mua chưa để quyết định có nên hiển thị paywall hay cấp quyền truy cập vào các tính năng trả phí.