Báo cáo giao dịch trong Observer Mode trong Unity 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ự độ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 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 phân tích.
Sử dụng reportTransaction để báo cáo từng giao dịch một cách rõ ràng để Adapty nhận diện.
Đừng bỏ qua bước báo cáo giao dịch!
Nếu bạn không gọi ReportTransaction, Adapty sẽ không nhận diện được giao dịch, giao dịch đó sẽ không hiển thị trong analytics và 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 đưa variationId vào 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.
Adapty.ReportTransaction(
"YOUR_TRANSACTION_ID",
"PAYWALL_VARIATION_ID", // optional
(error) => {
// handle the error
});Tham số:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| transactionId | bắt buộc |
|
| variationId | tùy chọn | Mã định danh dạng 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. |
Trong Observer mode, Adapty 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 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.
Dùng reportTransaction trên cả hai nền tảng để báo cáo rõ ràng từng giao dịch, và dùng restorePurchases trên Android như một bước bổ sung để đảm bảo Adapty nhận diện được giao dịch đó.
Đừng bỏ qua việc báo cáo giao dịch và khôi phục giao dịch mua! Nếu bạn không gọi các phương thức này, 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 flows & paywalls của Adapty, hãy bao gồm PAYWALL_VARIATION_ID 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.
// every time when calling transasction.finish()
#if UNITY_ANDROID && !UNITY_EDITOR
Adapty.RestorePurchases((profile, error) => {
// handle the error
});
#endif
Adapty.ReportTransaction(
"YOUR_TRANSACTION_ID",
"PAYWALL_VARIATION_ID", // optional
(error) => {
// handle the error
});Tham số:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| transactionId | bắt buộc |
|
| variationId | tùy chọn | 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. |
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 trong 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.
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 giao dịch mua 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, giao dịch 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 có ý đị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 của mình với flow hoặc paywall tương ứng trong code ứng dụng di động. Điều này 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.
Adapty.SetVariationForTransaction("<variationId>", "<transactionId>", (error) => {
if(error != null) {
// handle the error
return;
}
// successful binding
});
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| transactionId | bắt buộc | Đối với iOS, StoreKit 1: đối tượng SKPaymentTransaction. Đối với iOS, StoreKit 2: đối tượng Transaction. Đối với Android: định danh dạng String (purchase.getOrderId của giao dịch mua, trong đó purchase là một instance của lớp Purchase thuộc billing library. |
| variationId | bắt buộc | Định danh dạng String 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. |