Dodaj Google Analytics dla Firebase do swojej aplikacji błyskawicznej

Śledzenie skuteczności aplikacji (błyskawicznej lub zainstalowanej) jest ważne dla każdego dewelopera. Z Aplikacjami błyskawicznymi w Google Play jest zgodnych kilka bibliotek analitycznych, m.in. Fabric Answers, Localytics, i Mixpanel.

Jeśli Twoje obecne rozwiązanie analityczne nie jest wymienione lub stwierdzisz, że nie działa z Aplikacjami błyskawicznymi w Google Play, rozważ użycie Google Analytics dla Firebase jako rozwiązania do telemetrii. Na tej stronie dowiesz się, jak skonfigurować Google Analytics dla Firebase w projekcie aplikacji błyskawicznej.

Dodawanie Google Analytics dla Firebase do projektu aplikacji błyskawicznej

1. Dodaj pakiet SDK Firebase do swojej aplikacji, postępując zgodnie z instrukcjami opisanymi w przewodniku dla początkujących dotyczącym 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:

   Dynamiczny

   // 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 instalowanej.

Więcej informacji o korzystaniu z interfejsów API Google Analytics dla Firebase znajdziesz w dokumencie dla początkujących dotyczącym Google Analytics dla Firebase.

Rozróżnianie danych aplikacji zainstalowanej i błyskawicznej

Ponieważ aplikacja zainstalowana i błyskawiczna mają tę samą nazwę pakietu, możesz chcieć rozróżniać zdarzenia i dane zbierane z każdej z nich. Aby odróżnić aplikację błyskawiczną od zainstalowanej w Analytics, ustaw właściwość użytkownika app_type z wartością „instant” w przypadku aplikacji błyskawicznej i „installed” w przypadku aplikacji zainstalowanej.

Ten fragment kodu pokazuje aktywność, która pobiera instancję Analytics, a następnie ustawia właściwość użytkownika. Zwróć uwagę, że kod używa PackageManagerCompat.isInstantApp() w metodzie onCreate(android.os.Bundle) , aby określić kontekst aplikacji.

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 następnie odfiltrować je według wartości app_type. Wynikowa projekcja danych zawiera liczbę określonego zdarzenia w aplikacji błyskawicznej lub aplikacji instalowanej.

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

Interpretowanie zdarzeń Analytics

Analytics umożliwia śledzenie różnych danych, które są cenne dla aplikacji błyskawicznej. W tabeli poniżej znajdziesz opis odpowiednich danych aplikacji błyskawicznej, w tym nazw zdarzeń lub właściwości w Analytics.

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