En mode Observer, le SDK Adapty ne peut pas suivre les achats effectués via votre système d’achat existant de façon autonome. Vous devez signaler les transactions depuis votre store. Il est crucial de configurer cela avant de publier votre application afin d’éviter des erreurs dans les analyses.
Utilisez reportTransaction pour signaler explicitement chaque transaction afin qu’Adapty la reconnaisse.
Warning
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 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 analytics 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 | required | - 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 | optional | L’identifiant de type chaîne de la variante. Vous pouvez l’obtenir via la propriété variationId de l’objet AdaptyPaywall. |
En mode Observateur, 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 ou les restaurer. Il est crucial 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 les 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
- Les versions jusqu’à 3.1.x écoutent automatiquement les transactions dans l’App Store, donc aucun reporting manuel n’est requis.
- La version 3.2 ne prend pas en charge le mode Observer.
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) {
}