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.
Sau khi cài đặt, chạy skill trong dự án của bạn:
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 integration.
Nếu bạn sử dụng paywall của Adapty, hãy bao gồm variationId khi báo cáo giao dịch. Điều này liên kết giao dịch mua với paywall đã kích hoạt nó, đảm bảo analytics paywall 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 paywall của Adapty, hãy liên kết giao dịch của bạn với paywall đã dẫn đến việc mua hàng bằng phương thức setVariationId. Điều này đảm bảo rằng giao dịch mua hàng được gán chính xác cho paywall đã kích hoạt nó, giúp analytics chính xác hơn. Bước này chỉ cần thiết nếu bạn đang sử dụng paywall của Adapty.
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ư được giải thích trên trang Khôi phục mua hàng trong Mobile Code.
Đừng bỏ qua việ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 phần analytics và sẽ không được gửi đến các tích hợp.
Liên kết 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 hàng vì bạn là người xử lý chúng. Do đó, nếu bạn dự định sử dụng 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 paywall tương ứng trong code ứng dụng di động. Đây là điều 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 tích.
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. |