Gli acquisti in-app (IAP) sono contenuti o funzionalità digitali che puoi vendere in un'app per dispositivi mobili tramite Google Play o l'Apple App Store, in modo che questa non debba elaborare transazioni finanziarie. Esempi di acquisti in-app includono contenuti basati su abbonamento o elementi di gioco speciali.
Analytics mostra gli eventi IAP nel report Acquisti in-app.
Per le app per Android, l'SDK Analytics si integra con Google Play. Per le app per la piattaforma Apple, l'SDK si integra con l'Apple App Store utilizzando le API StoreKit 1 e StoreKit 2 di Apple.
Nella maggior parte dei casi, l'SDK Analytics raccoglie automaticamente gli eventi IAP senza richiedere chiamate API nell'app. Questa guida spiega come configurare il progetto per il monitoraggio automatico e descrive alcuni casi speciali che richiedono l'implementazione di alcune righe di codice.
Prima di iniziare
Configura il progetto Firebase e il codice base della tua app come descritto in Introduzione a Google Analytics.
Collega il tuo progetto Firebase a una proprietà Google Analytics 4.
Per le app per la piattaforma Apple:
- Assicurati che la tua app utilizzi l'SDK Analytics 6.20.0 o versioni successive.
Per le app per Android:
- Assicurati che la tua app utilizzi l'SDK Analytics v17.3.0 e versioni successive (o Firebase Android BoM v25.2.0 e versioni successive).
- Collega le tue app Firebase a Google Play.
Se stai sviluppando un'app per Android, puoi misurare gli eventi IAP non appena effettui il collegamento a Google Play. Il resto di questa guida è incentrato sulle app per la piattaforma Apple.
Se sei uno sviluppatore Apple, assicurati di conoscere le API di acquisto in-app Apple StoreKit 1 e StoreKit 2 consultando la documentazione Apple.
Implementazione
Swift
Se utilizzi StoreKit 1, l'SDK Analytics registra automaticamente gli eventi IAP.
Se utilizzi StoreKit 2, utilizza il seguente codice per registrare gli eventi IAP.
import StoreKit import FirebaseAnalytics // A user tapped a button to purchase an item. func userTappedPurchaseUpgradeButton() { let product = ... purchaseSomeProduct(product) } func purchaseSomeProduct(_ product: Product) { // Purchase a Product. This is mostly standard boilerplate StoreKit 2 // code, except for the Analytics.logTransaction() call. let result = try await product.purchase() switch result { case .success(let verification): let transaction = try checkVerified(verification) // Call this Firebase API to log the in-app purchase event. Analytics.logTransaction(transaction) await transaction.finish() ... }
Objective-C
Se utilizzi StoreKit 1, l'SDK Analytics registra automaticamente gli eventi IAP.
StoreKit 2 è solo per Swift, pertanto un'implementazione in Objective-C non è supportata.
Kotlin+KTX
Per registrare gli eventi IAP, esegui il collegamento a Google Play.
Java
Per registrare gli eventi IAP, esegui il collegamento a Google Play.