Signaler les transactions en Observer Mode dans le SDK Flutter

En Observer Mode, 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 app store. Il est indispensable 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 la reconnaisse.

Ne sautez pas le signalement 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 paywalls Adapty, incluez le variationId lors du signalement d’une transaction. Cela associe l’achat au paywall qui l’a déclenché, garantissant des analyses de paywall précises.

try {
    // every time when calling transaction.finish()
    await Adapty().reportTransaction(
        "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 Observer Mode, 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 app store ou les restaurer. Il est indispensable de configurer cela avant de publier votre application pour éviter des 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 s’assurer qu’Adapty la reconnaît.

Ne sautez pas le signalement des transactions et 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.

// 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(
        "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 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.

Signalement des transactions

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

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.

Association des 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 souhaitez utiliser des paywalls et/ou des tests A/B en Observer Mode, vous devez associer la transaction provenant de votre app store au paywall correspondant dans le code de votre application mobile. Il est important de bien configurer cela 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) {
}