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

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

Wenn Ihre aktuelle Analyselösung nicht aufgeführt ist oder Sie feststellen, dass sie 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 Ihrer App das Firebase SDK hinzu. Folgen Sie dazu der Anleitung im Startleitfaden für Google Analytics for Firebase.
2. Verwenden Sie die neueste Version des Plug-ins „google-services“.
3. Platzieren Sie die Datei google-services.json in jedem Modul.

4. Fügen Sie der Datei build.gradle jedes Moduls die folgende Zeile hinzu:

   Groovig

   // 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 zu 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 zum Einstieg in Google Analytics for Firebase.

Zwischen Daten der installierten App und der Instant App unterscheiden

Da sowohl die installierte als auch die Instant-App denselben Paketnamen haben, ist es vielleicht sinnvoll, die jeweils erfassten Ereignisse und Daten zu unterscheiden. Damit Sie in Analytics zwischen Ihren Instant- und installierten Apps unterscheiden können, legen Sie eine app_type-Nutzereigenschaft mit dem Wert „instant“ für die Instant App und „installed“ für die installierte App fest.

Das folgende Code-Snippet zeigt eine Aktivität, bei der eine Analytics-Instanz abgerufen und dann eine Nutzereigenschaft festgelegt wird. Der Code verwendet PackageManagerCompat.isInstantApp() in der Methode onCreate(android.os.Bundle), um den Kontext der Anwendung 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 in der Analytics-Konsole auf dem Tab Ereignisse ein Ereignis auswählen und dann nach dem Wert app_type filtern. Die resultierende Datenprojektion gibt die Anzahl der angegebenen Ereignisse in der Instant- oder installierten App an.

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

Interpretieren von Analytics-Ereignissen

Mit Analytics können Sie verschiedene Messwerte erfassen, die für eine Instant-App nützlich sind. In der folgenden Tabelle werden relevante Messwerte für Ihre Instant-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.