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.
Để kích hoạt in-app purchase, bạn cần nắm ba khái niệm cốt lõi:
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 giới thiệu sản phẩm đến người dùng, được xây dựng 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 paywall tùy chỉnh.
Placement – nơi và thời điểm bạn hiển thị flow & paywall trong ứng dụng (ví dụ: main, onboarding, settings). Bạn gắn chúng vào các 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 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 để kích hoạt 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:
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ó 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 chế độ observer 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.
Để hiển thị một flow hoặc paywall được tạo trong Adapty Flow & Paywall Builder, trong code của ứng dụng, bạn chỉ cần:
Lấy flow hoặc paywall: Lấy từ Adapty.
Hiển thị và để Adapty xử lý thanh toán cho bạn: Hiển thị view trong ứng dụng của bạn.
Xử lý các thao tác nút: Liên kết tương tác của người dùng với phản hồi tương ứng trong ứng dụng. Ví dụ: mở liên kết hoặc đóng paywall khi người dùng nhấn nút.
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 iOS 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ấu hình trong dashboard. Placement cho phép bạn chạy 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 đã tạo trong Adapty Flow & Paywall Builder, bạn cần:
Lấy đối tượng flow theo ID placement bằng phương thức getFlow và kiểm tra xem nó có cấu hình view hay không.
Lấy cấu hình view bằng phương thức getFlowConfiguration. Cấu hình này chứa các phần tử UI và kiểu dáng cần thiết để hiển thị.
func loadFlow() async { let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID") guard flow.hasViewConfiguration else { print("Flow doesn't have a view configuration") return } flowConfiguration = try await AdaptyUI.getFlowConfiguration(forFlow: flow)}
2. Hiển thị flow hoặc paywall
Bây giờ, khi bạn đã có cấu hình flow, chỉ cần thêm vài dòng code để hiển thị flow hoặc paywall của bạn.
Trong SwiftUI, khi hiển thị flow, bạn cũng cần xử lý các sự kiện. didFinishPurchase, didFailPurchase, didFinishRestore, didFailRestore, và didReceiveError là bắt buộc. Khi test, bạn có thể chỉ cần sao chép đoạn code bên dưới để ghi log các sự kiện này.
Tip
Flow không tự đóng sau khi mua hàng thành công. Trong didFinishPurchase, đặt binding hiển thị của bạn thành false để đóng flow, hoặc không làm gì để flow tiếp tục đến các màn hình tiếp theo.
.flow( isPresented: $flowPresented, flowConfiguration: flowConfiguration, didFinishPurchase: { product, purchaseResult in print("Purchase finished successfully") flowPresented = false // or do nothing to let the flow continue }, didFailPurchase: { product, error in print("Purchase failed: \(error)") }, didFinishRestore: { profile in print("Restore finished successfully") }, didFailRestore: { error in print("Restore failed: \(error)") }, didReceiveError: { error in flowPresented = false print("Flow error: \(error)") })
Triển khai AdaptyFlowControllerDelegate để xử lý các sự kiện. Ít nhất, hãy triển khai bốn phương thức không có implementation mặc định. Lưu ý rằng controller sẽ không tự đóng sau khi mua hàng thành công — hãy đóng nó trong didFinishPurchase, hoặc không làm gì để flow tiếp tục chuyển sang các màn hình tiếp theo:
Để biết thêm chi tiết về cách hiển thị một flow hoặc paywall, hãy xem hướng dẫn của chúng tôi.
3. Xử lý các hành động của nút
Khi người dùng nhấn các nút, iOS SDK tự động xử lý việc mua hàng, khôi phục, đóng màn hình 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 sẵn và yêu cầu bạn xử lý các 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à cách xử lý nút đóng. Trong UIKit, SDK tự động dismiss controller khi .close được kích hoạt — chỉ ghi đè nếu bạn muốn hành vi tùy chỉnh. Trong SwiftUI, bạn phải tự đặt binding isPresented của mình thành false.
Tip
Đọc hướng dẫn của chúng tôi về cách xử lý hành động và sự kiện của nút.
.flow( isPresented: $flowPresented, flowConfiguration: flowConfiguration, didPerformAction: { action in switch action { case .close: flowPresented = false // dismiss the flow when the user taps close default: break } }, didFinishPurchase: { product, purchaseResult in flowPresented = false }, didFailPurchase: { product, error in /* handle the error */ }, didFinishRestore: { profile in /* check access level and dismiss */ }, didFailRestore: { error in /* handle the error */ }, didReceiveError: { error in flowPresented = false })
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 trong sandbox để đảm bảo bạn có thể hoàn thành một giao dịch mua thử.