本文件說明使用 Unity 專用 Google Analytics (分析) 外掛程式的重要概念。
事前準備
開始之前,請確認您已完成下列事項:
- 您必須擁有至少一個 Google Analytics (分析) 資源,以及一個用來傳送遊戲資料的資料檢視 (設定檔)。
- 從 Unity 適用的 Google Analytics (分析) 外掛程式存放區下載適當的 Unity 套件,然後匯入您的 Unity 專案 (只要按兩下檔案即可進行)。
設定與配置
選擇設定詳細資料的平台:
- 如果您的專案 <YOUR PROJECT ROOT>/Assets/Plugins/Android/ 目錄中還沒有名稱為 AndroidManifest.xml 的檔案,請為 Android 建構專案,然後從 Temp/StagingArea/ 目錄中複製 AndroidManifest.xml (該檔案位於您選擇建構的目錄中)。然後貼到 <YOUR PROJECT ROOT>/Assets/Plugins/Android/。
- 將下列權限新增至 <YOUR PROJECT ROOT> /Assets/Plugins/Android/ 中,位於
<application>
標記上方的 AndroidManifest.xml:<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
- 如要啟用廣告活動追蹤,請按照以下方式新增服務:
<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>
-
將下列程式庫加入 Xcode 專案:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- 如果您想在建構 iOS 應用程式時自動加入程式庫,請從 iOS Extras 目錄複製 PostProcessBuildPlayer_GA 檔案,並將其放入 <YOUR PROJECT ROOT>/Assets/Editor 目錄中。
- 下載 mod_pbxproj.py 指令碼,並複製到「Editor」目錄。現在系統會在建構期間自動新增程式庫。
設定 GAv4 Prefab
如何設定 GAv4 Prefab:
- 按一下
GAv4.prefab
prefab 物件。您可以前往專案檢視畫面的 Assets/Plugins/GoogleAnalyticsV4 頁面,將此項目拖曳至遊戲階層中。 - 檢查器檢視畫面會顯示附加至 Prefab 的指令碼元件,其中列出多個屬性。為專案填入正確的值。這會填入物件,以便在專案的任意位置使用。例如:
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
追蹤物品
設定 GAv4 預先產生後,接著透過 Google Analytics (分析) 追蹤物件:
- 找出您要追蹤的 GameObject (例如玩家物件),然後在「物件階層結構」檢視畫面中按一下該物件。如果您想追蹤的物件尚未附加至該物件,請使用「Inspector view」中的「Add Component」按鈕建立新指令碼。
- 在類別中建立公開變數,用來保存 GoogleAnalyticsV4 物件。例如:
public GoogleAnalyticsV4 googleAnalytics;
- 儲存指令碼,然後返回「Unity」視窗。
- 在所要追蹤 GameObject 的「Inspector」檢視畫面中,您會看到您建立的指令碼,以及要填入 Google Analytics (分析) (或您選擇的變數名稱) 的欄位。將 GAv4 物件從「物件階層」檢視畫面拖曳至欄位。
- 現在可以開始追蹤 GameObject 了。針對您想使用相同 Prefab 追蹤的其他物件,重複上述程序。
後續步驟
- 請參閱 API 參考資料,瞭解可傳送至 Google Analytics (分析) 的命中類型。
- 請參閱行動應用程式導入指南,瞭解如何使用 Google Analytics (分析) 評估使用者互動,並回答遊戲使用情況的問題。