Render paywall designed by remote config in Android SDK

Nếu bạn đã tùy chỉnh paywall bằng Remote Config, bạn cần tự triển khai phần hiển thị trong code của ứng dụng để người dùng có thể thấy nó. Vì Remote Config mang lại sự linh hoạt theo nhu cầu của bạn, bạn hoàn toàn quyết định nội dung hiển thị và giao diện của paywall. Adapty cung cấp phương thức để lấy cấu hình Remote Config, giúp bạn chủ động xây dựng paywall tùy chỉnh của mình.

Lấy Remote Config của flow và hiển thị nó

Trong v4, một flow chứa một mục AdaptyRemoteConfig cho mỗi locale đã cấu hình trong mảng remoteConfigs. Chọn locale phù hợp với tùy chọn của người dùng, sau đó đọc các giá trị bạn cần.

Adapty.getFlow("YOUR_PLACEMENT_ID") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val flow = result.value
            val config = flow.remoteConfigs.firstOrNull { it.locale == "en" }
                ?: flow.remoteConfigs.firstOrNull()
            val headerText = config?.dataMap?.get("header_text") as? String
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getFlow("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) result).getValue();

        AdaptyRemoteConfig config = null;
        for (AdaptyRemoteConfig remoteConfig : flow.getRemoteConfigs()) {
            if ("en".equals(remoteConfig.getLocale())) {
                config = remoteConfig;
                break;
            }
        }
        if (config == null && !flow.getRemoteConfigs().isEmpty()) {
            config = flow.getRemoteConfigs().get(0);
        }

        if (config != null && config.getDataMap().get("header_text") instanceof String) {
            String headerText = (String) config.getDataMap().get("header_text");
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

Đến đây, sau khi đã nhận được tất cả các giá trị cần thiết, đã đến lúc render và ghép chúng lại thành một trang có giao diện hấp dẫn. Hãy đảm bảo thiết kế tương thích với nhiều kích thước màn hình và hướng hiển thị khác nhau trên điện thoại di động, mang lại trải nghiệm mượt mà và thân thiện với người dùng trên nhiều thiết bị.

Hãy nhớ ghi lại sự kiện xem paywall như mô tả bên dưới, để Adapty analytics có thể thu thập thông tin phục vụ cho funnel và A/B test.

Sau khi hiển thị paywall xong, hãy tiếp tục thiết lập flow mua hàng. Khi người dùng thực hiện mua hàng, chỉ cần gọi .makePurchase() với sản phẩm từ flow của bạn. Để biết thêm chi tiết về phương thức .makePurchase(), hãy đọc Thực hiện mua hàng.

Chúng tôi khuyến nghị tạo một paywall dự phòng. Paywall dự phòng này sẽ hiển thị cho người dùng khi không có kết nối internet hoặc không có cache, đảm bảo trải nghiệm mượt mà ngay cả trong những tình huống đó.

Theo dõi sự kiện xem paywall

Adapty giúp bạn đo lường hiệu quả của các flow và paywall. Dữ liệu mua hàng được thu thập tự động, nhưng việc ghi nhận lượt xem cần bạn thực hiện thủ công vì chỉ bạn mới biết khi nào người dùng nhìn thấy một flow.

Để ghi nhận sự kiện xem, chỉ cần gọi .logShowFlow(flow), và nó sẽ được phản ánh trong các chỉ số của bạn trong funnels và A/B test.

Không cần gọi .logShowFlow(flow) nếu bạn đang hiển thị các flow hoặc paywall được render bởi Flow Builder hoặc Paywall Builder. Adapty tự động theo dõi lượt xem trong những trường hợp đó.

Adapty.logShowFlow(flow)

Tham số yêu cầu:

Tham số	Bắt buộc	Mô tả
flow	bắt buộc	Một đối tượng `AdaptyFlow` nhận được qua `Adapty.getFlow`.

Nếu bạn đã tùy chỉnh paywall bằng Remote Config, bạn cần tự implement phần hiển thị trong code của ứng dụng để người dùng có thể thấy nó. Vì Remote Config mang lại sự linh hoạt theo nhu cầu của bạn, bạn toàn quyền quyết định nội dung hiển thị và giao diện của paywall. Chúng tôi cung cấp một phương thức để lấy cấu hình remote, giúp bạn chủ động hiển thị paywall tùy chỉnh đã được thiết lập qua Remote Config.

Lấy Remote Config của paywall và hiển thị nó

Để lấy Remote Config của một paywall, truy cập thuộc tính remoteConfig và trích xuất các giá trị cần thiết.

Adapty.getPaywall("YOUR_PLACEMENT_ID") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val paywall = result.value
            val headerText = paywall.remoteConfig?.dataMap?.get("header_text") as? String
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getPaywall("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
        
        AdaptyPaywall.RemoteConfig remoteConfig = paywall.getRemoteConfig();
        
        if (remoteConfig != null) {
            if (remoteConfig.getDataMap().get("header_text") instanceof String) {
                String headerText = (String) remoteConfig.getDataMap().get("header_text");
            }
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

Tại thời điểm này, sau khi đã nhận được tất cả các giá trị cần thiết, đã đến lúc render và tổng hợp chúng thành một trang trông đẹp mắt. Hãy đảm bảo rằng thiết kế phù hợp với nhiều màn hình điện thoại và hướng hiển thị khác nhau, mang lại trải nghiệm mượt mà và thân thiện với người dùng trên các thiết bị khác nhau.

Hãy đảm bảo ghi lại sự kiện xem paywall như mô tả bên dưới, để Adapty analytics có thể thu thập thông tin cho các funnel và A/B test.

Sau khi hiển thị paywall xong, hãy tiếp tục thiết lập luồng mua hàng. Khi người dùng thực hiện mua hàng, chỉ cần gọi .makePurchase() với sản phẩm từ paywall của bạn. Để biết thêm chi tiết về phương thức .makePurchase(), hãy đọc Thực hiện mua hàng.

Theo dõi sự kiện xem paywall

Adapty giúp bạn đo lường hiệu quả của các paywall. Trong khi chúng tôi tự động thu thập dữ liệu về các giao dịch mua, việc ghi lại lượt xem paywall cần có sự hỗ trợ từ phía bạn vì chỉ bạn mới biết khi nào khách hàng nhìn thấy một paywall.

Để ghi lại sự kiện xem paywall, chỉ cần gọi .logShowPaywall(paywall), và nó sẽ được phản ánh trong các chỉ số paywall của bạn trong funnel và A/B test.

Không cần gọi .logShowPaywall(paywall) nếu bạn đang hiển thị các paywall được tạo trong Paywall Builder.

Adapty.logShowPaywall(paywall)

Tham số yêu cầu:

Tham số	Bắt buộc	Mô tả
paywall	bắt buộc	Đối tượng `AdaptyPaywall`.