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

Dodawanie Analytics do aplikacji na Androida

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

Z tego przewodnika dowiesz się, jak dodać Analytics do aplikacji na Androida, aby mierzyć aktywność użytkowników na nazwanych ekranach. Jeśli nie masz jeszcze aplikacji, ale chcesz sprawdzić, jak działa Analytics, zapoznaj się z przykładową aplikacją.

Wymagane: najnowsze wersje:

Konfigurowanie projektu

Zaktualizuj plik AndroidManifest.xml w projekcie, aby zawierał uprawnienia INTERNET i ACCESS_NETWORK_STATE:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.example.analytics">

  <uses-permission android:name="android.permission.INTERNET"/>
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

  <application android:name="AnalyticsApplication">
    ...
  </application>
</manifest>

Dodaj do zależności build.gradle na poziomie projektu tę zależność:

dependencies {
  // ...
  classpath 'com.google.gms:google-services:3.0.0'
}

Dodaj do app/build.gradle tę zależność od Usług Google Play:

dependencies {
  // ...
  compile 'com.google.android.gms:play-services-analytics:10.2.4'
}

Tworzenie pliku global_tracker.xml

Utwórz plik app/src/res/xml/global_tracker.xml z następującą treścią:

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string name="ga_trackingId" translatable="false">${YOUR_TRACKING_ID}</string>
</resources>

Zastąp ${YOUR_TRACKING_ID} identyfikatorem śledzenia.

Dodaj śledzenie ekranu

Tutaj będziesz wysyłać do Analytics widok ekranu z nazwą za każdym razem, gdy użytkownik otworzy lub zmieni ekran w Twojej aplikacji. Twój kod powinien wykonać te czynności:

  • Udostępnij udostępniany moduł śledzenia za pomocą podklasy aplikacji.
  • Zastąp metodę wywołania zwrotnego dla działania na pierwszym planie.
  • Podaj nazwę ekranu i wykonaj śledzenie.

Aplikacja

Należy klasyfikować Application i podać metodę zastępczą, która zwraca aplikację.<lt;/>

/*
 * Copyright Google Inc. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.samples.quickstart.analytics;

import android.app.Application;

import com.google.android.gms.analytics.GoogleAnalytics;
import com.google.android.gms.analytics.Tracker;

/**
 * This is a subclass of {@link Application} used to provide shared objects for this app, such as
 * the {@link Tracker}.
 */
public class AnalyticsApplication extends Application {

  private static GoogleAnalytics sAnalytics;
  private static Tracker sTracker;

  @Override
  public void onCreate() {
    super.onCreate();

    sAnalytics = GoogleAnalytics.getInstance(this);
  }

  /**
   * Gets the default {@link Tracker} for this {@link Application}.
   * @return tracker
   */
  synchronized public Tracker getDefaultTracker() {
    // To enable debug logging use: adb shell setprop log.tag.GAv4 DEBUG
    if (sTracker == null) {
      sTracker = sAnalytics.newTracker(R.xml.global_tracker);
    }

    return sTracker;
  }
}

Aktywność lub fragment

Otwórz aktywność, którą chcesz śledzić. Możesz też śledzić zdarzenie Fragment, ale sprawdzić, czy jest ono prawidłowo wyświetlane.

Zastąp metodę onCreate elementu Activity lub Fragment, który chcesz śledzić, aby uzyskać współdzieloną instancję Tracker:

// Obtain the shared Tracker instance.
AnalyticsApplication application = (AnalyticsApplication) getApplication();
mTracker = application.getDefaultTracker();

Zastąp odpowiednią metodę, np. onResume w przypadku Activity lub onPageSelected, jeśli ViewPager ma być rejestrowany, gdy ekran się zmieni.

Log.i(TAG, "Setting screen name: " + name);
mTracker.setScreenName("Image~" + name);
mTracker.send(new HitBuilders.ScreenViewBuilder().build());

Dodaj kod śledzenia do każdego elementu Activity lub Fragment, który reprezentuje ekran. Jeśli chcesz rozróżnić widoki ekranu w aplikacji w Analytics, ustaw nazwę we właściwości Activity lub Fragment. Cała aktywność zarejestrowana na współdzielonym trackerze wysyła najnowszą nazwę ekranu do czasu zastąpienia lub wyczyszczenia (ustawionego jako null).

Wysyłanie wydarzenia

Aby wysłać zdarzenie, ustaw wartości pól na ekranie trackera, a następnie wyślij działanie. Ten przykładowy kod wykorzystuje HitBuilders.EventBuilder do wysłania Event:

mTracker.send(new HitBuilders.EventBuilder()
    .setCategory("Action")
    .setAction("Share")
    .build());

Dalsze kroki

  • Przeczytaj Przewodnik po implementacji aplikacji mobilnych, aby dowiedzieć się, jak za pomocą Google Analytics mierzyć interakcje użytkowników i odpowiadać na pytania dotyczące korzystania z aplikacji.

  • Sprawdź dodatkowe opcje konfiguracji, takie jak próbkowanie, testowanie i debugowanie, ustawienia rezygnacji itp.

  • Jeśli aplikacja musi zbierać identyfikatory wyświetlania reklam, włącz w niej funkcje reklamowe.