Thực hiện mua hàng trong ứng dụng với iOS SDK

Trong SDK 3.x, SDK sẽ gọi delegate method shouldAddStorePayment thay thế:

• Xử lý giao dịch ngay lập tức: Trả về true trong shouldAddStorePayment. Thao tác này sẽ kích hoạt màn hình mua hàng của Apple ngay lập tức.
• Lưu trữ đối tượng sản phẩm để xử lý sau: Trả về false trong shouldAddStorePayment, sau đó gọi makePurchase với sản phẩm đã lưu vào lúc khác.

final class YourAdaptyDelegateImplementation: AdaptyDelegate {
    nonisolated func shouldAddStorePayment(for product: AdaptyDeferredProduct) -> Bool {
        // 1a.
        // Return `true` to continue the transaction in your app. The Apple purchase system screen will show automatically.

        // 1b.
        // Store the product object and return `false` to defer or cancel the transaction.
        false
    }
    
    // 2. Continue the deferred purchase later on by passing the product to `makePurchase` when the timing is appropriate
    func continueDeferredPurchase() async {
        let storedProduct: AdaptyDeferredProduct = // get the product object from 1b.
        do {
            try await Adapty.makePurchase(product: storedProduct)
        } catch {
            // handle the error
        }
    }
}

Offer code cho phép bạn cung cấp giảm giá hoặc dùng thử miễn phí cho những người dùng cụ thể. Khác với các ưu đãi thông thường được áp dụng tự động, offer code được phân phối bên ngoài ứng dụng — qua email marketing, mạng xã hội, hoặc tài liệu in ấn. Người dùng đổi code bằng cách nhập code trong App Store, truy cập URL đổi thưởng, hoặc thông qua hộp thoại trong ứng dụng.

Để thiết lập offer code, mở một gói đăng ký trong App Store Connect và vào mục Offer Codes. Bạn có thể tạo ba loại offer code:

• Free — gói đăng ký miễn phí trong một khoảng thời gian nhất định, sau đó gia hạn theo giá đầy đủ.
• Pay as you go — người dùng trả giá giảm mỗi chu kỳ thanh toán trong một khoảng thời gian nhất định, sau đó gói đăng ký gia hạn theo giá đầy đủ.
• Pay up front — người dùng trả một mức giá giảm duy nhất cho toàn bộ thời gian ưu đãi, sau đó gói đăng ký gia hạn theo giá đầy đủ.

Bạn không cần thêm offer code vào Adapty. Apple gắn thẻ mọi giao dịch trong thời gian ưu đãi với danh mục offer code. Điều này bao gồm lần đổi code đầu tiên và tất cả các lần gia hạn có giảm giá tiếp theo. Adapty phát hiện thẻ này và ghi lại mỗi giao dịch với danh mục ưu đãi offer_code. Khi thời gian ưu đãi kết thúc và gói đăng ký gia hạn theo giá đầy đủ, thẻ sẽ không còn nữa. Bạn có thể lọc analytics theo loại ưu đãi Offer Code trong Adapty Dashboard.

Xử lý sự chênh lệch doanh thu

Nếu bạn nhận thấy một giao dịch offer code xuất hiện trong Adapty với giá sản phẩm đầy đủ thay vì giá ưu đãi đã giảm, hãy kiểm tra các điều sau trong App Store Connect:

• Offer code đã được cấu hình đúng giá cho tất cả các khu vực mà người dùng có thể đổi.
• Giá ưu đãi được thiết lập cho quốc gia hoặc khu vực cụ thể của người dùng. Apple gửi giá theo khu vực trong giao dịch. Nếu không có giá theo khu vực được cấu hình cho ưu đãi, Apple có thể gửi giá sản phẩm đầy đủ thay thế.

Bạn có thể lọc và xác minh các giao dịch offer code trong Adapty Dashboard theo loại ưu đãi Offer Code và bộ lọc Offer Discount Type.

Promo code cũ (đã ngừng hỗ trợ)

Promo code cũ (giới hạn 100 code mỗi ứng dụng mỗi phiên bản) cấp quyền truy cập miễn phí vào gói đăng ký. Khác với offer code, Apple không bao gồm thông tin giảm giá trong các giao dịch promo code — Apple gửi giá sản phẩm đầy đủ trong biên lai. Kết quả là Adapty đã ghi lại những giao dịch này theo giá đầy đủ, gây ra sự chênh lệch doanh thu giữa analytics Adapty và App Store Connect.

Nếu bạn thấy các giao dịch lịch sử theo giá đầy đủ mà đáng ra phải miễn phí, nhiều khả năng chúng đến từ promo code cũ. Vì những code này hiện đã ngừng hỗ trợ, hãy chuyển sang offer code để theo dõi doanh thu chính xác.