Báo cáo giao dịch trong Observer Mode trên iOS SDK
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.
Sau khi cài đặt, chạy skill trong dự án của bạn:
Ở chế độ Observer, SDK không thể tự động theo dõi các giao dịch mua được thực hiện qua hệ thống mua hàng hiện có của bạn. Bạn cần báo cáo các giao dịch từ cửa hàng ứng dụng theo cách thủ công. Điều quan trọng là phải thiết lập điều này trước khi phát hành ứng dụng để tránh sai sót trong phân tích.
Sử dụng reportTransaction để báo cáo từng giao dịch một cách tường minh để Adapty có thể nhận diện.
Đừng bỏ qua việc báo cáo giao dịch!
Nếu bạn không gọi reportTransaction, Adapty sẽ không nhận ra giao dịch đó, nó sẽ không xuất hiện trong analytics và sẽ không được gửi đến các integration.
Nếu bạn sử dụng flow & paywall của Adapty, hãy truyền variationId khi báo cáo giao dịch. Điều này liên kết giao dịch mua với flow hoặc paywall đã kích hoạt nó, đảm bảo analytics chính xác.
do {
// every time when calling transasction.finish()
try await Adapty.reportTransaction(transaction, withVariationId: <YOUR_PAYWALL_VARIATION_ID>)
} catch {
// handle the error
}Các tham số:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| transaction | bắt buộc |
|
| variationId | tùy chọn | ID duy nhất của biến thể paywall. Lấy từ thuộc tính variationId của đối tượng AdaptyPaywall. |
Trong Observer mode, Adapty SDK không thể tự động theo dõi các giao dịch mua thực hiện qua hệ thống mua hàng hiện tại của bạn. Bạn cần báo cáo các giao dịch từ cửa hàng ứng dụng hoặc khôi phục chúng. Điều quan trọng là phải thiết lập điều này trước khi phát hành ứng dụng để tránh lỗi trong analytics.
Sử dụng reportTransaction để gửi dữ liệu giao dịch đến Adapty.
Đừng bỏ qua việc báo cáo giao dịch!
Nếu bạn không gọi reportTransaction, Adapty sẽ không nhận ra giao dịch đó, nó sẽ không xuất hiện trong analytics và sẽ không được gửi đến các tích hợp.
Nếu bạn sử dụng flow & paywall của Adapty, hãy truyền withVariationId khi báo cáo giao dịch. Điều này liên kết giao dịch mua với flow hoặc paywall đã kích hoạt nó, đảm bảo dữ liệu analytics chính xác.
do {
// every time when calling transasction.finish()
try await Adapty.reportTransaction(transaction, withVariationId: <YOUR_PAYWALL_VARIATION_ID>)
} catch {
// handle the error
}Tham số:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| transaction | bắt buộc |
|
| variationId | tùy chọn | ID duy nhất của biến thể paywall. Lấy từ thuộc tính variationId của đối tượng AdaptyPaywall. |
Báo cáo giao dịch
- Các phiên bản đến 3.1.x tự động lắng nghe các giao dịch từ App Store, vì vậy không cần báo cáo thủ công.
- Phiên bản 3.2 không hỗ trợ Observer Mode.
Liên kết flow & paywall với giao dịch
SDK Adapty không thể xác định nguồn gốc của các giao dịch mua, vì bạn là người xử lý chúng. Do đó, nếu bạn có ý định sử dụng các flow, paywall và/hoặc A/B test trong chế độ Observer, bạn cần liên kết giao dịch đến từ cửa hàng ứng dụng của mình với flow hoặc paywall tương ứng trong code ứng dụng di động. Điều này rất quan trọng và cần được thực hiện đúng trước khi phát hành ứng dụng, nếu không sẽ dẫn đến lỗi trong phân tích.
let variationId = paywall.variationId
// There are two overloads: for StoreKit 1 and StoreKit 2
Adapty.setVariationId(variationId, forPurchasedTransaction: transactionId) { error in
if error == nil {
// successful binding
}
}Tham số yêu cầu:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| variationId | bắt buộc | Chuỗi định danh của biến thể. Bạn có thể lấy nó thông qua thuộc tính variationId của đối tượng AdaptyPaywall. |
| transactionId | bắt buộc | Với StoreKit 1: một đối tượng SKPaymentTransaction. Với StoreKit 2: đối tượng Transaction. |