Kích hoạt mua hàng với Flow & Paywall Builder trong React Native SDK
Để kích hoạt in-app purchase, bạn cần hiểu 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)
- Flow – chuỗi màn hình giới thiệu sản phẩm đến người dùng, được tạo bằng Flow & Paywall Builder không cần code. SDK lấy chúng qua
getFlow. Nếu bạn muốn tự xây dựng giao diện trong code của mình, hãy dùng paywall thay thế — xem Triển khai paywall thủ công. - Placement – nơi và thời điểm bạn hiển thị flow trong ứng dụng (ví dụ:
main,onboarding,settings). Bạn gắn flow vào placement trên dashboard, sau đó yêu cầu chúng theo placement ID trong code. Điều này giúp dễ dàng chạy A/B test và hiển thị các flow khác nhau cho những người dùng khác nhau.
Adapty cung cấp cho bạn ba cách để tích hợp tính năng mua hàng trong ứng dụng. Hãy chọn một trong số đó tùy theo yêu cầu của ứng dụng:
| Triển khai | Độ phức tạp | Khi nào sử dụng |
|---|---|---|
| Adapty Flow & Paywall Builder | ✅ Dễ | Bạn tạo một flow hoàn chỉnh, sẵn sàng mua hàng trong trình tạo không cần code. Adapty tự động hiển thị và xử lý toàn bộ quy trình mua hàng phức tạp, xác thực biên lai và quản lý gói đăng ký ở phía sau. |
| Paywall tạo thủ công | 🟡 Trung bình | Bạn tự triển khai giao diện paywall trong code ứng dụng, nhưng vẫn lấy đối tượng flow từ Adapty để duy trì sự 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 nó. Lưu ý rằng chế độ observer có những hạn chế 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 một flow được tạo trong Adapty Flow & Paywall Builder.
Nếu bạn muốn tự xây dựng giao diện paywall, hãy xem Triển khai paywall thủ công.
Để hiển thị một flow được tạo trong Adapty Flow & Paywall Builder, trong code của ứng dụng, bạn chỉ cần:
- Lấy flow: Lấy từ Adapty.
- Hiển thị flow và Adapty sẽ xử lý giao dịch mua hàng cho bạn: Hiển thị view trong ứng dụng của bạn.
- Xử lý hành động nút: Liên kết thao tác của người dùng với phản hồi của ứng dụng. Ví dụ: mở liên kết hoặc đóng flow 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 của bạn với App Store và/hoặc Google Play trong Adapty Dashboard.
- Tạo sản phẩm trong Adapty.
- Tạo một flow và thêm sản phẩm vào đó.
- Tạo một placement và thêm flow vào đó.
- Cài đặt và kích hoạt Adapty SDK trong mã nguồn ứng dụng của bạn. Hướng dẫn này sử dụng Adapty React Native SDK v4 APIs.
1. Lấy flow
Các flow 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 flow khác nhau cho các đối tượng khác nhau hoặc chạy A/B test.
Để lấy một flow được tạo trong Adapty Flow & Paywall Builder, hãy lấy đối tượng flow theo ID placement bằng phương thức getFlow. Flow chứa các phần tử UI và kiểu dáng cần thiết để hiển thị nó.
try {
const flow = await adapty.getFlow('YOUR_PLACEMENT_ID');
// the requested flow
} catch (error) {
// handle the error
}
2. Hiển thị flow
Bây giờ, khi bạn đã có flow, chỉ cần thêm vài dòng code là có thể hiển thị nó.
Để biết thêm chi tiết về cách hiển thị một flow, xem hướng dẫn của chúng tôi.
3. Xử lý hành động của nút
Khi người dùng nhấn các nút trong flow, React Native SDK tự động xử lý việc mua hàng, khôi phục, đóng flow và mở URL.
Tuy nhiên, một số nút có ID tùy chỉnh hoặc được định nghĩa sẵn và yêu cầu bạn xử lý hành động trong code. 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 đoạn code này, 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. Hãy kiểm tra mua hàng trong App Store sandbox hoặc trong Google Play Store để đảm bảo bạn có thể hoàn tất một giao dịch mua thử 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 bạn hiển thị paywall hoặc cấp quyền truy cập vào các tính năng trả phí cho đúng người dùng.
Ví dụ đầy đủ
Dưới đây là cách tích hợp tất cả các bước trong hướng dẫn này vào ứng dụng của bạn.