Kích hoạt mua hàng với Flow & Paywall Builder trong iOS SDK

Để 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 – 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 tới người dùng, được xây dựng trong 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 hiển thị flow trong ứng dụng của bạn (ví dụ: main, onboarding, settings). Bạn gắn flow vào placement trong dashboard, sau đó yêu cầu 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 flow 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:

Triển khaiĐộ phức tạpKhi 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ộ flow mua hàng phức tạp, xác thực biên lai và quản lý gói đăng ký.
Paywall tự tạo thủ công🟡 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ì 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ó sẵn cơ sở hạ tầng xử lý giao dịch 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.
Important

Các bước dưới đây hướng dẫn cách tích hợp 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 Tích hợp 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:

  1. Lấy flow: Lấy từ Adapty.
  2. Hiển thị và Adapty sẽ xử lý thanh toán cho bạn: Hiển thị view trong ứng dụng của bạn.
  3. 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 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:

  1. Kết nối ứng dụng của bạn với App Store trong Adapty Dashboard.
  2. Tạo sản phẩm trong Adapty.
  3. Tạo một flowthêm sản phẩm vào đó.
  4. Tạo một placement và thêm flow của bạn vào đó.
  5. Cài đặt và kích hoạt SDK trong mã ứng dụng của bạn. Hướng dẫn này sử dụng API của Adapty iOS SDK v4.

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 trong 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 đã tạo trong Adapty Flow & Paywall Builder, bạn cần:

  1. 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.
  2. Lấy cấu hình view bằng phương thức getFlowConfiguration. Cấu hình này chứa các thành phần UI và kiểu dáng cần thiết để hiển thị flow.

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

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 của mình.

Info

Để biết thêm chi tiết về cách hiển thị một flow, hãy 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, iOS SDK tự động xử lý việc mua hàng, khôi phục, đóng flow và mở liên kết.

Tuy nhiên, một số nút có ID tùy chỉnh hoặc được định 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ụ, dưới đâ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 độngsự kiện 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 của bạn đã sẵn sàng để hiển thị trong app. Kiểm thử mua hàng trong chế độ sandbox để đảm bảo bạn có thể hoàn tất một giao dịch mua thử.

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ị flow 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.