Signaler les transactions en Observer Mode dans le SDK Android
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.
Les skills couvrent l'intégration du SDK, la création de flows et de paywalls, les audits avant publication, la migration des placements et bien plus encore. Décrivez la tâche en langage courant et votre agent choisira la skill adaptée.
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. Il est crucial 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 la reconnaisse.
Ne sautez pas l’étape de déclaration de la transaction !
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 de la déclaration d’une transaction. Cela relie l’achat au flow ou au paywall qui l’a déclenché, garantissant ainsi des analyses précises.
val transactionInfo = TransactionInfo.fromPurchase(purchase)
Adapty.reportTransaction(transactionInfo, variationId) { result ->
if (result is AdaptyResult.Success) {
// success
}
}Paramètres :
| Paramètre | Présence | Description |
|---|---|---|
| transactionInfo | requis | Le TransactionInfo issu de l’achat, où l’achat est une instance de la classe Purchase de la bibliothèque de facturation. |
| variationId | optionnel | L’identifiant de chaîne de la variante. Vous pouvez l’obtenir via la propriété variationId de l’objet AdaptyPaywall. |
TransactionInfo transactionInfo = TransactionInfo.fromPurchase(purchase);
Adapty.reportTransaction(transactionInfo, variationId, result -> {
if (result instanceof AdaptyResult.Success) {
// success
}
});Paramètres :
| Paramètre | Présence | Description |
|---|---|---|
| transactionInfo | required | Le TransactionInfo issu de l’achat, où l’achat est une instance de la classe Purchase de la bibliothèque de facturation. |
| variationId | optional | L’identifiant de 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 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 impératif de configurer cela avant de publier votre application pour éviter les erreurs dans les analyses.
Utilisez restorePurchases pour signaler la transaction à Adapty.
Ne sautez pas la restauration des achats !
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.
Si vous utilisez les flows et paywalls Adapty, liez votre transaction au flow ou au paywall qui a conduit à l’achat en utilisant la méthode setVariationId. Cela attribue l’achat correctement pour des analyses précises.
Adapty.restorePurchases { result ->
if (result is AdaptyResult.Success) {
// success
}
}
Adapty.setVariationId(transactionId, variationId) { error ->
if (error == null) {
// success
}
}Paramètres :
| Paramètre | Présence | Description |
|---|---|---|
| transactionId | requis | Identifiant de type String (purchase.getOrderId) de l’achat, où l’achat est une instance de la classe Purchase de la bibliothèque de facturation. |
| variationId | requis | L’identifiant de type String de la variante. Vous pouvez l’obtenir via la propriété variationId de l’objet AdaptyPaywall. |
Adapty.restorePurchases(result -> {
if (result instanceof AdaptyResult.Success) {
// success
}
});
Adapty.setVariationId(transactionId, variationId, error -> {
if (error == null) {
// success
}
});Paramètres :
| Paramètre | Présence | Description |
|---|---|---|
| transactionId | required | Identifiant de type String (purchase.getOrderId) de l’achat, où l’achat 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. |
Signalement des transactions
Utilisez restorePurchases pour signaler une transaction à Adapty en mode Observateur, 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 flows et 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 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 bien effectuer cette opération avant de publier votre application, faute de quoi cela entraînera des erreurs dans les analytics.
Adapty.setVariationId(transactionId, variationId) { error ->
if (error == null) {
// success
}
}Paramètres de la requête :
| Paramètre | Présence | Description |
|---|---|---|
| transactionId | required | Identifiant de type chaîne (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 chaîne de la variante. Vous pouvez l’obtenir via la propriété variationId de l’objet AdaptyPaywall. |
Adapty.setVariationId(transactionId, variationId, error -> {
if (error == null) {
// success
}
});
| Paramètre | Présence | Description |
|---|---|---|
| transactionId | requis | 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 | requis | L’identifiant de type String de la variante. Vous pouvez l’obtenir via la propriété variationId de l’objet AdaptyPaywall. |