במדריך הזה מוסבר איך להוסיף את Analytics לאפליקציה ל-Android כדי למדוד את פעילות המשתמשים למסכים עם שם. אם עדיין אין לכם אפליקציה ואתם רוצים לראות איך Analytics פועל, אתם מוזמנים לעיין באפליקציה לדוגמה שלנו.
חובה: הגרסאות האחרונות של:
הגדרת הפרויקט
מעדכנים את הקובץ AndroidManifest.xml
של הפרויקט כך שיכלול את ההרשאות INTERNET
ו-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>
מוסיפים את התלות הבאה ל-build.gradle
ברמת הפרויקט:
dependencies {
// ...
classpath 'com.google.gms:google-services:3.0.0'
}
צריך להוסיף ל-app/build.gradle
את התלות הבאה ב-Google Play Services:
dependencies {
// ...
compile 'com.google.android.gms:play-services-analytics:10.2.4'
}
יצירת global_tracker.xml
יוצרים את הקובץ app/src/res/xml/global_tracker.xml
עם התוכן הבא:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="ga_trackingId" translatable="false">${YOUR_TRACKING_ID}</string>
</resources>
מחליפים את ${YOUR_TRACKING_ID}
במזהה לצורכי מעקב.
הוספת מעקב אחר מסך
כאן צריך לשלוח ל-Analytics תצוגת מסך בעלת שם בכל פעם שמשתמש פותח או משנה מסכים באפליקציה, אבל הקוד צריך לבצע את הפעולות הבאות:
- צריך לספק את מכשיר המעקב המשותף דרך מחלקה משנית של אפליקציה.
- ביטול שיטת הקריאה החוזרת של הפעילות בחזית.
- נותנים שם למסך ומפעילים את המעקב.
בקשת הצטרפות
עליך להעניק סיווג משנה של Application
ולספק שיטת עזר שתחזיר את מכשיר המעקב של האפליקציה.</>
/*
* 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;
}
}
פעילות או מקטע
פותחים את הפעילות שאחריה רוצים לעקוב. אפשר גם לעקוב אחר Fragment
, אבל צריך לוודא שהוא מייצג בצורה נכונה צפייה במסך.
משנים את השיטה onCreate
ב-Activity
או ב-Fragment
שרוצים לעקוב אחריהם כדי להשיג את המכונה המשותפת של Tracker
:
// Obtain the shared Tracker instance.
AnalyticsApplication application = (AnalyticsApplication) getApplication();
mTracker = application.getDefaultTracker();
אפשר לשנות את השיטה המתאימה, כמו onResume
עבור Activity
או onPageSelected
כדי ש-ViewPager
יתעד אם המסך ישתנה.
Log.i(TAG, "Setting screen name: " + name);
mTracker.setScreenName("Image~" + name);
mTracker.send(new HitBuilders.ScreenViewBuilder().build());
צריך להוסיף קוד מעקב לכל Activity
או Fragment
שמייצגים מסך. אם רוצים להבדיל בין צפיות במסך של האפליקציה ב-Analytics, כדאי להגדיר שם בתוך כל Activity
או Fragment
. כל הפעילות שתועדה במכשיר המעקב המשותף שולחת את שם המסך האחרון, עד להחלפה או למחיקה (הערך מוגדר ל-null
).
שליחת אירוע
כדי לשלוח אירוע, מגדירים את הערכים של שדות המסך במכשיר המעקב ואז שולחים את ההיט.
בדוגמה הבאה נעשה שימוש ב-HitBuilders.EventBuilder
כדי לשלוח Event
:
mTracker.send(new HitBuilders.EventBuilder()
.setCategory("Action")
.setAction("Share")
.build());
השלבים הבאים
במדריך להטמעת אפליקציות לנייד מוסבר איך להשתמש ב-Google Analytics כדי למדוד אינטראקציות של משתמשים ולענות על שאלות לגבי שימוש באפליקציה.
בדקו אפשרויות תצורה נוספות כמו דגימה, בדיקה וניפוי באגים, הגדרות לביטול הסכמה וכו'.
אם האפליקציה צריכה לאסוף מזהי פרסום, צריך להפעיל בה את תכונות הפרסום.