Triển khai chế độ Observer trong Kotlin Multiplatform SDK

Nếu bạn đã có hệ thống xử lý mua hàng riêng và chưa sẵn sàng chuyển hoàn toàn sang Adapty, bạn có thể tìm hiểu về Observer mode. Ở dạng cơ bản, Observer Mode cung cấp analytics nâng cao và tích hợp liền mạch với các hệ thống attribution và analytics.

Nếu điều này phù hợp với nhu cầu của bạn, bạn chỉ cần:

Bật tính năng này khi cấu hình SDK bằng cách đặt tham số observerMode thành true. Làm theo hướng dẫn cài đặt cho Kotlin Multiplatform.
Báo cáo giao dịch từ hạ tầng mua hàng hiện có của bạn tới Adapty.

Tip

Trong SDK v4, bạn cũng có thể hiển thị các flow và paywall được Adapty render trong Observer mode: đăng ký một AdaptyUIObserverModeResolver với setObserverModeResolver để thực hiện mua hàng hoặc khôi phục bằng code của riêng bạn khi người dùng nhấn vào nút tương ứng. Xem Hiển thị flow trong Observer mode.

Cài đặt chế độ Observer

Bật chế độ Observer nếu bạn tự xử lý các giao dịch mua và trạng thái gói đăng ký, đồng thời sử dụng Adapty để gửi sự kiện gói đăng ký và phân tích.

Important

Khi chạy ở chế độ Observer, Adapty SDK sẽ không đóng bất kỳ giao dịch nào, vì vậy hãy đảm bảo bạn tự xử lý điều đó.


val config = AdaptyConfig
    .Builder("PUBLIC_SDK_KEY")
    .withObserverMode(true)     // default false
    .build()

Adapty.activate(configuration = config)
    .onSuccess {
        Log.d("Adapty", "SDK initialised in observer mode")
    }
    .onError { error ->
        Log.e("Adapty", "Adapty init error: ${error.message}")
    }

Các tham số:

Parameter	Description
observerMode	Giá trị boolean kiểm soát chế độ Observer. Giá trị mặc định là `false`.

Sử dụng flows & paywalls của Adapty trong Observer Mode

Nếu bạn cũng muốn sử dụng các tính năng flows, paywalls và A/B test của Adapty, bạn hoàn toàn có thể — nhưng cần thực hiện thêm một số bước cấu hình trong Observer mode. Ngoài các bước đã nêu ở trên, bạn cần làm thêm:

Hiển thị paywall Remote Config như thông thường. Đối với flows & paywalls được xây dựng trong Flow Builder, xem Hiển thị flows trong Observer mode.
Liên kết flows & paywalls với các giao dịch mua hàng.