Hiển thị paywall được thiết kế bằng remote config trong iOS 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 nhìn 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 bao gồm những gì và giao diện paywall trông như thế nào. Adapty cung cấp phương thức để lấy cấu hình remote, giúp bạn tự do trình bày paywall tùy chỉnh của mình.

Đừng quên kiểm tra xem người dùng có đủ điều kiện nhận ưu đãi giới thiệu trên iOS không và điều chỉnh giao diện paywall để xử lý trường hợp họ đủ điều kiện.

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

do {
    let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")
    let config = flow.remoteConfigs.first(where: { $0.locale == "en" })
        ?? flow.remoteConfigs.first
    let headerText = config?.dictionary?["header_text"] as? String
} catch {
    // handle the error
}

Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID") { result in
    let flow = try? result.get()
    let config = flow?.remoteConfigs.first(where: { $0.locale == "en" })
        ?? flow?.remoteConfigs.first
    let headerText = config?.dictionary?["header_text"] as? String
}

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 thành một trang 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, mang lại trải nghiệm mượt mà và thân thiện trên mọi thiết bị.

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

Sau khi hoàn tất việc hiển thị paywall, 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 paywall dự phòng (fallback paywall). 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 paywall. Trong khi dữ liệu mua hàng được thu thập tự động, việc ghi lại lượt xem paywall 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 paywall.

Để ghi lại sự kiện xem paywall, chỉ cần gọi .logShowFlow(flow) — kết quả 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 .logShowFlow(flow) nếu bạn đang hiển thị 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 đó.

try await Adapty.logShowFlow(flow)

Tham số yêu cầu:

Tham số	Bắt buộc	Mô tả
flow	bắt buộc	Đối tượng `AdaptyFlow` lấy được qua `Adapty.getFlow(placementId:)`.

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 nhìn 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 bao gồm những gì và giao diện paywall trông như thế nào. Chúng tôi cung cấp phương thức để lấy cấu hình remote, giúp bạn tự do trình bày paywall tùy chỉnh được cấu hình qua Remote Config.

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

Để 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.

do {
    let paywall = try await Adapty.getPaywall(placementId: "YOUR_PLACEMENT_ID")
    let headerText = paywall.remoteConfig?.dictionary?["header_text"] as? String
} catch {
    // handle the error
}

Adapty.getPaywall(placementId: "YOUR_PLACEMENT_ID") { result in
    let paywall = try? result.get()
    let headerText = paywall?.remoteConfig?.dictionary?["header_text"] as? String
}

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

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

Theo dõi sự kiện xem paywall

Để ghi lại sự kiện xem paywall, chỉ cần gọi .logShowPaywall(paywall) — kết quả 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ị 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`.