Signaler les transactions en mode Observer dans Unity SDK
Installer les outils pour agents
Réalisez toute l'intégration du SDK Adapty depuis votre outil de développement IA. En savoir plus
S'installe dans n'importe quel agent compatible avec les skills. Pour mettre à jour ultérieurement, exécutez npx skills update.
Après l'installation, exécutez la skill dans votre projet :
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.
Ne sautez pas l’étape de 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 relie l’achat au flow ou au paywall qui l’a déclenché, ce qui garantit des analyses précises.
Adapty.ReportTransaction(
"YOUR_TRANSACTION_ID",
"PAYWALL_VARIATION_ID", // optional
(error) => {
// handle the error
});Paramètres :
| Paramètre | Présence | Description |
|---|---|---|
| transactionId | obligatoire |
|
| 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 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 essentiel de configurer cela avant de publier votre application pour éviter les erreurs dans les analytics.
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.
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.
Si vous utilisez les flows & paywalls Adapty, incluez le PAYWALL_VARIATION_ID 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 transasction.finish()
#if UNITY_ANDROID && !UNITY_EDITOR
Adapty.RestorePurchases((profile, error) => {
// handle the error
});
#endif
Adapty.ReportTransaction(
"YOUR_TRANSACTION_ID",
"PAYWALL_VARIATION_ID", // optional
(error) => {
// handle the error
});Paramètres :
| Paramètre | Présence | Description |
|---|---|---|
| transactionId | requis |
|
| 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 signalement manuel n’est nécessaire.
- 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.
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 des flows et des paywalls aux transactions
Le SDK Adapty ne peut pas déterminer la source des achats, puisque c’est vous qui les traitez. Par conséquent, si vous souhaitez utiliser des flows, des paywalls et/ou des tests A/B en mode Observer, vous devez associer la transaction provenant de votre store avec le flow ou 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.
Adapty.SetVariationForTransaction("<variationId>", "<transactionId>", (error) => {
if(error != null) {
// handle the error
return;
}
// successful binding
});
| Paramètre | Présence | Description |
|---|---|---|
| transactionId | required | 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 | required | L’identifiant de type String de la variante. Vous pouvez l’obtenir via la propriété variationId de l’objet AdaptyPaywall. |