Unity 專用 Google Analytics (分析) 外掛程式 - 開發人員指南

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

事前準備

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

• 您應至少擁有一個 Google Analytics (分析) 資源和資料檢視 (設定檔)，才能從遊戲傳送資料。
• 從 Unity 存放區的 Google Analytics (分析) 外掛程式 下載適當的 Unity 套件，並將其匯入您的 Unity 專案 (只需按兩下檔案即可)。
  • 支援位元碼：GoogleAnalyticsV4_bitcode.unitypackage
  • 不支援位元碼： GoogleAnalyticsV4.unitypackage

設定與配置

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

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.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>
         

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

注意：只有在使用 Xcode 中的 -ObjC 連接器標記時，您才需要使用 libsqlite3.dylib。如果未使用此旗標，您可以放心從 PostProcessBuildPlayer_GA 檔案中移除。

設定 GAv4 Prefab

設定 GAv4 Prefab 的步驟如下：

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

注意：所有平台皆可使用相同的屬性 ID。詳情請參閱「行動應用程式分析的最佳做法」。

追蹤物件

設定 GAv4 預製程式碼後，如何透過 Google Analytics (分析) 追蹤物件：

1. 找到要追蹤的「GameObject」 (例如 Player 物件)，然後按一下「Object Hierarchy」檢視畫面中的物件。如果您尚未將要追蹤的指令碼附加至要追蹤的物件，請使用「檢查器檢視畫面」中的「新增元件」按鈕建立新的指令碼。
2. 在類別中建立公開變數來存放 GoogleAnalytics V4 物件。例如：

   public GoogleAnalyticsV4 googleAnalytics;

3. 儲存指令碼，並返回 Unity 視窗。
4. 找出您要追蹤的 GameObject，在「Inspector」(檢查器) 檢視畫面中，您會看到已建立的指令碼，以及一個填入 Google Analytics (分析) (或您選擇的變數名稱) 的欄位。將「GAv4」物件從「Object Hierarchy」檢視畫面拖曳至欄位。
   如果找不到新增 GAv4 預覽欄位的欄位，請確認指令碼中沒有編譯錯誤。如果有錯誤，檢查器將不會更新。
5. 您現在可以開始追蹤 GameObject 了。針對其他您想使用同一個預製物件的物件重複上述步驟。

後續步驟

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

資源

• 疑難排解
• 回報問題
• 取得說明
• 變更記錄