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, a chcesz tylko sprawdzić, jak działa Analytics, zapoznaj się z naszą przykładową aplikacją.
Wymagane: najnowsze wersje:
Konfigurowanie projektu
Dodaj w projekcie plik AndroidManifest.xml
, 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 tę zależność do build.gradle
na poziomie projektu:
dependencies {
// ...
classpath 'com.google.gms:google-services:3.0.0'
}
Dodaj tę zależność od Usług Google Play do aplikacji app/build.gradle
:
dependencies {
// ...
compile 'com.google.android.gms:play-services-analytics:10.2.4'
}
Utwórz plik global_tracker.xml
Utwórz plik app/src/res/xml/global_tracker.xml
o tej zawartoś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}
swoim identyfikatorem śledzenia.
Dodaj śledzenie ekranu
Dzięki temu będziesz wysyłać do Analytics nazwany widok ekranu za każdym razem, gdy użytkownik otworzy lub zmieni ekran w Twojej aplikacji. Twój kod powinien:
- Udostępnij udostępniony tracker za pomocą podklasy aplikacji.
- Zastąp metodę wywołania zwrotnego dla aktywności na pierwszym planie.
- Podaj nazwę ekranu i wykonaj śledzenie.
Aplikacja
Należy podklasę Application
i udostępnić metodę pomocniczą, która zwraca moduł śledzenia Twojej aplikacji.</>
/*
* 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ć element Fragment
, ale upewnij się, że prawidłowo odzwierciedla ono wyświetlenie ekranu.
Zastąp metodę onCreate
Activity
lub Fragment
, które chcesz śledzić, aby uzyskać udostępnione wystąpienie Tracker
:
// Obtain the shared Tracker instance.
AnalyticsApplication application = (AnalyticsApplication) getApplication();
mTracker = application.getDefaultTracker();
Zastąp odpowiednią metodę, taką jak onResume
, w przypadku metody Activity
lub onPageSelected
w przypadku logu ViewPager
, gdy nastąpi zmiana ekranu.
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
reprezentującego ekran. Pamiętaj, aby określić nazwę w co najmniej Activity
lub Fragment
, jeśli chcesz odróżniać w Analytics wyświetlenia ekranu aplikacji. Cała aktywność zarejestrowana w udostępnianym trackerze wysyła najnowszą nazwę ekranu, dopóki nie zostanie zastąpiona lub wyczyszczona (ustawiona na null
).
Wyślij wydarzenie
Aby wysłać zdarzenie, ustaw wartości pól ekranu na trackerze, a następnie wyślij działanie.
W tym przykładzie użyto 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 uzyskiwać odpowiedzi na pytania dotyczące korzystania z aplikacji.
Sprawdź dodatkowe opcje konfiguracji, np. próbkowanie, testowanie i debugowanie, ustawienia rezygnacji itp.
Jeśli aplikacja musi zbierać identyfikatory wyświetlania reklam, włącz w niej funkcje reklamowe.