Bật tính năng mua hàng
Cài đặt công cụ agent
Thực hiện toàn bộ quá trình tích hợp Adapty SDK từ công cụ lập trình AI của bạn. Tìm hiểu thêm
Cài đặt vào bất kỳ agent nào hỗ trợ skill. Để cập nhật, chạy npx skills update.
Các skill bao gồm tích hợp SDK, xây dựng flow và paywall, kiểm tra trước khi phát hành, di chuyển placement và nhiều hơn nữa. Mô tả công việc bằng ngôn ngữ thường ngày và agent sẽ chọn skill phù hợp.
Để tiếp tục với hướng dẫn này, hãy đảm bảo bạn đã hoàn thành tích hợp cửa hàng và tạo ít nhất một sản phẩm như mô tả trong hướng dẫn thêm sản phẩm trước đó.
Bây giờ bạn đã có sản phẩm, bạn cần một cách để hiển thị chúng cho người dùng. Adapty cung cấp cho bạn ba lựa chọn:
- Flow & Paywall Builder (được khuyến nghị): Trình soạn thảo trực quan không cần code cho toàn bộ hành trình mua hàng. Adapty SDK render kết quả trực tiếp trên thiết bị, nên bạn không cần viết code UI.
- Paywall thủ công: Bạn tạo một paywall, gắn sản phẩm vào đó và tự render UI trong code ứng dụng.
- Adapty Paywall Builder (Legacy): Trình soạn thảo paywall không cần code.
Cả hai lựa chọn đều kết thúc theo cùng một cách: bạn gắn những gì đã xây dựng vào một placement. Placement là thứ ứng dụng của bạn gọi tại runtime để lấy đúng nội dung cho đúng người dùng.
Flow yêu cầu Adapty SDK v4.0 trở lên.
Một flow bao gồm một hoặc nhiều màn hình với các sản phẩm được nhúng trực tiếp vào. Bạn thiết kế flow trong Flow & Paywall Builder — không cần code.
SDK sẽ hiển thị flow trực tiếp trên từng nền tảng. App của bạn chỉ cần gọi getFlow, và SDK sẽ tự trình bày các màn hình, xử lý giao dịch mua và báo cáo sự kiện. Không cần code UI riêng, không phải duy trì paywall song song.
1. Tạo flow
- Vào Flows trong menu chính của Adapty.
- Nhấn Create flow và thiết kế flow của bạn.
Tìm hiểu thêm về Adapty Flow & Paywall Builder.
Các hướng dẫn theo template dưới đây sẽ đi qua từng bước theo những pattern phổ biến nhất:
Tạo màn hình paywall cơ bản
Hướng dẫn từng bước để xây dựng màn hình paywall tiêu chuẩn trong Flow & Paywall Builder.
Tạo paywall với các tab
Xây dựng màn hình paywall với hai tab để chuyển đổi giữa các danh sách tính năng, nhóm sản phẩm và hành động mua hàng khác nhau.
Hiển thị các tính năng khác nhau theo sản phẩm
Hiển thị danh sách tính năng khác nhau tùy theo sản phẩm người dùng chọn, sử dụng tính năng hiển thị có điều kiện.
Xây dựng flow onboarding cá nhân hóa
Hướng dẫn toàn bộ quy trình xây dựng flow onboarding nhiều màn hình — các màn hình, nội dung, điều hướng và phân nhánh có điều kiện — thông qua một ví dụ thực tế.
Sau khi flow đã được lưu và xuất bản, hãy tiếp tục gắn nó vào một placement.
Đừng quên xuất bản flow! Nếu bạn không xuất bản, bạn sẽ không thể thêm flow vào placement.
2. Thêm flow vào placement
Tạo một placement Placement là một điểm cụ thể trong ứng dụng của bạn nơi bạn hiển thị flow, paywall, onboarding hoặc A/B test. Placement cho phép bạn nhắm mục tiêu đến các đối tượng cụ thể với nội dung của mình. Tìm hiểu thêm về placements. để ứng dụng của bạn có thể yêu cầu flow trong thời gian chạy.
Hãy bắt đầu với placement quan trọng nhất — placement onboarding. Sau đó, bạn có thể thêm nhiều placement có ý nghĩa hơn trong suốt hành trình người dùng.
- Truy cập Placements trong menu chính của Adapty và chuyển sang tab Flows.
- Nhấp Create placement.
- Nhập Placement name (ví dụ:
mainhoặconboarding). Đây là tên định danh nội bộ trong Adapty Dashboard. - Nhập Placement ID. Bạn sẽ dùng ID này trong Adapty SDK để tải flow của placement.
- Nhấp Run flow và chọn flow bạn vừa tạo.
- Nhấp Save & publish.
Trong code ứng dụng, bạn chỉ cần hardcode các placement ID. Mọi thứ còn lại — flow nào chạy, sản phẩm nào được bán, giao diện trông như thế nào — đều được cấu hình trong Adapty Dashboard và có thể thay đổi bất cứ lúc nào mà không cần cập nhật ứng dụng.
Một paywall là container được cấu hình từ xa chứa một hoặc nhiều sản phẩm. Adapty cung cấp danh sách sản phẩm và một JSON payload Remote Config tùy chọn — code ứng dụng của bạn đọc chúng và tự dựng giao diện.
Muốn thiết lập Adapty bằng lập trình? Bạn có thể hoàn thành bước này bằng Developer CLI.
1. Tạo một paywall
- Vào Paywalls trong menu chính của Adapty.
- Nhấn Create paywall.
- Nhập Paywall name. Đây là tên định danh nội bộ trong Adapty Dashboard.
- Nhấn Add product và chọn các sản phẩm muốn hiển thị trên paywall.
- (Tùy chọn) Mở tab Remote config và thêm JSON payload mà ứng dụng cần (tiêu đề, nội dung, feature flag). Xem Thiết kế paywall với Remote Config để biết thêm chi tiết.
- Nhấn Create as a draft, sau đó xuất bản khi sẵn sàng.
Bạn sẽ render paywall này trong code ứng dụng của mình. triển khai paywall thủ công Xem hướng dẫn cho nền tảng của bạn: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
2. Thêm paywall vào một placement
Tạo một placement Placement là một vị trí cụ thể trong ứng dụng của bạn, nơi bạn hiển thị flow, paywall, onboarding hoặc A/B test. Placement cho phép bạn nhắm mục tiêu đến các đối tượng cụ thể với nội dung của mình. Tìm hiểu thêm về placements. để ứng dụng có thể yêu cầu paywall khi chạy.
Hãy bắt đầu với placement cơ bản nhất — placement onboarding. Sau đó, bạn có thể thêm nhiều placement có ý nghĩa hơn trong suốt hành trình người dùng.
- Vào Placements trong menu chính của Adapty và chuyển sang tab Paywalls.
- Nhấn Create placement.
- Nhập Placement name (ví dụ:
mainhoặconboarding). Đây là định danh nội bộ trong Adapty Dashboard. - Nhập Placement ID. Bạn sẽ dùng ID này trong SDK để tải paywall của placement.
- Nhấn Run paywall và chọn paywall vừa tạo.
- Nhấn Save & publish.
Trong code ứng dụng, bạn chỉ cần hardcode các placement ID. Mọi thứ còn lại — paywall nào sẽ chạy, sản phẩm nào được bán, Remote Config — đều được cấu hình trong Adapty Dashboard và có thể thay đổi bất kỳ lúc nào mà không cần cập nhật ứng dụng.
Một paywall được xây dựng trong Paywall Builder là màn hình không cần code với các sản phẩm được nhúng trực tiếp. SDK của Adapty render nó theo kiểu native, nên bạn không cần viết code UI.
Từ ngày 1 tháng 10 năm 2026, bạn không thể tạo paywall và onboarding mới trong legacy Paywall Builder và Onboarding Builder, và hỗ trợ cho chúng sẽ dừng lại. Các paywall và onboarding đã xuất bản vẫn hoạt động bình thường trong ứng dụng của bạn, và bạn vẫn có thể chỉnh sửa chúng. Hãy xây dựng các paywall và onboarding mới trong Flow & Paywall Builder — xem Paywall Builder và Onboarding Builder ngừng hỗ trợ để biết những thay đổi gì.
1. Xây dựng paywall
- Vào Paywalls trong menu chính của Adapty.
- Nhấp Create paywall.
- Nhập Paywall name. Đây là tên định danh nội bộ trong Adapty Dashboard.
- Nhấp Add product và chọn các sản phẩm để hiển thị trên paywall.
- Mở tab Builder & Generator. Tạo paywall từ template hoặc tạo bằng AI.
- Bật toggle Show on device để SDK có thể render nó.
2. Thêm paywall vào một placement
Tạo một placement Placement là một vị trí cụ thể trong ứng dụng của bạn, nơi bạn hiển thị flow, paywall, onboarding hoặc A/B test. Placement cho phép bạn nhắm mục tiêu đến các đối tượng cụ thể với nội dung của mình. Tìm hiểu thêm về placement. để ứng dụng của bạn có thể yêu cầu paywall trong thời gian chạy.
- Truy cập Placements trong menu chính của Adapty và chuyển sang tab Paywalls.
- Nhấp vào Create placement.
- Nhập Placement name (ví dụ:
mainhoặconboarding). Đây là mã định danh nội bộ trong Adapty Dashboard. - Nhập Placement ID. Bạn sẽ dùng ID này trong SDK để tải paywall của placement.
- Nhấp vào Run paywall và chọn paywall bạn đã tạo.
- Nhấp vào Save & publish.
Trong code ứng dụng, bạn chỉ cần hardcode các placement ID. Tất cả những thứ còn lại — paywall nào đang chạy, sản phẩm nào được bán, giao diện trông như thế nào — đều được cấu hình trong Adapty Dashboard và có thể thay đổi bất kỳ lúc nào mà không cần cập nhật ứng dụng.
Các bước tiếp theo
Giờ bạn đã có nội dung để SDK phân phối. Tiếp theo, hãy tích hợp Adapty SDK vào ứng dụng của bạn và bắt đầu lấy placement.