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:
- Bạn phải có ít nhất một thuộc tính Google Analytics và một chế độ xem (hồ sơ) để gửi dữ liệu từ trò chơi của bạn đến.
- Tải gói Unity thích hợp xuống từ kho lưu trữ Google
Analytics dành cho Unity rồi nhập gói đó vào dự án Unity (bạn
có thể thực hiện việc này bằng cách nhấp đúp vào tệp).
- Có hỗ trợ mã bit:
GoogleAnalyticsV4_bitcode.unitypackage
- Không hỗ trợ mã bit:
GoogleAnalyticsV4.unitypackage
- Có hỗ trợ mã bit:
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:
- 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/.
- 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" />
- 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.android.gms.analytics.CampaignTrackingService" /> <receiver android:name="com.google.android.gms.analytics.CampaignTrackingReceiver" android:exported="true" > <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
-
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
- 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.
- 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 GAv4
Cách định cấu hình prefab GAv4:
- Nhấp vào đối tượng prefab
GAv4.prefab
mà bạn có thể tìm thấy trong Assets/Plugins/GoogleAnalyticsV4 trong Project View (Chế độ xem dự án). Kéo nội dung này vào hệ phân cấp của trò chơi. - 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 Tracking Code: UA-XXXXXXX-1
iOS Tracking Code: UA-XXXXXXX-2
Other Tracking Code: UA-XXXXXXX-3
Product Name: MyGame
Bundle Identifier: com.example.games
Bundle Version: 1.0
Dispatch Period: 5
Sample Frequency: 100
Log Level: VERBOSE
Anonymize IP: false
Uncaught Exception Reporting: false
Send Launch Event: false
Session Timeout: 1800
Dry Run: false
Advertiser Id Support - Send IDFA/AdID: false
Theo dõi một đối tượng
Sau khi định cấu hình prefab GAv4, để theo dõi một đối tượng bằng Google Analytics:
- 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).
- Tạo một biến công khai trong lớp này để lưu đối tượng GoogleAnalyticsV4. Ví dụ:
public GoogleAnalyticsV4 googleAnalytics;
- Lưu tập lệnh và quay lại cửa sổ Unity.
- 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 GAv4 từ chế độ xem Hệ thống phân cấp đối tượng vào trường.
- 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
- Xem Tài liệu tham khảo API để tìm hiểu loại lượt truy cập mà bạn có thể gửi đến Google Analytics.
- Đọc Hướng dẫn triển khai ứng dụng dành cho thiết bị 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à trả lời các câu hỏi về mức sử dụng trò chơi.