Google Analytics SDK dành cho Android phiên bản 3 (Cũ) - Bắt đầu

Tài liệu này mô tả cách bắt đầu sử dụng SDK Google Analytics dành cho Android phiên bản 3.

Trước khi bạn bắt đầu

Trước khi triển khai SDK, hãy đảm bảo bạn có:

Bắt đầu

Có 3 bước để bắt đầu với SDK:

  1. Cập nhật AndroidManifest.xml
  2. Thêm phương thức EasyTracker
  3. Tạo tệp analytics.xml

Sau khi hoàn tất các bước này, bạn sẽ có thể đo lường những chỉ số sau bằng Google Analytics:

  • Lượt cài đặt ứng dụng
  • Số người dùng đang hoạt động và thông tin nhân khẩu học
  • Màn hình và mức độ tương tác của người dùng
  • Sự cố và ngoại lệ

1. Đang cập nhật AndroidManifest.xml

Cập nhật tệp AndroidManifest.xml bằng cách thêm các quyền sau:

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

2. Thêm các phương thức EasyTracker

Thêm các phương thức gửi vào phương thức onStart() và onStop() của từng Activities như trong ví dụ sau:

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. Tạo tệp analytics.xml

Khi bạn sử dụng EasyTracker, các chế độ cài đặt cấu hình chung sẽ được quản lý bằng tài nguyên được xác định trong XML. Tạo một tệp có tên là analytics.xml trong thư mục res/values của dự án và thêm các tài nguyên sau:

<?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>

Công cụ kiểm tra tìm lỗi mã nguồn có thể cảnh báo bạn về việc sử dụng dấu gạch ngang hình (":") trong mã theo dõi của bạn. Bạn có thể loại bỏ cảnh báo đó bằng cách thêm các thuộc tính bổ sung vào thẻ <resources>:

<resources xmlns:tools="http://schemas.android.com/tools"
tools:ignore="TypographyDashes">

Hãy xem tài liệu tham khảo về tham số analytics.xml để biết danh sách đầy đủ các tham số mà bạn có thể dùng để định cấu hình cách triển khai của mình. Tuỳ thuộc vào yêu cầu của ứng dụng, bạn nên thay đổi thời gian gửi dữ liệu để xác minh rằng bạn đang gửi lượt truy cập đúng cách. Ví dụ: nếu muốn xem dữ liệu theo thời gian thực, bạn có thể đặt giá trị này thành một giá trị thấp, chẳng hạn như 5 giây.

Xin chúc mừng! Ứng dụng của bạn hiện đã được thiết lập để gửi dữ liệu đến Google Analytics.

Các bước tiếp theo

Bạn có thể làm được nhiều việc hơn với Google Analytics, bao gồm cả việc đo lường chiến dịch, thanh toán và giao dịch trong ứng dụng cũng như sự kiện tương tác của người dùng.

Các hướng dẫn sau đây cho nhà phát triển cung cấp thêm thông tin chi tiết về cách triển khai các tính năng của Google Analytics trong ứng dụng của bạn:

  • Đo lường sự kiện – Tìm hiểu cách đo lường mức độ tương tác của người dùng với nội dung tương tác như nút, video và các nội dung nghe nhìn khác bằng tính năng Sự kiện.
  • Đo lường khoản thanh toán trong ứng dụng – Tìm hiểu cách đo lường khoản thanh toán và giao dịch trong ứng dụng.
  • Đo lường chiến dịch – Tìm hiểu cách triển khai tính năng đo lường chiến dịch để hiểu rõ những kênh và chiến dịch nào đang thúc đẩy lượt cài đặt ứng dụng.
  • Thời gian người dùng – Tìm hiểu cách đo lường thời gian người dùng trong ứng dụng để đo thời gian tải, mức độ tương tác với nội dung nghe nhìn và các thông tin khác.
  • Cấu hình nâng cao – Tìm hiểu thêm về các lựa chọn cấu hình nâng cao, bao gồm cả việc sử dụng nhiều trình theo dõi.
  • Thông số Analytics.xml – Xem danh sách đầy đủ các thông số cấu hình analytics.xml.