Unity v3 (舊版) 適用的 Google Analytics (分析) 外掛程式 - 開發人員指南

本文件說明使用 Unity 專用 Google Analytics (分析) 外掛程式的重要概念。

事前準備

開始之前，請確認您已完成下列事項：

您必須擁有至少一個 Google Analytics (分析) 資源，以及一個用來傳送遊戲資料的資料檢視 (設定檔)。
如要追蹤電子商務交易，請在報表中啟用電子商務功能。
從 Unity 適用的 Google Analytics (分析) 外掛程式下載 googleanalyticsv3.unitypackage，並匯入至 Unity 專案中 (按兩下檔案應該就能這麼做)。

設定與配置

選擇設定詳細資料的平台：

Android

如果您的專案 <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.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

將下列程式庫加入 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」目錄。現在系統會在建構期間自動新增程式庫。

注意：只有在 Xcode 中使用 -ObjC 連結器旗標時，才需要使用 libsqlite3.dylib，而且如未使用這個標記，則可從 PostProcessBuildPlayer_GA 檔案安全移除。

設定 GAv3 Prefab

設定 GAv3 Prefab 需要執行下列步驟：

按一下 GAv3.prefab prefab 物件。您可以前往專案檢視畫面的 Assets/Plugins/GoogleAnalyticsV3 頁面，
檢查器檢視畫面會顯示附加至 Prefab 的指令碼元件，其中列出多個屬性。為專案填入正確的值。這會填入物件，以便在專案的任意位置使用。例如：
- 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
將填入的 GAv3 從「專案檢視畫面」向上拖曳至「物件階層」。

追蹤物品

設定 GAv3 預先產生後，您可以按照下列步驟，開始使用 Google Analytics (分析) 追蹤物件：

找出您要追蹤的 GameObject (例如玩家物件)，然後在「物件階層結構」檢視畫面中按一下該物件。如果您想追蹤的物件尚未附加至該物件，請使用「Inspector view」中的「Add Component」按鈕建立新指令碼。
在類別中建立公開變數，用來保存 GoogleAnalyticsV3 物件。例如：
```
public GoogleAnalyticsV3 googleAnalytics;
```
儲存指令碼，然後返回「Unity」視窗。
在所要追蹤 GameObject 的「Inspector」檢視畫面中，您會看到您建立的指令碼，以及要填入 Google Analytics (分析) (或您選擇的變數名稱) 的欄位。將 GAv3 物件從「物件階層」檢視畫面拖曳至欄位。
如果沒看到新增 GAv3 prefab 的欄位，請檢查並確認指令碼中沒有任何編譯錯誤。如果發生任何錯誤，「Inspector」不會更新。
現在可以開始追蹤 GameObject 了。針對您想使用相同 Prefab 追蹤的其他物件，重複上述程序。

後續步驟

請參閱 API 參考資料，瞭解可傳送至 Google Analytics (分析) 的命中類型。
請參閱行動應用程式導入指南，瞭解如何使用 Google Analytics (分析) 評估使用者互動，並回答遊戲使用情況的問題。