Signaler les transactions en Observer Mode dans le SDK Flutter

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

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

Warning

Ne sautez pas l’étape du reporting 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 les flows et paywalls Adapty, incluez le variationId lors du reporting d’une transaction. Cela associe l’achat au flow ou au paywall qui l’a déclenché, garantissant ainsi des analyses 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ètre	Présence	Description
transactionId	requis	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.
variationId	optionnel	L’identifiant de type chaîne de la variante. Vous pouvez l’obtenir via la propriété `variationId` de l’objet AdaptyPaywall.

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

Utilisez reportTransaction sur les deux plateformes pour signaler explicitement chaque transaction, et utilisez restorePurchases sur Android comme étape supplémentaire pour vous assurer qu’Adapty la reconnaît.

Warning

Ne sautez pas l’étape du signalement des transactions et de la restauration des achats ! Si vous n’appelez pas ces méthodes, 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 les flows et 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 analyses précises.

// every time when calling transaction.finish()
if (Platform.isAndroid) {
    try {
        await Adapty().restorePurchases();
    } on AdaptyError catch (adaptyError) {
        // handle the error
    } catch (e) {
    }
}

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ètre	Présence	Description
transactionId	requis	Pour iOS, StoreKit 1 : un objet SKPaymentTransaction. Pour iOS, StoreKit 2 : un objet Transaction. Pour Android : identifiant de type String (purchase.getOrderId de l’achat, où purchase est une instance de la classe Purchase de la bibliothèque de facturation).
variationId	optionnel	L’identifiant de type String de la variante. Vous pouvez l’obtenir via la propriété `variationId` de l’objet AdaptyPaywall.

Reporting transactions

Utilisez restorePurchases pour signaler une transaction à Adapty en mode Observer, comme expliqué sur la page Restaurer les achats dans le code mobile.

Warning

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

Associer les flows et les paywalls aux transactions

Le SDK Adapty ne peut pas déterminer la source des achats, car c’est vous qui les traitez. Par conséquent, si vous avez l’intention d’utiliser des flows, des paywalls et/ou des tests A/B en mode Observer, vous devez associer la transaction provenant de votre store à la flow ou au paywall correspondant dans le code de votre application mobile. Il est important de faire cela correctement avant de publier votre application, sinon cela entraînera des erreurs dans les analyses.

final transactionId = transaction.transactionIdentifier
final variationId = paywall.variationId

try {
  await Adapty().setVariationId('transactionId', variationId);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}