Signaler les transactions en mode Observateur dans le SDK Flutter

En mode Observer, le SDK Adapty ne peut pas suivre les achats effectués via votre système d’achat existant de manière autonome. Vous devez signaler les transactions depuis votre store. Il est essentiel de configurer cela avant de publier votre application pour éviter des erreurs dans les analyses.

Utilisez reportTransaction pour signaler explicitement chaque transaction afin qu’Adapty puisse la reconnaître.

Warning

Ne sautez pas la déclaration des transactions ! Si vous n’appelez pas reportTransaction, Adapty ne reconnaîtra pas la transaction, elle n’apparaîtra pas dans les analyses et ne sera pas envoyée aux intégrations.

Si vous utilisez des flows et des paywalls Adapty, incluez le variationId lors du signalement d’une transaction. Cela associe l’achat au flow ou au paywall qui l’a déclenché, garantissant ainsi des analytiques précises.

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
}

Paramètres :

ParamètrePrésenceDescription
transactionIdrequis
  • Pour iOS : identifiant de la transaction.
  • Pour Android : identifiant de type chaîne purchase.getOrderId de l’achat, où l’achat est une instance de la classe Purchase de la bibliothèque de facturation.
variationIdoptionnelL’identifiant de type chaîne de la variante. Passez le paywallVariationId du AdaptyPaywallProduct acheté par l’utilisateur. C’est la même valeur que le variationId de AdaptyFlowPaywall qui contient ce produit.
appleJwsTransactionoptionneliOS uniquement, SDK 4.3.0 ou version ultérieure. La transaction StoreKit 2 signée : le jwsRepresentation de son résultat de vérification, pour la même transaction que transactionId. Le SDK l’envoie à Adapty tel quel. Android ignore ce paramètre.

Sur iOS, si votre système d’achat vous fournit la transaction StoreKit 2, transmettez sa représentation JWS dans appleJwsTransaction :

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