Hiển thị paywall được tạo bằng Paywall Builder trong Observer mode trên Android SDK
Nếu bạn đã tạo một flow hoặc paywall bằng Flow Builder hoặc Paywall Builder, bạn không cần lo lắng về việc render nó trong code ứng dụng di động để hiển thị cho người dùng. Flow hoặc paywall đó đã bao gồm cả nội dung cần hiển thị lẫn cách hiển thị nó.
Phần này chỉ dành cho Observer mode. Nếu bạn không làm việc ở Observer mode, hãy tham khảo chủ đề Android - Hiển thị flows & paywalls thay thế.
Trước khi bắt đầu hiển thị flows (Nhấn để mở rộng)
- Thiết lập tích hợp ban đầu của Adapty với Google Play.
2. Cài đặt và cấu hình Adapty SDK. Đảm bảo đặt tham số
observerModethànhtrue. Tham khảo hướng dẫn theo từng framework cho Android. 3. Tạo sản phẩm trong Adapty Dashboard. 4. Cấu hình flow hoặc paywall trong các builder và gán sản phẩm vào chúng. 5. Tạo placement và gán flow hoặc paywall vào chúng trong Adapty Dashboard. 6. Lấy flow và cấu hình của chúng trong code ứng dụng di động của bạn.
- Triển khai
AdaptyUiObserverModeHandler.
Sự kiện onPurchaseInitiated sẽ thông báo cho bạn biết người dùng đã khởi tạo một giao dịch mua. Bạn có thể kích hoạt flow mua hàng tùy chỉnh của mình để phản hồi callback này:
Để xử lý việc khôi phục giao dịch trong Observer mode, hãy override getRestoreHandler(). Mặc định nó trả về null, tức là sử dụng flow Adapty.restorePurchases() có sẵn của Adapty. Để cung cấp cách xử lý khôi phục của riêng bạn:
Hãy nhớ gọi các callback sau để thông báo cho AdaptyUI về quá trình mua hàng hoặc khôi phục. Điều này cần thiết để flow hoạt động đúng, chẳng hạn như hiển thị loader:
| Callback | Mô tả |
|---|---|
| onStartPurchase() | Callback cần được gọi để thông báo cho AdaptyUI rằng quá trình mua hàng đã bắt đầu. |
| onFinishPurchase() | Callback cần được gọi để thông báo cho AdaptyUI rằng quá trình mua hàng đã hoàn tất. |
| onStartRestore() | Tùy chọn. Callback có thể được gọi để thông báo cho AdaptyUI rằng quá trình khôi phục đã bắt đầu. |
| onFinishRestore() | Tùy chọn. Callback có thể được gọi để thông báo cho AdaptyUI rằng quá trình khôi phục đã hoàn tất. |
- Để hiển thị flow trực quan lên màn hình thiết bị, bạn cần cấu hình nó trước.
Các tham số yêu cầu:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| flowConfiguration | bắt buộc | Cung cấp đối tượng AdaptyUI.FlowConfiguration chứa thông tin hiển thị của flow. Sử dụng phương thức AdaptyUI.getFlowConfiguration(flow) để tải nó. Tham khảo chủ đề Fetch the view configuration để biết thêm chi tiết. |
| products | tùy chọn | Cung cấp một mảng AdaptyPaywallProduct để tối ưu thời điểm hiển thị sản phẩm trên màn hình. Nếu truyền vào null, AdaptyUI sẽ tự động tải các sản phẩm cần thiết. |
| eventListener | tùy chọn | Cung cấp AdaptyFlowEventListener để theo dõi các sự kiện của flow. Nên kế thừa AdaptyFlowDefaultEventListener để dễ sử dụng hơn. Tham khảo chủ đề Handle flow & paywall events để biết thêm chi tiết. |
| insets | tùy chọn | Insets là khoảng cách xung quanh flow giúp các phần tử có thể nhấn không bị ẩn sau thanh hệ thống. Mặc định: Unspecified, cho phép Adapty tự động điều chỉnh insets. Xem Change flow insets. |
| customAssets | tùy chọn | Truyền đối tượng AdaptyCustomAssets để thay thế hình ảnh và video trong flow hoặc paywall của bạn lúc chạy. Tham khảo Customize assets để biết thêm chi tiết. |
| tagResolver | tùy chọn | Sử dụng AdaptyUiTagResolver để phân giải các custom tag trong văn bản của flow. Resolver này nhận tham số là một tag và phân giải nó thành chuỗi tương ứng. Tham khảo chủ đề Custom tags in Paywall Builder để biết thêm chi tiết. |
| observerModeHandler | bắt buộc khi dùng Observer mode | AdaptyUiObserverModeHandler mà bạn đã triển khai ở bước trước. |
Đừng quên liên kết paywall với giao dịch mua hàng. Nếu không, Adapty sẽ không xác định được flow nguồn của giao dịch mua hàng.