Kích hoạt mua hàng bằng cách sử dụng paywall trong Android SDK
Để kích hoạt in-app purchase, bạn cần nắm ba khái niệm chính:
- Sản phẩm – mọi thứ người dùng có thể mua (gói đăng ký, consumable, quyền truy cập trọn đời)
- Paywall là các cấu hình xác định sản phẩm nào sẽ được cung cấp. Trong Adapty, paywall là cách duy nhất để lấy sản phẩm, nhưng thiết kế này cho phép bạn thay đổi ưu đãi, giá cả và tổ hợp sản phẩm mà không cần chỉnh sửa code.
- Placement – vị trí và thời điểm hiển thị paywall trong ứng dụng (như
main,onboarding,settings). Bạn thiết lập paywall cho các placement trên dashboard, sau đó gọi chúng bằng placement ID trong code. Điều này giúp dễ dàng chạy A/B test và hiển thị các paywall khác nhau cho từng nhóm người dùng.
Adapty cung cấp ba cách để kích hoạt mua hàng trong ứng dụng. Chọn một trong số đó tùy theo yêu cầu của ứng dụng:
| Cách triển khai | Độ phức tạp | Khi nào sử dụng |
|---|---|---|
| Adapty Paywall Builder | ✅ Dễ | Bạn tạo paywall hoàn chỉnh, sẵn sàng để mua hàng trong trình tạo no-code. Adapty tự động render và xử lý toàn bộ luồng mua hàng, xác thực biên lai và quản lý gói đăng ký ở phía sau. |
| Paywall tự tạo | 🟡 Trung bình | Bạn tự tạo giao diện paywall trong code, nhưng vẫn lấy đối tượng paywall từ Adapty để linh hoạt trong việc cung cấp sản phẩm. Xem hướng dẫn. |
| Chế độ Observer | 🔴 Khó | Bạn đã có hạ tầng xử lý mua hàng riêng và muốn tiếp tục sử dụng. Lưu ý rằng chế độ observer có những giới hạn nhất định trong Adapty. Xem bài viết. |
Các bước dưới đây hướng dẫn cách triển khai paywall được tạo trong Adapty Paywall Builder.
Nếu bạn không muốn dùng Paywall Builder, xem hướng dẫn xử lý mua hàng trong paywall tự tạo.
Để hiển thị paywall được tạo trong Adapty Paywall Builder, trong code ứng dụng, bạn chỉ cần:
- Lấy paywall: Lấy paywall từ Adapty.
- Hiển thị paywall và Adapty sẽ xử lý mua hàng cho bạn: Hiển thị container paywall bạn đã lấy trong ứng dụng.
- Xử lý các hành động nút: Liên kết tương tác của người dùng với paywall với phản hồi của ứng dụng. Ví dụ, mở liên kết hoặc đóng paywall khi người dùng nhấn nút.
Trước khi bắt đầu
Trước khi bắt đầu, hãy hoàn thành các bước sau:
- Kết nối ứng dụng với Google Play trong Adapty Dashboard.
- Tạo sản phẩm trong Adapty.
- Tạo paywall và thêm sản phẩm vào đó.
- Tạo placement và thêm paywall vào đó.
- Cài đặt và kích hoạt Adapty SDK trong code ứng dụng.
Cách nhanh nhất để hoàn thành các bước này là làm theo hướng dẫn bắt đầu nhanh hoặc tạo paywall và placement bằng Developer CLI.
1. Lấy paywall
Các paywall của bạn được liên kết với các placement được cấu hình trên dashboard. Placement cho phép bạn chạy các paywall khác nhau cho các đối tượng khác nhau hoặc chạy A/B test.
Để lấy paywall được tạo trong Adapty Paywall Builder, bạn cần:
-
Lấy đối tượng
paywalltheo placement ID bằng phương thứcgetPaywallvà kiểm tra xem đó có phải là paywall được tạo trong builder hay không. -
Lấy cấu hình view của paywall bằng phương thức
getViewConfiguration. Cấu hình view chứa các phần tử UI và kiểu dáng cần thiết để hiển thị paywall.
Để lấy cấu hình view, bạn phải bật toggle Show on device trong Paywall Builder. Nếu không, bạn sẽ nhận được cấu hình view rỗng và paywall sẽ không được hiển thị.
2. Hiển thị paywall
Bây giờ khi đã có cấu hình paywall, chỉ cần thêm vài dòng code để hiển thị paywall của bạn.
Để hiển thị paywall trên màn hình thiết bị, trước tiên bạn phải cấu hình nó. Để làm vậy, gọi phương thức AdaptyUI.getPaywallView() hoặc tạo trực tiếp AdaptyPaywallView:
Sau khi view được tạo thành công, bạn có thể thêm nó vào cây view hierarchy và hiển thị trên màn hình thiết bị.
Để biết thêm chi tiết về cách hiển thị paywall, xem hướng dẫn của chúng tôi.
3. Xử lý các hành động nút
Khi người dùng nhấn nút trong paywall, Android SDK tự động xử lý mua hàng, khôi phục, đóng paywall và mở liên kết.
Tuy nhiên, các nút khác có ID tùy chỉnh hoặc được định nghĩa sẵn và cần xử lý hành động trong code của bạn. Hoặc, bạn có thể muốn ghi đè hành vi mặc định của chúng.
Ví dụ, đây là hành vi mặc định của nút đóng. Bạn không cần thêm nó vào code, nhưng ở đây bạn có thể thấy cách thực hiện nếu cần.
Các bước tiếp theo
Bạn có câu hỏi hoặc gặp sự cố? Hãy xem diễn đàn hỗ trợ của chúng tôi — nơi bạn có thể tìm câu trả lời cho các câu hỏi thường gặp hoặc đặt câu hỏi của riêng mình. Đội ngũ và cộng đồng của chúng tôi luôn sẵn sàng giúp đỡ!
Paywall của bạn đã sẵn sàng để hiển thị trong ứng dụng. Kiểm tra mua hàng trên Google Play Store để đảm bảo bạn có thể hoàn tất một giao dịch mua thử nghiệm từ paywall.
Tiếp theo, bạn cần kiểm tra mức độ truy cập của người dùng để đảm bảo hiển thị paywall hoặc cấp quyền truy cập tính năng trả phí cho đúng người dùng.
Ví dụ đầy đủ
Dưới đây là cách tất cả các bước đó có thể được tích hợp cùng nhau trong ứng dụng của bạn.