Render paywall designed by remote config in Unity 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 paywall đó. Vì Remote Config cho phép linh hoạt theo nhu cầu của bạn, bạn hoàn toàn kiểm soát nội dung hiển thị cũng như giao diện của paywall. Adapty cung cấp một phương thức để lấy Remote Config, giúp bạn chủ động trình bày paywall tùy chỉnh của mình.

Lấy remote config của flow và hiển thị

Trong v4, một flow chứa một mục AdaptyRemoteConfig cho mỗi ngôn ngữ được cấu hình trong danh sách RemoteConfigs. Chọn ngôn ngữ 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.

using System.Linq;
using AdaptySDK;

Adapty.GetFlow("YOUR_PLACEMENT_ID", (flow, error) => {
    if (error != null) {
        // handle the error
        return;
    }

    var config = flow.RemoteConfigs.FirstOrDefault(c => c.Locale == "en")
        ?? flow.RemoteConfigs.FirstOrDefault();
    var headerText = config?.Dictionary?["header_text"] as string;

    // Or access raw JSON data
    var jsonData = config?.Data;
});

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à kết hợp chúng 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 xoay 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 mọi thiết bị.

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 funnel và A/B test.

Sau khi hoàn tất việc hiển thị paywall, 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 suất của các flow và paywall. Chúng tôi tự động thu thập dữ liệu về các giao dịch mua, nhưng việc ghi lại lượt xem cần có sự tham gia của bạn — vì chỉ bạn mới biết khi nào khách hàng nhìn thấy một flow.

Để ghi lại 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 sẽ tự động theo dõi lượt xem trong những trường hợp đó.

Adapty.LogShowFlow(flow, (error) => {
    // handle the error
});

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` lấy được qua `Adapty.GetFlow`.

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 kiểm soát những gì được đưa vào và giao diện paywall sẽ trông như thế nào. 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 cấu hình 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à lấy các giá trị cần thiết.

Adapty.GetPaywall("YOUR_PLACEMENT_ID", (paywall, error) => {
    if (error != null) {
        // handle the error
        return;
    }
    
    // Access remote config dictionary
    var dictionary = paywall.RemoteConfig?.Dictionary;
    var headerText = dictionary?["header_text"] as string;
    
    // Or access raw JSON data
    var jsonData = paywall.RemoteConfig?.Data;
});

Tại thời điểm này, sau khi đã nhận được tất cả các giá trị cần thiết, bạn hãy render và lắp ráp chúng thành một trang hiển thị hấp dẫn. Đả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 xoay của các thiết bị di động khác nhau, mang lại trải nghiệm mượt mà và thân thiện với người dùng.

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 funnel và A/B test.

Sau khi hoàn tất việc hiển thị paywall, 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ừ 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.

Chúng tôi khuyến nghị tạo một paywall dự phòng. Paywall 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 đó.

Ghi lạ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 hàng, việc ghi lại lượt xem paywall cần có sự tham gia của bạn vì chỉ bạn mới biết khi nào người dùng nhìn thấy paywall.

Để ghi lại sự kiện xem paywall, chỉ cần gọi .LogShowPaywall(paywall) — sự kiện này sẽ được phản ánh trong số liệu 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ị paywall được tạo trong Paywall Builder.

Adapty.LogShowPaywall(paywall, (error) => {
    // handle the error
});

Tham số yêu cầu:

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