Báo cáo giao dịch trong Observer Mode trong Flutter SDK

Ở chế độ Observer, 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 sai sót trong analytics.

Sử dụng reportTransaction để báo cáo rõ ràng từng giao dịch để Adapty nhận diện.

Warning

Đừ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 diện được 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.

Nếu bạn sử dụng flows & paywalls của Adapty, 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 hàng với flow hoặc paywall đã kích hoạt nó, đảm bảo phân tích chính xác.

try {
    // every time when calling transaction.finish()
    await Adapty().reportTransaction(
        transactionId: "YOUR_TRANSACTION_ID",
        variationId: "PAYWALL_VARIATION_ID", // optional
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

Tham số:

Tham sốBắt buộcMô tả
transactionIdbắt buộc
  • Với iOS: Mã định danh của giao dịch.
  • Với Android: Mã đị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.
variationIdtùy chọnMã định danh chuỗi của biến thể. Truyền vào paywallVariationId của AdaptyPaywallProduct mà người dùng đã mua. Đây là giá trị giống với variationId của AdaptyFlowPaywall chứa sản phẩm này.
appleJwsTransactiontùy chọnChỉ dành cho iOS, SDK 4.3.0 trở lên. Giao dịch StoreKit 2 đã được ký: jwsRepresentation của kết quả xác minh, tương ứng với cùng giao dịch như transactionId. SDK gửi trực tiếp giá trị này đến Adapty mà không thay đổi. Android bỏ qua tham số này.

Trên iOS, nếu hệ thống mua hàng của bạn cung cấp transaction StoreKit 2, hãy truyền biểu diễn JWS của nó vào appleJwsTransaction:

await Adapty().reportTransaction(
    transactionId: "YOUR_TRANSACTION_ID",
    variationId: "PAYWALL_VARIATION_ID", // optional
    appleJwsTransaction: jwsRepresentation, // iOS only, optional
);