Báo cáo giao dịch trong Observer Mode trên Android 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.
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.
Trong Observer mode, Adapty SDK không thể tự theo dõi các giao dịch mua được 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 của mình. Đ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.
Dùng reportTransaction để báo cáo từng giao dịch một cách tường minh để Adapty nhận diện được.
Đừ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 Adapty flows & paywalls, hãy thêm 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.
val transactionInfo = TransactionInfo.fromPurchase(purchase)
Adapty.reportTransaction(transactionInfo, variationId) { result ->
if (result is AdaptyResult.Success) {
// success
}
}Tham số:
| Parameter | Presence | Description |
|---|---|---|
| transactionInfo | required | TransactionInfo từ giao dịch mua, trong đó giao dịch mua là một instance của lớp Purchase trong billing library. |
| variationId | optional | Chuỗi định danh của biến thể. Bạn có thể lấy giá trị này thông qua thuộc tính variationId của đối tượng AdaptyPaywall. |
TransactionInfo transactionInfo = TransactionInfo.fromPurchase(purchase);
Adapty.reportTransaction(transactionInfo, variationId, result -> {
if (result instanceof AdaptyResult.Success) {
// success
}
});Tham số:
| Parameter | Presence | Description |
|---|---|---|
| transactionInfo | required | TransactionInfo từ giao dịch mua, trong đó giao dịch mua là một instance của lớp Purchase thuộc thư viện billing. |
| variationId | optional | Chuỗi định danh của biến thể. Bạn có thể lấy giá trị này thông qua 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 được thực hiện thông 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 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 các lỗi trong phân tích.
Sử dụng restorePurchases để báo cáo giao dịch cho Adapty.
Đừng bỏ qua bước khôi phục giao dịch!
Nếu bạn không gọi restorePurchases, 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 liên kết giao dịch của bạn với flow hoặc paywall dẫn đến việc mua hàng bằng phương thức setVariationId. Điều này giúp quy gán đúng giao dịch mua để analytics được chính xác.
Adapty.restorePurchases { result ->
if (result is AdaptyResult.Success) {
// success
}
}
Adapty.setVariationId(transactionId, variationId) { error ->
if (error == null) {
// success
}
}Tham số:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| transactionId | required | Định danh chuỗi (purchase.getOrderId) của giao dịch mua, trong đó purchase là một instance của lớp Purchase trong thư viện billing. |
| variationId | required | Định danh chuỗi của biến thể. Bạn có thể lấy giá trị này thông qua thuộc tính variationId của đối tượng AdaptyPaywall. |
Adapty.restorePurchases(result -> {
if (result instanceof AdaptyResult.Success) {
// success
}
});
Adapty.setVariationId(transactionId, variationId, error -> {
if (error == null) {
// success
}
});Tham số:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| transactionId | required | Định danh chuỗi (purchase.getOrderId) của giao dịch mua, trong đó purchase là một instance của lớp Purchase trong thư viện billing. |
| variationId | required | Định danh chuỗi của biến thể. Bạn có thể lấy giá trị này thông qua thuộc tính variationId của đối tượng AdaptyPaywall. |
Báo cáo giao dịch
Sử dụng restorePurchases để báo cáo giao dịch cho Adapty trong Observer Mode, như đã giải thích trên trang Khôi phục mua hàng trong mã mobile.
Đừng bỏ qua bước báo cáo giao dịch!
Nếu bạn không gọi restorePurchases, 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.
Liên kết flow & paywall với giao dịch
SDK của 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 định sử dụng 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 với flow hoặc paywall tương ứng trong code ứng dụng di động của mình. Điều này rất quan trọng cần 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 analytics.
Adapty.setVariationId(transactionId, variationId) { error ->
if (error == null) {
// success
}
}Tham số yêu cầu:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| transactionId | required | Chuỗi định danh (purchase.getOrderId của purchase, trong đó purchase là một instance của lớp Purchase trong billing library. |
| variationId | required | 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. |
Adapty.setVariationId(transactionId, variationId, error -> {
if (error == null) {
// success
}
});
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| transactionId | bắt buộc | Chuỗi định danh (purchase.getOrderId của purchase, trong đó purchase là một instance của lớp Purchase trong billing library. |
| variationId | bắt buộc | Chuỗi định danh của biến thể. Bạn có thể lấy giá trị này thông qua thuộc tính variationId của đối tượng AdaptyPaywall. |