Hiển thị paywall được thiết kế bằng Remote Config trong Flutter 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 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ị

Trong v4, flow chứa danh sách remoteConfigs — mỗi remote config tương ứng với một ngôn ngữ đã được cấu hình. Chọn mục phù hợp với ngôn ngữ của người dùng và trích xuất các giá trị cần thiết. Xem Bản địa hóa và mã ngôn ngữ để chọn đúng ngôn ngữ.


try {
  final flow = await Adapty().getFlow(placementId: 'YOUR_PLACEMENT_ID');

  // one entry per configured localization; fall back to the first one
  final config = flow.remoteConfigs.firstWhereOrNull((c) => c.locale == 'en') ??
      flow.remoteConfig;

  final String? headerText = config?.dictionary?['header_text'] as String?;
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // 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à kết hợp chúng thành một trang có giao diện đẹp. Hãy đảm bảo thiết kế tương thích với nhiều loại màn hình điện thoại và hướng xoay 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 mọi 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 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 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 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 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ự can thiệp của bạn, vì chỉ bạn mới biết khi nào khách hàng nhìn thấy paywall.

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

Không cần gọi .logShowFlow(flow: flow) nếu bạn đang hiển thị các flow hoặc paywall được tạo trong builder.

try {
  await Adapty().logShowFlow(flow: flow);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // 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`.

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 cho phép linh hoạt theo nhu cầu của bạn, bạn hoàn toàn quyết định những gì được đưa vào và giao diện paywall 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 Config, 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ị

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

try {
  final paywall = await Adapty().getPaywall(placementId: "YOUR_PLACEMENT_ID");
  final String? headerText = paywall.remoteConfig?.dictionary?['header_text'] as String?;
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

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ế phù hợp với nhiều loại màn hình điện thoại và các hướng xoay 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 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, cho phép Adapty analytics thu thập thông tin cho các funnel và A/B test.

Theo dõi sự kiện xem paywall

Adapty giúp bạn đo lường hiệu suất của các paywall. Trong khi chúng tôi tự động thu thập dữ liệu về 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 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 funnels 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.

try {
  final result = await Adapty().logShowPaywall(paywall: paywall);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

Tham số yêu cầu:

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