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. 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 l’étape du 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 & 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.
do {
// every time when calling transaction.finish()
// verificationResult is the VerificationResult<Transaction> StoreKit 2 returns
try await Adapty.reportTransaction(verificationResult, withVariationId: <YOUR_PAYWALL_VARIATION_ID>)
} catch {
// handle the error
}
Paramètres :
| Paramètre | Présence | Description |
|---|
| transaction | required | - Pour StoreKit 1 : SKPaymentTransaction.
- Pour StoreKit 2 :
Transaction, ou, à partir du SDK 3.12.0, VerificationResult<Transaction> tel que StoreKit le renvoie, avant que vous ne le déballiez.
|
| variationId | optional | L’identifiant unique de la variante de paywall. Récupérez-le depuis la propriété variationId de l’objet AdaptyPaywall. |
En mode Observateur, 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 crucial de configurer cela avant de publier votre application pour éviter les erreurs dans les analyses.
Utilisez reportTransaction pour envoyer les données de transaction à Adapty.
Warning
Ne sautez pas l’étape du reporting de transaction !
Si vous n’appelez pas reportTransaction, Adapty ne reconnaîtra pas la transaction, elle n’apparaîtra pas dans les analytics et ne sera pas envoyée aux intégrations.
Si vous utilisez les flows et paywalls Adapty, incluez withVariationId lors du reporting d’une transaction. Cela associe l’achat au flow ou au paywall qui l’a déclenché, ce qui garantit des analytics précises.
do {
// every time when calling transasction.finish()
try await Adapty.reportTransaction(transaction, withVariationId: <YOUR_PAYWALL_VARIATION_ID>)
} catch {
// handle the error
}
Paramètres :
| Paramètre | Présence | Description |
|---|
| transaction | requis | - Pour StoreKit 1 : SKPaymentTransaction.
- Pour StoreKit 2 : Transaction.
|
| variationId | optionnel | L’identifiant unique de la variante du paywall. Récupérez-le depuis la propriété variationId de l’objet AdaptyPaywall. |
Signalement des transactions
- Les versions jusqu’à 3.1.x écoutent automatiquement les transactions dans l’App Store, aucun signalement manuel n’est donc requis.
- La version 3.2 ne prend pas en charge le mode Observer.
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 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 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, faute de quoi cela entraînera des erreurs dans les analyses.
let variationId = paywall.variationId
// There are two overloads: for StoreKit 1 and StoreKit 2
Adapty.setVariationId(variationId, forPurchasedTransaction: transactionId) { error in
if error == nil {
// successful binding
}
}
Paramètres de la requête :
| Paramètre | Présence | Description |
|---|
| variationId | requis | L’identifiant de chaîne de la variante. Vous pouvez l’obtenir via la propriété variationId de l’objet AdaptyPaywall. |
| transactionId | requis | Pour StoreKit 1 : un objet SKPaymentTransaction. Pour StoreKit 2 : un objet Transaction. |