Pakiet SDK Google Analytics na Androida ułatwia deweloperom zbieranie danych o zaangażowaniu użytkowników pochodzących z aplikacji. Ten dokument zawiera omówienie wartości pakietu SDK oraz instrukcję rozpoczynania pomiaru aplikacji za pomocą pojedynczego identyfikatora usługi i narzędzia EasyTracker.
Wstęp
Pakiet SDK Google Analytics na Androida ułatwia deweloperom zbieranie danych o zaangażowaniu użytkowników z ich aplikacji. Za pomocą raportów Google Analytics deweloperzy mogą następnie mierzyć:
- Liczba aktywnych użytkowników korzystających z aplikacji.
- w których miejscach na świecie jest używana aplikacja;
- Przyjęcie i korzystanie z określonych funkcji.
- Zakupy i transakcje w aplikacji.
- Liczba i typ awarii aplikacji.
- I wiele innych przydatnych danych.
Dodatkowo pakiet SDK Google Analytics na Androida zapewnia narzędzia do monitorowania skuteczności kampanii marketingu mobilnego, zapewniając pełny wgląd w skuteczność kanałów marketingowych, od instalacji z Google Play po zakupy w aplikacji i transakcje.
Zanim zaczniesz
Zanim zaczniesz wdrażać pakiet SDK, upewnij się, że masz:
- Pakiet SDK dla programistów Androida (dostępny na systemy Windows, macOS X i Linux)
- Pakiet Google Analytics SDK na Androida w wersji 2 (z
libGoogleAnalyticsV2.jar
w katalogu/libs
projektu i ścieżce kompilacji) - Aplikacja na Androida, której możesz używać do implementacji pakietu SDK Google Analytics na Androida w wersji 2
- Nowy usługa aplikacji i widok (profil) Google Analytics.
Pierwsze kroki
Aby zacząć korzystać z pakietu SDK:
Po wykonaniu tych czynności będziesz w stanie mierzyć w Google Analytics:
- Instalacje aplikacji
- Aktywni użytkownicy i dane demograficzne
- Ekrany i zaangażowanie użytkowników
- Awarie i wyjątki
1. Aktualizuję plik AndroidManifest.xml
Zaktualizuj plik AndroidManifest.xml, dodając te uprawnienia:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. Dodawanie metod EasyTracker
Dodaj metody wysyłania do metod onStart()
i onStop()
każdego obiektu Activities
, jak w tym przykładzie:
/** * An example Activity in your app with Analytics * implemented. */ public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // The rest of your onStart() code. EasyTracker.getInstance().activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance().activityStop(this); // Add this method. } }
Pamiętaj, że funkcja EasyTracker wymaga metody Context
, aby można ją było wywołać. W podanym wyżej przykładzie ten wiersz:
EasyTracker.getInstance.activityStart(this);
która zajmuje się kontekstem. Jeśli jednak chcesz wywoływać EasyTracker w innych klasach lub metodach, musisz najpierw wywołać metodę setContext(Context ctx)
EasyTracker:
// Set Context before using EasyTracker. Note that the SDK will // use the application context. EasyTracker.getInstance().setContext(this); // EasyTracker is now ready for use.
3. Tworzenie pliku analytics.xml
W wersji 2 pakietu SDK Google Analytics na Androida opcje konfiguracji są zarządzane z poziomu pliku zasobów XML o nazwie analytics.xml
w tym przewodniku. Musisz utworzyć ten plik w katalogu res/values
swojego projektu i dodać identyfikator śledzenia. Z przykładu poniżej dowiesz się, jak dodać identyfikator śledzenia oraz włączyć pomiar Activity
i wyjątków:
<?xml version="1.0" encoding="utf-8" ?> <resources> <!--Replace placeholder ID with your tracking ID--> <string name="ga_trackingId">UA-XXXX-Y</string> <!--Enable automatic activity tracking--> <bool name="ga_autoActivityTracking">true</bool> <!--Enable automatic exception tracking--> <bool name="ga_reportUncaughtExceptions">true</bool> </resources>
Narzędzie do sprawdzania lint może ostrzec Cię przed użyciem myślnika w postaci myślnika („-”) w identyfikatorze śledzenia. Możesz je pominąć, dodając do tagu <resources>
dodatkowe atrybuty:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
Pełną listę parametrów, których możesz używać do konfigurowania implementacji, znajdziesz w dokumentacji parametrów w pliku analytics.xml.
Gratulacje! Aplikacja jest teraz skonfigurowana do wysyłania danych do Google Analytics.
Dalsze kroki
Google Analytics oferuje o wiele więcej możliwości, m.in. pomiary kampanii, płatności i transakcji w aplikacji oraz zdarzeń interakcji użytkowników. Z tych przewodników dla programistów dowiesz się, jak dodać te funkcje do swojej implementacji:
- Konfiguracja zaawansowana – dowiedz się więcej o zaawansowanych opcjach konfiguracji, w tym o korzystaniu z wielu skryptów śledzenia.
- Pomiary kampanii – dowiedz się, jak wdrożyć pomiary kampanii, by dowiedzieć się, które kanały i kampanie generują instalacje aplikacji.
- Pomiary zdarzeń – dowiedz się, jak mierzyć zaangażowanie użytkowników za pomocą interaktywnych treści, np. przycisków, filmów i innych elementów multimedialnych za pomocą Zdarzeń.
- Pomiary płatności w aplikacji – dowiedz się, jak mierzyć transakcje i płatności w aplikacji.
- Czas działania użytkownika – dowiedz się, jak mierzyć czas korzystania z aplikacji przez użytkownika, by mierzyć czas wczytywania, zaangażowanie w multimedia itp.
- Parametry w pliku analytics.xml – zobacz pełną listę parametrów konfiguracji
analytics.xml
.