Misurare gli acquisti in-app

Seleziona la piattaforma: iOS+ Android Unity


Gli acquisti in-app (IAP) sono contenuti o funzionalità digitali che puoi vendere in un'app mobile tramite l'Apple App Store, in modo che la tua app 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 piattaforme 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. Su iOS, puoi anche registrare manualmente gli eventi IAP in una WebView, oltre agli eventi IAP raccolti automaticamente. 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

Implementazione

Nella maggior parte dei casi, l'SDK Analytics registra automaticamente gli eventi di acquisto in-app senza richiedere codice aggiuntivo.

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

In alternativa, se hai bisogno di 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, se possibile, e non deduplicherà gli eventi di acquisto in-app 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 di acquisto in-app.

Se utilizzi StoreKit 2, utilizza il seguente codice per registrare gli eventi di acquisto in-app.

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 di acquisto in-app.

StoreKit 2 è solo per Swift, pertanto l'implementazione di Objective-C non è supportata.