Hướng dẫn này cho biết cách thêm Analytics vào ứng dụng Android để đo lường hoạt động của người dùng trên các màn hình đã được đặt tên. Nếu bạn chưa có đơn đăng ký và chỉ muốn xem cách Analytics hoạt động, hãy xem đơn đăng ký mẫu của chúng tôi.
Bắt buộc: Phiên bản mới nhất của:
Thiết lập dự án
Cập nhật tệp AndroidManifest.xml
của dự án để bao gồm các quyền INTERNET
và 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>
Hãy thêm phần phụ thuộc sau đây vào build.gradle
cấp dự án:
dependencies {
// ...
classpath 'com.google.gms:google-services:3.0.0'
}
Thêm phần phụ thuộc sau trên Dịch vụ Google Play vào app/build.gradle
:
dependencies {
// ...
compile 'com.google.android.gms:play-services-analytics:10.2.4'
}
Tạo global_tracker.xml
Tạo tệp app/src/res/xml/global_tracker.xml
với nội dung sau:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="ga_trackingId" translatable="false">${YOUR_TRACKING_ID}</string>
</resources>
Thay thế ${YOUR_TRACKING_ID}
bằng mã theo dõi của bạn.
Thêm tính năng theo dõi màn hình
Tại đây, bạn sẽ gửi chế độ xem màn hình đã đặt tên đến Analytics bất cứ khi nào người dùng mở hoặc thay đổi màn hình trên ứng dụng của bạn. Mã của bạn phải thực hiện như sau:
- Cung cấp trình theo dõi dùng chung thông qua một lớp con Application (Ứng dụng).
- Ghi đè phương thức gọi lại cho hoạt động trên nền trước.
- Đặt tên cho màn hình và thực hiện theo dõi.
Ứng dụng
Bạn nên phân lớp con Application
và cung cấp một phương thức trợ giúp để trả về trình theo dõi của ứng dụng.</>
/*
* 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;
}
}
Hoạt động hoặc mảnh
Mở Hoạt động bạn muốn theo dõi. Bạn cũng có thể theo dõi Fragment
, nhưng hãy đảm bảo rằng nó thể hiện chính xác lượt xem màn hình.
Ghi đè phương thức onCreate
của Activity
hoặc Fragment
mà bạn muốn theo dõi để lấy thực thể Tracker
dùng chung:
// Obtain the shared Tracker instance.
AnalyticsApplication application = (AnalyticsApplication) getApplication();
mTracker = application.getDefaultTracker();
Ghi đè phương thức thích hợp, chẳng hạn như onResume
cho Activity
hoặc onPageSelected
để ViewPager
ghi lại khi màn hình thay đổi.
Log.i(TAG, "Setting screen name: " + name);
mTracker.setScreenName("Image~" + name);
mTracker.send(new HitBuilders.ScreenViewBuilder().build());
Thêm mã theo dõi vào mỗi Activity
hoặc Fragment
đại diện cho một màn hình. Hãy
đặt tên bên trong mỗi Activity
hoặc Fragment
nếu bạn muốn
phân biệt các lượt xem màn hình cho ứng dụng của mình trong Analytics. Tất cả hoạt động được ghi lại trên trình theo dõi dùng chung đều gửi tên màn hình gần đây nhất cho đến khi bị thay thế hoặc xoá (đặt thành null
).
Gửi một sự kiện
Để gửi một sự kiện, hãy đặt các giá trị cho trường màn hình trên trình theo dõi, sau đó gửi lượt truy cập.
Ví dụ sau đây sử dụng HitBuilders.EventBuilder
để gửi Event
:
mTracker.send(new HitBuilders.EventBuilder()
.setCategory("Action")
.setAction("Share")
.build());
Các bước tiếp theo
Hãy đọc Hướng dẫn triển khai ứng dụng di động để tìm hiểu cách sử dụng Google Analytics nhằm đo lường hoạt động tương tác của người dùng và giải đáp các thắc mắc về việc dùng ứng dụng.
Xem xét các tuỳ chọn cấu hình bổ sung, chẳng hạn như lấy mẫu, kiểm thử và gỡ lỗi, chế độ cài đặt chọn không tham gia, v.v.
Nếu ứng dụng của bạn cần thu thập mã nhận dạng cho quảng cáo, hãy bật các tính năng quảng cáo cho ứng dụng.