Google Analytics für Firebase Ihrer Instant-App hinzufügen

Für jeden Entwickler ist es wichtig, den Erfolg einer App, Instant App oder installierten App zu verfolgen. Mehrere Analysebibliotheken sind mit Google Play Instant kompatibel, darunter Fabric Answers, Localytics und Mixpanel.

Wenn Ihre aktuelle Analyselösung nicht aufgeführt ist oder nicht mit Google Play Instant funktioniert, sollten Sie Google Analytics for Firebase als Telemetrielösung verwenden. Auf dieser Seite wird beschrieben, wie Sie Google Analytics for Firebase in einem Instant-App-Projekt einrichten.

Google Analytics for Firebase einem Instant-App-Projekt hinzufügen

1. Fügen Sie das Firebase SDK Ihrer App hinzu. Folgen Sie dazu der Anleitung im Startleitfaden für Google Analytics for Firebase.
2. Verwenden Sie die aktuelle Version des google-services-Plug-ins.
3. Platzieren Sie die google-services.json-Datei in jedem Modul.

4. Fügen Sie die folgende Zeile in die build.gradle-Datei jedes Moduls ein:

   Groovy

   // android { ... }
   // dependencies { ... }
   plugins {
       id 'com.google.gms.google-services'
   }

   Kotlin

   // android { ... }
   // dependencies { ... }
   plugins {
       id("com.google.gms.google-services")
   }

Nachdem Sie Google Analytics for Firebase Ihrem Instant-App-Projekt hinzugefügt haben, können Sie die Google Analytics for Firebase-APIs wie in einem installierbaren App-Projekt verwenden.

Weitere Informationen zur Verwendung der Google Analytics for Firebase APIs finden Sie in der Dokumentation zu den ersten Schritten mit Google Analytics for Firebase.

Zwischen Daten zu installierten Apps und Instant Apps unterscheiden

Da sowohl Ihre installierte App als auch Ihre Instant App denselben Paketnamen haben, sollten Sie die Ereignisse und Daten, die von den einzelnen Apps erfasst werden, unterscheiden. Wenn Sie zwischen Ihren Instant-Apps und installierten Apps in Analytics unterscheiden möchten, legen Sie eine app_type-Nutzereigenschaft fest. Verwenden Sie den Wert „instant“ für die Instant-App und „installed“ für die installierte App.

Das folgende Code-Snippet zeigt eine Aktivität, die eine Analytics-Instanz abruft und dann eine Nutzer-Property festlegt. Im Code wird PackageManagerCompat.isInstantApp() in der Methode onCreate(android.os.Bundle) verwendet, um den Kontext der App zu ermitteln.

val STATUS_INSTALLED = "installed"
val STATUS_INSTANT = "instant"
val ANALYTICS_USER_PROP = "app_type"

private lateinit var firebaseAnalytics: FirebaseAnalytics

protected fun onCreate(savedInstanceState: Bundle?) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)
    }
}

final String STATUS_INSTALLED = "installed";
final String STATUS_INSTANT = "instant";
final String ANALYTICS_USER_PROP = "app_type";

private FirebaseAnalytics firebaseAnalytics;

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this);

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);
    }

}

Nachdem Sie die Nutzereigenschaft app_type festgelegt haben, können Sie auf dem Tab Ereignisse in der Analytics-Konsole ein Ereignis auswählen und dann nach dem Wert app_type filtern. Die resultierende Datenprognose liefert eine Anzahl für das angegebene Ereignis in Ihrer Instant-App oder installierten App.

Weitere Informationen zum Protokollieren und Ansehen von Ereignissen in Google Analytics for Firebase finden Sie unter Ereignisse protokollieren.

Analytics-Ereignisse interpretieren

In Analytics können Sie eine Vielzahl von Messwerten erfassen, die für eine Sofort-App wichtig sind. In der folgenden Tabelle werden relevante Messwerte für Ihre Sofort-App beschrieben, einschließlich des entsprechenden Ereignisnamens oder der entsprechenden Property in Analytics.

Weitere Informationen zu den Konstanten für Ereignisse, die Sie in Analytics erfassen können, finden Sie unter FirebaseAnalytics.Event.