Gli acquisti in-app (IAP) sono contenuti o funzionalità digitali che puoi vendere in un'app mobile tramite Google Play o l'App Store di Apple in modo che la tua app non debba elaborare transazioni finanziarie. Esempi di acquisti in-app includono contenuti basati su abbonamento o pezzi di gioco speciali.
Analytics mostra gli eventi IAP nel rapporto sugli acquisti in-app .
Per le app Android, l'SDK di Analytics si integra con Google Play. Per le app della piattaforma Apple, l'SDK si integra con l'App Store di Apple utilizzando le API StoreKit 1 e StoreKit 2 di Apple.
Nella maggior parte dei casi, l'SDK di Analytics raccoglie automaticamente gli eventi IAP senza richiedere chiamate API nella tua app. Questa guida spiega come impostare il tuo progetto per il tracciamento automatico e descrive alcuni casi speciali che richiedono poche righe di codice per essere implementati.
Prima di iniziare
Configura il tuo progetto Firebase e la codebase della tua app come descritto in Introduzione a Google Analytics .
Collega il tuo progetto Firebase a una proprietà Google Analytics 4.
Per le app della piattaforma Apple:
- Assicurati che la tua app utilizzi Analytics SDK v6.20.0+.
Per le app Android:
- Assicurati che la tua app utilizzi Analytics SDK v17.3.0+ (o Firebase Android BoM v25.2.0+).
- Collega le tue app Firebase a Google Play .
Se stai sviluppando un'app Android, puoi misurare gli eventi IAP non appena ti colleghi a Google Play. Il resto di questa guida è incentrato sulle app della piattaforma Apple.
Se sei uno sviluppatore Apple, assicurati di avere familiarità con le API per gli acquisti in-app Apple StoreKit 1 e StoreKit 2 esaminando la documentazione Apple .
Implementazione
Veloce
Se utilizzi StoreKit 1, Analytics SDK registra automaticamente gli eventi IAP.
Se utilizzi StoreKit 2, utilizza il codice seguente 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()
...
}
Obiettivo-C
Se utilizzi StoreKit 1, Analytics SDK registra automaticamente gli eventi IAP.
StoreKit 2 è solo Swift, quindi un'implementazione Objective-C non è supportata.
Kotlin+KTX
Per registrare gli eventi IAP, collegarsi a Google Play .
Java
Per registrare gli eventi IAP, collegarsi a Google Play .