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 – những gì người dùng có thể mua (gói đăng ký, consumable, quyền truy cập trọn đời)
  • Flow & paywall – các màn hình hiển thị 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 bằng code, xem Triển khai custom paywall.
  • Placement – nơi và thời điểm hiển thị flow & paywall trong ứng dụng (ví dụ: main, onboarding, settings). Bạn gắn chúng vào placement trên dashboard, sau đó gọi 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 nội dung khác nhau cho từng nhóm người dùng.

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ạpKhi nào nên dùng
Adapty Flow & Paywall Builder✅ DễBạn tạo flow hoặc paywall 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ộ logic mua hàng phức tạp, xác thực receipt và quản lý gói đăng ký ở phía sau.
Paywall tùy chỉnh🟡 Trung bìnhBạ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ì tính linh hoạt trong việc cung cấp sản phẩm. Xem hướng dẫn.
Observer mode🔴 KhóBạn đã có cơ sở 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 observer mode có một số hạn chế trong Adapty. Xem bài viết.
Important

Các bước dưới đây hướng dẫn cách triển khai một flow hoặc paywall đượ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 tùy chỉnh.

Để hiển thị một flow hoặc paywall được tạo trong Adapty Flow & Paywall Builder, trong code của bạn, bạn chỉ cần:

  1. Lấy flow hoặc paywall: Lấy từ Adapty.
  2. Hiển thị và để Adapty xử lý thanh toán: Hiển thị view trong ứng dụng của bạn.
  3. Xử lý các thao tác nút: Liên kết các tương 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 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:

  1. Kết nối ứng dụng của bạn với App Store và/hoặc Google Play trong Adapty Dashboard.
  2. Tạo sản phẩm trong Adapty.
  3. Tạo một flow hoặc paywall và thêm sản phẩm vào đó.
  4. Tạo một placement và thêm flow hoặc paywall vào đó.
  5. Cài đặt và kích hoạt SDK trong code ứ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 hoặc paywall

Các flow và 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 hiển thị các flow hoặc paywall khác nhau cho các đối tượng khác nhau hoặc chạy A/B test.

Để lấy một flow hoặc paywall đượ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ử giao diện và kiểu dáng cần thiết để hiển thị.


try {
  const flow = await adapty.getFlow('YOUR_PLACEMENT_ID');
  // the requested flow
} catch (error) {
  // handle the error
}

2. Hiển thị flow hoặc paywall

Sau khi đã có flow, bạn chỉ cần thêm vài dòng code là có thể hiển thị nó.

Tip

Để biết thêm chi tiết về cách hiển thị flow hoặc paywall, xem hướng dẫn của chúng tôi.

3. Xử lý hành động nút

Khi người dùng nhấn các nút trong flow hoặc paywall, React Native SDK sẽ tự động xử lý việc mua hàng, khôi phục, đóng màn hình và mở URL.

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 cho 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.

Tip

Đọc hướng dẫn của chúng tôi về cách xử lý actions và events của nút.

Các bước tiếp theo

Tip

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 đỡ!

Flow hoặc paywall của bạn đã sẵn sàng để hiển thị trong ứng dụng. Kiểm tra giao dịch mua để đảm bảo bạn có thể hoàn tất một giao dịch mua thử nghiệm từ flow.

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í đúng cho người dùng phù hợp.

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.