Trình bổ trợ Google Analytics dành cho Unity phiên bản 3 (Cũ) – Hướng dẫn cho nhà phát triển

Tài liệu này giải thích các khái niệm quan trọng về cách sử dụng Trình bổ trợ Google Analytics cho Unity.

Trước khi bắt đầu

Trước khi bắt đầu, hãy đảm bảo bạn đã hoàn tất các mục sau:

Thiết lập và định cấu hình

Chọn một nền tảng để biết chi tiết cấu hình:

Android
  1. Nếu dự án của bạn chưa có tệp có tên AndroidManifest.xml trong thư mục <YOUR PROJECT ROOT>/Assets/Plugins/Android/, hãy tạo dự án cho Android rồi sao chép AndroidManifest.xml từ thư mục temp/StagingArea/ (tệp này sẽ nằm trong thư mục mà bạn chọn tạo). Dán tệp đó vào <YOUR PROJECT ROOT>/Assets/Plugins/Android/.
  2. Thêm các quyền sau vào tệp AndroidManifest.xml trong <YOUR PROJECT ROOT> /Assets/Plugins/Android/ ở phía trên thẻ <application>: 
    <uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
  3. Nếu bạn muốn bật tính năng Theo dõi chiến dịch, hãy thêm dịch vụ này như sau: 
    <service android:name="com.google.analytics.tracking.android.CampaignTrackingService" />
<receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver"
          android:exported="true" >
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>
iOS
  1. Thêm các thư viện sau vào dự án Xcode của bạn:
    • AdSupport.framework
    • CoreData.framework
    • SystemConfiguration.framework
    • libz.dylib
    • libsqlite3.dylib
  2. Nếu bạn muốn tự động thêm các thư viện khi tạo bản dựng dành cho iOS, hãy sao chép tệp PostProcessBuildPlayer_GA từ thư mục iOS Extras và đặt tệp đó vào thư mục <YOUR PROJECT ROOT>/Assets/Editor.
  3. Tải mod_pbxproj.py tập lệnh xuống rồi sao chép tập lệnh đó vào thư mục Editor. Giờ đây, các thư viện sẽ được tự động thêm vào trong quá trình xây dựng.

Định cấu hình prefab GAv3

Bạn cần thực hiện các bước sau đây để định cấu hình prefab GAv3:

  1. Nhấp vào đối tượng prefab GAv3.prefab mà bạn có thể tìm thấy trong Assets/Plugins/GoogleAnalyticsV3 trong Project View (Chế độ xem dự án).
  2. Khung hiển thị Inspector sẽ hiển thị một thành phần tập lệnh được đính kèm vào prefab kèm theo một số thuộc tính được liệt kê. Điền các giá trị chính xác cho dự án của bạn vào các thuộc tính này. Thao tác này sẽ điền đối tượng để có thể sử dụng ở mọi nơi trong dự án của bạn. Ví dụ:
    • Android Property ID: UA-XXXXXXX-1
    • iOS Property ID: UA-XXXXXXX-2
    • Other Property ID: UA-XXXXXXX-3
    • App Name: MyGame
    • Bundle ID: com.example.games
    • App Version: 1.0
    • Dispatch Period: 5
    • Sample Frequency: 100
    • Debug Mode: VERBOSE
    • Anonymize IP: false
    • Dry Run: false
  3. Kéo GAv3 được điền sẵn từ Chế độ xem dự án lên trên vào Hệ phân cấp đối tượng.

Theo dõi một đối tượng

Sau khi định cấu hình prefab GAv3, bạn đã sẵn sàng bắt đầu theo dõi đối tượng bằng Google Analytics bằng cách làm theo các bước sau:

  1. Xác định GameObject mà bạn muốn theo dõi (ví dụ: đối tượng Trình phát) và nhấp vào đối tượng đó trong chế độ xem GameObject. Nếu bạn chưa đính kèm tập lệnh vào đối tượng bạn muốn theo dõi, hãy tạo một tập lệnh mới bằng cách sử dụng nút Add Component (Thêm thành phần) trong Inspector view (Chế độ xem Inspector).
  2. Tạo một biến công khai trong lớp này để lưu giữ đối tượng GoogleAnalyticsV3. Ví dụ: 
    public GoogleAnalyticsV3 googleAnalytics;
  3. Lưu tập lệnh và quay lại cửa sổ Unity.
  4. Trong Chế độ xem công cụ kiểm tra cho rực mà bạn muốn theo dõi, bạn sẽ thấy tập lệnh mà bạn đã tạo và một trường để điền được gọi là Google Analytics (hoặc tên biến mà bạn đã chọn). Kéo đối tượng GAv3 từ chế độ xem Hệ thống phân cấp đối tượng vào trường.
  5. Bạn hiện đã sẵn sàng bắt đầu theo dõi GameObject đó. Lặp lại quá trình này cho các đối tượng khác mà bạn muốn theo dõi bằng cách sử dụng cùng một prefab.

Các bước tiếp theo

Tài nguyên