ÿÿ Hiển thị Paywall Remote Config | Flutter SDK | Tài liệu Adapty

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ộcMô tả
flowbắt buộcMộ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.

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 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 Adapÿÿty().logShowPaywall(paywall: paywall);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

Tham số yêu cầu:

Tham sốBắt buộcMô tả
paywallrequiredMột đối tượng AdaptyPaywall.
ÿÿÿÿ