Questa pagina è stata tradotta dall'API Cloud Translation.

Misurare gli acquisti in-app

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 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 della 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 in-app purchase senza richiedere chiamate API nella tua app. Su iOS, puoi anche registrare manualmente gli eventi in-app purchase in una WebView oltre agli eventi in-app purchase raccolti automaticamente. Questa guida spiega come configurare il progetto per il monitoraggio automatico e descrive alcuni casi speciali che richiedono l'implementazione di poche righe di codice.

Prima di iniziare

Configura il progetto Firebase e il codebase della tua app come descritto in Guida introduttiva a Google Analytics.
Collega il tuo progetto Firebase a una proprietà Google Analytics 4.

App Android

Assicurati che la tua app utilizzi l'SDK Analytics v17.3.0+ (o Firebase Android BoM v25.2.0+).
Collega le tue app Firebase a Google Play.

Nota :per le app per Android, puoi misurare gli eventi IAP non appena esegui il collegamento a Google Play. Il resto di questa guida è incentrato sulle app per la piattaforma Apple.

App delle piattaforme Apple

Assicurati di utilizzare l'SDK più recente:
- Per il monitoraggio automatico degli acquisti in-app: assicurati che la tua app utilizzi l'SDK Analytics v6.20.0 o versioni successive.
- Per il monitoraggio manuale degli acquisti in-app: assicurati che la tua app utilizzi l'SDK Analytics v12.5.0 o versioni successive.
Assicurati di conoscere le API per gli acquisti in-app StoreKit 1 e StoreKit 2 di Apple consultando la documentazione di Apple.

Implementazione

Nella maggior parte dei casi, l'SDK Analytics registra automaticamente gli eventi IAP senza richiedere codice aggiuntivo.

Implementazione nelle app per Android

Per le app per Android, puoi misurare gli eventi IAP non appena colleghi Google Play.

Implementazione nelle app della piattaforma Apple

Per le app per iOS, se utilizzi StoreKit 1, l'SDK Analytics registra automaticamente gli eventi in-app purchase. Se utilizzi StoreKit 2, puoi registrare eventi di acquisto in-app verificati utilizzando lo snippet di codice riportato di seguito.

In alternativa, se devi monitorare gli acquisti in-app effettuati al di fuori dell'App Store, puoi registrare manualmente gli eventi IAP in una WebView. Tieni presente che l'SDK continuerà a registrare automaticamente gli acquisti in-app ove possibile e non deduplicherà gli eventi in_app_purchase registrati manualmente. Assicurati di utilizzare l'SDK Analytics v12.5.0 o versioni successive quando monitori manualmente gli acquisti in-app.

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