Google Analytics SDK na Androida v2 (starsza wersja) – omówienie

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:

Pierwsze kroki

Aby zacząć korzystać z pakietu SDK:

  1. Zaktualizuj plik AndroidManifest.xml
  2. Dodaj metody EasyTracker
  3. Tworzenie pliku analytics.xml

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.