Dodaj Google Analytics dla Firebase do swojej aplikacji błyskawicznej

Dla każdego dewelopera ważne jest śledzenie wyników aplikacji, zarówno tych błyskawicznych, jak i zainstalowanych. Kilka bibliotek analityki jest zgodnych z usługą błyskawiczną w Google Play, np. FabricReplies, Localytics i Mixpanel.

Jeśli obecnie nie ma na liście lub uważasz, że nie działa ono z usługą błyskawiczną w Google Play, rozważ użycie Google Analytics dla Firebase jako rozwiązania telemetrycznego. Na tej stronie opisujemy, jak skonfigurować Google Analytics dla Firebase w projekcie aplikacji błyskawicznej.

Dodawanie Google Analytics dla Firebase do projektu aplikacji błyskawicznej

1. Dodaj do aplikacji pakiet SDK Firebase, wykonując instrukcje opisane we wprowadzeniu do Google Analytics dla Firebase.
2. Użyj najnowszej wersji wtyczki google-services.
3. Umieść plik google-services.json w każdym module.

4. Dodaj ten wiersz do pliku build.gradle każdego modułu:

   Odlotowy

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

   Kotlin

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

Po dodaniu Google Analytics dla Firebase do projektu aplikacji błyskawicznej możesz używać interfejsów API Google Analytics dla Firebase tak jak w projekcie aplikacji z możliwością zainstalowania.

Więcej informacji o korzystaniu z interfejsów API Google Analytics dla Firebase znajdziesz w dokumentacji dla początkujących użytkowników Google Analytics dla Firebase.

Odróżnianie danych zainstalowanych od aplikacji błyskawicznych

Zarówno aplikacja zainstalowana, jak i błyskawiczna ma taką samą nazwę pakietu, dlatego warto rozróżnić zdarzenia i dane zbierane z każdego z nich. Aby odróżnić w Analytics aplikacje błyskawiczne i zainstalowane, ustaw właściwość użytkownika app_type z wartością „błyskawiczna” w przypadku aplikacji błyskawicznej i „zainstalowaną” dla aplikacji instalowanej.

Ten fragment kodu pokazuje działanie, które pozyskuje wystąpienie Analytics, a następnie ustawia właściwość użytkownika. Zwróć uwagę, że do określenia kontekstu aplikacji używany jest kod PackageManagerCompat.isInstantApp() w metodzie onCreate(android.os.Bundle).

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);
    }

}

Po ustawieniu właściwości użytkownika app_type możesz wybrać zdarzenie na karcie Zdarzenia w konsoli Analytics, a potem filtrować je według wartości app_type. Wynikowe przewidywanie danych daje liczbę określonych zdarzeń w aplikacji błyskawicznej lub zainstalowanej.

Więcej informacji o rejestrowaniu i wyświetlaniu zdarzeń w Google Analytics dla Firebase znajdziesz w artykule Rejestrowanie zdarzeń.

Interpretowanie zdarzeń Analytics

Analytics umożliwia śledzenie różnych wskaźników istotnych dla aplikacji błyskawicznej. W tabeli poniżej znajdziesz informacje o odpowiednich danych związanych z aplikacją błyskawiczną, w tym odpowiadające im nazwy zdarzeń lub odpowiednie właściwości w Analytics.

Więcej informacji o stałych zdarzeń, które możesz gromadzić w Analytics, znajdziesz w artykule FirebaseAnalytics.Event.