Google Analytics SDK dành cho Android: Di chuyển từ phiên bản 1.x sang phiên bản 2.x

Hướng dẫn di chuyển này mô tả các tính năng mới trong phiên bản 2 của SDK, đồng thời cung cấp cho nhà phát triển các mẹo để di chuyển từ phiên bản triển khai v1.x. Các nhà phát triển không cần di chuyển từ phiên bản triển khai v1.x có thể Bắt đầu sử dụng Phiên bản 2 ngay bây giờ.

Giới thiệu

Gần đây, Google Analytics đã phát hành bản cập nhật SDK Google Analytics cho Android phiên bản 2. Phiên bản 2 của SDK có hỗ trợ các tính năng mới và giao diện báo cáo mới được thiết kế dành riêng cho nhà phát triển ứng dụng.

Tất cả các nhà phát triển Google Analytics hiện tại nên chuyển sang phiên bản 2 của SDK Google Analytics dành cho Android để tận dụng các tính năng và báo cáo mới.

Tính năng mới trong phiên bản 2

SDK Google Analytics dành cho Android phiên bản 2 giới thiệu trải nghiệm báo cáo mới được thiết kế cho nhà phát triển ứng dụng, các phương diện và chỉ số mới mạnh mẽ và nhiều tính năng khác. Sau đây là những lợi ích mà nhà phát triển nhận được khi dùng phiên bản 2:

Các báo cáo hữu ích hơn dành cho nhà phát triển ứng dụng
Chúng tôi đã thiết kế lại các báo cáo chuẩn cho nhà phát triển ứng dụng, bổ sung các báo cáo mới như Luồng tương tác và Nguồn Google Play để giúp nhà phát triển có được thông tin chi tiết mới về trải nghiệm và hoạt động chuyển đổi của người dùng. Hãy đọc Các phương pháp hay nhất về cấu hình tài khoản của chúng tôi để tìm hiểu thêm về cách tốt nhất để định cấu hình thuộc tính cho phiên bản 2.
Phương diện và chỉ số mới cho ứng dụng
Các phương diện và chỉ số mới dành riêng cho ứng dụng đã được ra mắt cùng với phiên bản 2 của SDK, bao gồm cả Tên màn hình và Lượt xem màn hình, Tên ứng dụng, Phiên bản ứng dụng và nhiều phiên bản khác.
Đo lường sự cố và ngoại lệ
SDK Google Analytics dành cho Android ra mắt tính năng đo lường ngoại lệ và loại lượt truy cập ngoại lệ. Khi sử dụng tính năng đo lường ngoại lệ, bạn có thể đo lường số lượng và loại sự cố cũng như các trường hợp ngoại lệ không nghiêm trọng. Để tìm hiểu cách triển khai tính năng đo lường ngoại lệ, hãy xem Hướng dẫn cho nhà phát triển về ngoại lệ.
Phương diện và chỉ số tuỳ chỉnh
Tạo phương diện tuỳ chỉnh để phân đoạn dữ liệu theo những cách mới. Tìm hiểu thêm về Phương diện và chỉ số tuỳ chỉnh.
Đo lường lượt tương tác trên mạng xã hội
Thu thập thông tin chi tiết mới về giá trị của mạng xã hội trong ứng dụng của bạn bằng cách đo lường hoạt động tương tác của người dùng với các trình bổ trợ và tiện ích được nhúng trên mạng xã hội. Tìm hiểu thêm về cách đo lường Lượt tương tác trên mạng xã hội.

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

Tất cả các nhà phát triển đều nên thực hiện 2 bước sau đây trước khi bắt đầu quá trình di chuyển:

  1. Tải Google Analytics SDK dành cho Android phiên bản 2
  2. Tạo chế độ xem ứng dụng (hồ sơ) mà bạn sẽ dùng để truy cập vào dữ liệu và báo cáo ứng dụng mới.

Sau khi hoàn tất các bước trên, hãy làm theo các bước bên dưới cho đường dẫn di chuyển của bạn.

Di chuyển từ EasyTracker

Bạn cần thực hiện 3 bước để di chuyển ứng dụng của mình từ phiên bản 1 sang phiên bản 2 của thư viện EasyTracker:

  1. Cập nhật các thông số trong tệp tài nguyên GoogleAnalytics.xml
  2. Cập nhật tên phương thức
  3. Cập nhật broadcast receiver của bạn (Theo dõi chiến dịch trên Google Play)

1. Cập nhật các thông số trong GoogleAnalytics.xml

Khi chuyển sang phiên bản 2, hãy cập nhật các thông số trong tệp tài nguyên GoogleAnalytics.xml, vì một số thông số đã thay đổi kể từ phiên bản 1.x và các thông số mới đã được thêm vào phiên bản 2.

Bảng bên dưới cho thấy các thông số đã được cập nhật trong phiên bản 2:

Tên thông số phiên bản 1.xTên thông số phiên bản 2.x
ga_api_keyga_trackingId
ga_auto_activity_trackingga_autoActivityTracking
ga_dryRunkhông dùng nữa

Để tìm hiểu thêm, hãy xem các Tham số EasyTracker mới và được cập nhật.

2. Cập nhật tên phương thức

Mặc dù phần lớn cú pháp vẫn giữ nguyên trong phiên bản 2 của EasyTracker, nhưng có một số khác biệt đáng chú ý về tên phương thức và cú pháp sẽ yêu cầu bạn cập nhật phương thức triển khai của mình:

3. Cập nhật broadcast receiver (Theo dõi chiến dịch trên Google Play)

Các nhà phát triển đã triển khai tính năng Theo dõi chiến dịch trên Google Play bằng phiên bản 1.x cần lưu ý rằng đường dẫn lớp của trình thu đã thay đổi. Hãy xem Hướng dẫn theo dõi chiến dịch trên Google Play để biết thêm thông tin.

Di chuyển từ quy trình triển khai tuỳ chỉnh

Nếu không sử dụng thư viện EasyTracker trong phiên bản 1.x của SDK Analytics dành cho Android, bạn nên bắt đầu sử dụng EasyTracker ở phiên bản 2.

Thư viện EasyTracker hiện có trong SDK và là thư viện nên dùng cho tất cả các nhà phát triển. Bắt đầu sử dụng EasyTracker trong SDK Google Analytics phiên bản 2.

Nếu bạn có nhu cầu thu thập dữ liệu nâng cao, chẳng hạn như sử dụng nhiều mã thuộc tính trong một lần triển khai, hãy đọc Hướng dẫn cấu hình nâng cao để tìm hiểu thêm về cách sử dụng các tính năng nâng cao của SDK phiên bản 2.x.