Dodaj Google Analytics dla Firebase do swojej aplikacji błyskawicznej

Ostrzeżenie: aplikacja błyskawiczna w Google Play nie będzie już dostępna. Od grudnia 2025 r. nie będzie można publikować aplikacji błyskawicznych w Google Play, a wszystkie interfejsy Instant API Usług Google Play przestaną działać. Użytkownicy nie będą już otrzymywać aplikacji błyskawicznych z Google Play za pomocą żadnego mechanizmu.

Wprowadzamy tę zmianę na podstawie opinii deweloperów i naszych ciągłych inwestycji w ulepszanie ekosystemu od czasu wprowadzenia aplikacji błyskawicznych w Google Play.

Aby nadal optymalizować wzrost liczby użytkowników, zachęcamy deweloperów do kierowania użytkowników do standardowej aplikacji lub gry za pomocą precyzyjnych linków, które w razie potrzeby przekierowują ich do określonych ścieżek lub funkcji.

Śledzenie skuteczności aplikacji (błyskawicznej lub zainstalowanej) jest ważne dla każdego dewelopera. Z Google Play Instant jest zgodnych kilka bibliotek analitycznych, w tym Fabric Answers, LocalyticsMixpanel.

Jeśli Twojego obecnego rozwiązania analitycznego nie ma na liście lub jeśli okaże się, że nie działa ono z Google Play Instant, rozważ użycie Google Analytics dla Firebase jako rozwiązania telemetrycznego. Na tej stronie znajdziesz informacje o konfigurowaniu Google Analytics dla Firebase w projekcie aplikacji błyskawicznej.

Dodawanie Google Analytics dla Firebase do projektu aplikacji natychmiastowej

  1. Dodaj do aplikacji pakiet SDK Firebase, postępując zgodnie z instrukcjami podanymi w przewodniku dla początkujących dotyczącym Google Analytics dla Firebase.
  2. Użyj najnowszej wersji wtyczki google-services.
  3. Umieść google-services.json w każdym module.
  4. Dodaj do pliku build.gradle każdego modułu ten wiersz:

    Groovy

    // 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 natychmiastowej możesz korzystać z interfejsów API Google Analytics dla Firebase tak samo jak w projekcie aplikacji instalowanej.

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

Rozróżnianie danych aplikacji zainstalowanych i błyskawicznych

Zarówno zainstalowana, jak i błyskawiczna wersja aplikacji mają tę samą nazwę pakietu, dlatego możesz chcieć rozróżniać zdarzenia i dane zbierane z każdej z nich. Aby odróżnić aplikacje natychmiastowe od zainstalowanych w Analytics, ustaw app_type usługę użytkownika z wartością „instant” w przypadku aplikacji natychmiastowej 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.

Kotlin

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

Java

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 prognoza danych podaje liczbę wystąpień określonego zdarzenia 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 danych, które są przydatne w przypadku aplikacji natychmiastowej. W tabeli poniżej znajdziesz opis odpowiednich danych dotyczących aplikacji natychmiastowej, w tym nazwę zdarzenia lub właściwości w Analytics.

Nazwa Wartość w Analytics Definicja
Wizyty session_start Sesja rozpoczęta. To zdarzenie jest śledzone automatycznie.
Zakupy produktów fizycznych Firebase.Event.ECOMMERCE_PURCHASE zakupy fizyczne, Musisz wyraźnie śledzić to zdarzenie w kodzie.
Zakupy cyfrowe in_app_purchase zakupy cyfrowe w aplikacji, To zdarzenie jest śledzone automatycznie.
Czas spędzony w aplikacji user_engagement Czas, przez jaki aplikacja działa na pierwszym planie. To zdarzenie jest śledzone automatycznie.
Kontekst aplikacji błyskawicznej app_type Zdarzenia wywoływane przez aplikację działającą w kontekście aplikacji natychmiastowej lub zainstalowanej. Musisz wyraźnie śledzić to zdarzenie w kodzie. Więcej informacji znajdziesz w sekcji Różnice między danymi o zainstalowanych aplikacjach a danymi o aplikacjach błyskawicznych powyżej.
Powracający użytkownicy session_start.countapp_type Grupa odbiorców składająca się z użytkowników, którzy odwiedzają witrynę co najmniej 2 razy. Musisz wyraźnie śledzić zdarzenie app_type, a zdarzenie session_start jest śledzone za Ciebie. Zobacz Rozróżnianie danych dotyczących zainstalowanych aplikacji i aplikacji błyskawicznych powyżej.

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