本文件說明舊版 Unity SDK。如果您是第一次使用 Analyitcs，請使用最新的 SDK。瞭解詳情

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

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

事前準備

開始之前，請確認你已完成下列項目：

設定與配置

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

Android
  1. 如果專案在 <YOUR PROJECT ROOT>/Assets/Plugins/Android/ 目錄中沒有名為 AndroidManifest.xml 的檔案，請為 Android 建構專案，然後從 Temp/StagingArea/ 目錄中複製 AndroidManifest.xml (該目錄位於您選擇的建構目錄中)。將程式碼貼到 <YOUR PROJECT ROOT>/Assets/Plugins/Android/。
  2. 將下列權限新增至 <application> 標記上方的 <YOUR PROJECT ROOT> /Assets/Plugins/Android/ 中的 AndroidManifest.xml： 
    <uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
  3. 如果您想啟用廣告活動追蹤，請新增服務，如下所示： 
    <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. 將以下程式庫新增至 Xcode 專案：
    • AdSupport.framework
    • CoreData.framework
    • SystemConfiguration.framework
    • libz.dylib
    • libsqlite3.dylib
  2. 如果想在為 iOS 建構時自動新增程式庫，請從 iOS Extras 目錄複製 PostProcessBuildPlayer_GA 檔案，並放入 <YOUR PROJECT ROOT>/Assets/Editor 目錄。
  3. 下載 mod_pbxproj.py 指令碼並複製到 Editor 目錄。系統將會在建構期間自動新增程式庫。

設定 GAv3 Prefab

設定 GAv3 Prefab 時，您必須完成下列步驟：

  1. 按一下 GAv3.prefab 預覽標記物件，位於 Project View 的 Assets/Plugins/GoogleAnalyticsV3 中。
  2. 「Inspector view」(檢查器檢視畫面) 會顯示附加在 prebb 的「Script Component」(指令碼元件)，當中列出多項屬性。將正確的專案值填入這些屬性。這會填入物件，方便您在專案的任何位置使用。例如：
    • 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. 將填入的 GAv3 從專案檢視畫面拖曳到「物件階層」中。

追蹤物件

設定 GAv3 預製程式碼後，請按照下列步驟開始使用 Google Analytics (分析) 追蹤物件：

  1. 找到要追蹤的「GameObject」 (例如 Player 物件)，然後按一下「Object Hierarchy」檢視畫面中的物件。如果您尚未將要追蹤的指令碼附加至要追蹤的物件，請使用「檢查器檢視畫面」中的「新增元件」按鈕建立新的指令碼。
  2. 在類別中建立公開變數來存放 GoogleAnalytics V3 物件。例如： 
    public GoogleAnalyticsV3 googleAnalytics;
  3. 儲存指令碼，並返回 Unity 視窗。
  4. 找出您要追蹤的 GameObject，在「Inspector」(檢查器) 檢視畫面中，您會看到已建立的指令碼，以及一個填入 Google Analytics (分析) (或您選擇的變數名稱) 的欄位。將「GAv3」物件從「Object Hierarchy」檢視畫面拖曳至欄位。
  5. 您現在可以開始追蹤 GameObject 了。針對其他您想使用同一個預製物件的物件重複上述步驟。

後續步驟

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

資源