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 Google Play, 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 Android, l'SDK Analytics si integra con Google Play.

Nella maggior parte dei casi, l'SDK Analytics raccoglie automaticamente gli eventi IAP senza richiedere chiamate API nell'app. Di seguito sono riportate alcune opzioni aggiuntive per la raccolta degli eventi IAP:

  • Puoi registrare manualmente gli eventi di acquisto in-app direttamente dalla tua app, senza interagire con il Play Store.

  • Puoi anche registrare manualmente gli eventi di acquisto in-app in una WebView.

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 codebase dell'app come descritto in Inizia a utilizzare Google Analytics.

  • Collega il tuo progetto Firebase a una proprietà Google Analytics 4.

  • Assicurati di utilizzare l'SDK più recente:

    • Per il monitoraggio automatico degli acquisti in-app: assicurati che la tua app utilizzi l'SDK Analytics v17.3.0 o versioni successive (o Firebase Android BoM v25.2.0 o versioni successive).
    • Per il monitoraggio manuale degli acquisti in-app: assicurati che la tua app utilizzi l'SDK Analytics v23.2.0 o versioni successive (o Firebase Android BoM v34.10.0 o versioni successive)

  • Collega le tue app Firebase a Google Play.

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 Android, puoi misurare gli eventi di acquisto in-app non appena esegui il collegamento a Google Play.

Se devi monitorare gli acquisti in-app effettuati al di fuori del Play Store, puoi registrare gli eventi IAP manualmente utilizzando lo snippet di codice riportato di seguito o in una WebView.

Per monitorare manualmente gli acquisti in-app, assicurati di utilizzare l'SDK Analytics v23.2.0 o versioni successive (o Firebase Android BoM v34.10.0 o versioni successive).

Kotlin 

import android.os.Bundle
import com.google.firebase.analytics.FirebaseAnalytics

class MyClass(val analytics: FirebaseAnalytics) {

  ...

  fun logInAppPurchaseEvent(itemName: String, value: Double, currency: String) {
    val params = Bundle()
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName)
    params.putDouble(FirebaseAnalytics.Param.VALUE, value)
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency)
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params)
  }
}

Java 

import android.os.Bundle;
import com.google.firebase.analytics.FirebaseAnalytics;

public class MyClass {
  private FirebaseAnalytics analytics;

  ...

  public void logInAppPurchaseEvent(String itemName, Double value, String currency) {
    Bundle params = new Bundle();
    params.putString(FirebaseAnalytics.Param.ITEM_NAME, itemName);
    params.putDouble(FirebaseAnalytics.Param.VALUE, value);
    params.putString(FirebaseAnalytics.Param.CURRENCY, currency);
    analytics.logEvent(FirebaseAnalytics.Event.IN_APP_PURCHASE, params);
  }
}