Misurare gli acquisti in-app

Seleziona piattaforma: iOS+ Android Unity


Gli acquisti in-app (IAP) sono contenuti o funzionalità digitali che puoi vendere in un' app per dispositivi mobili tramite Google Play in modo che questa non debba elaborare transazioni finanziarie. Tra gli acquisti in-app figurano, ad esempio, contenuti su abbonamento o elementi di gioco speciali.

Analytics mostra gli eventi IAP nel report Acquisti in-app.

Per le app Android, l'Analytics SDK si integra con Google Play.

Nella maggior parte dei casi, l'Analytics SDK raccoglie automaticamente gli eventi IAP senza richiedere chiamate API nella tua app. Inoltre, ecco 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 IAP 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 la codebase dell'app come descritto in Guida introduttiva a Google Analytics.

  • Collega il 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 stia utilizzando l'Analytics v17.3.0 e versioni successive (o la Firebase Android BoM v25.2.0 e versioni successive).
    • Per il monitoraggio manuale degli acquisti in-app: assicurati che la tua app utilizzi l'SDK Analytics v23.2.0 e versioni successive (o Firebase Android BoM v34.10.0 e versioni successive).

  • Collega le app Firebase a Google Play.

Implementazione

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

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

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

Per monitorare manualmente gli acquisti in-app, assicurati di utilizzare Analytics SDK v23.2.0 e versioni successive (o Firebase Android BoM v34.10.0 e 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);
  }
}