W tym dokumencie opisujemy starszą wersję pakietu Android SDK. Jeśli dopiero zaczynasz korzystać z usługi Analytics, użyj najnowszego pakietu SDK. Więcej informacji

Google Analytics SDK na Androida (wersja 3) – pierwsze kroki

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

W tym artykule znajdziesz informacje o tym, jak zacząć korzystać z pakietu SDK Google Analytics na Androida w wersji 3.

Zanim zaczniesz

Przed zaimplementowaniem pakietu SDK przygotuj te elementy:

Pierwsze kroki

Aby zacząć korzystać z pakietu SDK, musisz wykonać 3 kroki:

  1. Zaktualizuj plik AndroidManifest.xml
  2. Dodaj metody EasyTracker
  3. Utwórz plik analytics.xml

Po wykonaniu tych czynności w Google Analytics będzie można mierzyć:

  • Instalacje aplikacji
  • Aktywni użytkownicy i dane demograficzne
  • Ekrany i zaangażowanie użytkowników
  • Awarie i wyjątki

1. Aktualizowanie pliku 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żdej z Activities, jak w tym przykładzie:

package com.example.app;

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;

/**
 * An example Activity using Google Analytics and EasyTracker.
 */
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(this).activityStart(this);  // Add this method.
  }

  @Override
  public void onStop() {
    super.onStop();
    ... // The rest of your onStop() code.
    EasyTracker.getInstance(this).activityStop(this);  // Add this method.
  }
}

3. Tworzenie pliku analytics.xml

Gdy korzystasz z narzędzia EasyTracker, globalnymi ustawieniami konfiguracji zarządza się za pomocą zasobów zdefiniowanych w formacie XML. Utwórz plik o nazwie analytics.xml w katalogu res/values projektu i dodaj te zasoby:

<?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 linów może ostrzegać o zastosowaniu w identyfikatorze śledzenia myślnika ('-'). Możesz pominąć to ostrzeżenie, 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żyć do skonfigurowania implementacji, znajdziesz w dokumentacji parametrów analytics.xml. W zależności od wymagań Twojej aplikacji możesz zmienić okres wysyłania, aby sprawdzić, czy prawidłowo wysyłasz działania. Jeśli na przykład chcesz zobaczyć dane w czasie rzeczywistym, ustaw tę wartość na niską wartość, taką jak 5 s.

Gratulacje! Twoja aplikacja została skonfigurowana do wysyłania danych do Google Analytics.

Dalsze kroki

Google Analytics zapewnia wiele więcej możliwości, m.in. pomiar kampanii, płatności i transakcji w aplikacji oraz zdarzeń interakcji z użytkownikiem.

Dodatkowe wskazówki na temat implementacji funkcji Google Analytics w aplikacji znajdziesz w tych przewodnikach dla programistów:

  • Pomiar zdarzeń – dowiedz się, jak mierzyć zaangażowanie użytkowników za pomocą interaktywnych treści, takich jak przyciski, filmy i inne multimedia za pomocą zdarzeń.
  • Pomiar płatności w aplikacji – dowiedz się, jak mierzyć płatności i transakcje w aplikacji.
  • Pomiary kampanii – dowiedz się, jak wdrożyć pomiary kampanii, aby dowiedzieć się, które kanały i kampanie zwiększają liczbę instalacji aplikacji.
  • Czas działań użytkownika – dowiedz się, jak mierzyć czas wczytywania w aplikacji, aby mierzyć czas wczytywania, zaangażowanie użytkowników w mediach i inne.
  • Konfiguracja zaawansowana – dowiedz się więcej o zaawansowanych opcjach konfiguracji, w tym o korzystaniu z wielu trackerów.
  • Parametry Analytics.xml – zobacz pełną listę parametrów konfiguracyjnych analytics.xml.