Unity 向け Google アナリティクス プラグイン - デベロッパー ガイド

このドキュメントでは、Unity 向け Google アナリティクス プラグインの使用に関する重要な 概念を説明します。

始める前に

始める前に、以下の項目が完了していることを確認してください。

• ゲームからデータを送信する Google アナリティクスのプロパティとビュー（プロファイル）をそれぞれ 1 つ以上用意しておく必要があります。
• Unity 向け Google アナリティクス プラグイン リポジトリから適切な Unity パッケージをダウンロードして、Unity プロジェクトにインポートします（ファイルをダブルクリックするとインポートできます）。
  • ビットコード サポートあり: GoogleAnalyticsV4_bitcode.unitypackage
  • ビットコードのサポートなし: GoogleAnalyticsV4.unitypackage

セットアップと構成

プラットフォームを選択して、構成の詳細を確認してください。

Android

1. プロジェクトの <プロジェクト ルート>/Assets/Plugins/Android/ ディレクトリに AndroidManifest.xml というファイルがまだない場合は、Android 用のプロジェクトをビルドし、Temp/StagingArea/ ディレクトリ（ビルド先として選択したディレクトリの下）から AndroidManifest.xml をコピーします。コピーしたコードを <プロジェクト ルート>/Assets/Plugins/Android/ に貼り付けます。
2. <YOUR PROJECT ROOT> /Assets/Plugins/Android/ の AndroidManifest.xml の <application> タグの上に、次の権限を追加します。

   <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 ファイルをコピーして、<プロジェクト ルート>/Assets/Editor ディレクトリに配置します。
3. mod_pbxproj.py スクリプトをダウンロードして、Editor ディレクトリにコピーします。これで、ビルド中にライブラリが自動的に追加されるようになります。

注: libsqlite3.dylib は、Xcode で -ObjC リンカーフラグを使用する場合にのみ必要です。このフラグを使用しない場合は、PostProcessBuildPlayer_GA ファイルから安全に削除できます。

GAv4 プレハブを設定する

GAv4 プレハブを設定する方法は次のとおりです。

1. [Project] ビューの Assets/Plugins/GoogleAnalyticsV4 にある GAv4.prefab プレハブ オブジェクトをクリックします。このオブジェクトをゲーム階層にドラッグします。
2. [Inspector] ビューに、プレハブにアタッチされたスクリプト コンポーネントと、いくつかのプロパティが表示されます。 これらのプロパティには、プロジェクトの正しい値を設定します。これによりオブジェクトにデータが入力され、プロジェクトのあらゆる場所で使用できるようになります。次に例を示します。
   • 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 アナリティクスを使ってオブジェクトを トラッキングできます。

1. トラッキングする GameObject（Player オブジェクトなど）を特定し、 [Object Hierarchy] ビューでクリックします。トラッキングするオブジェクトにスクリプトをまだ添付していない場合は、[Inspector] ビューの [Add Component] ボタンを使用して新しいスクリプトを作成します。
2. クラス内に GoogleAnalyticsV4 オブジェクトを保持するパブリック変数を 作成します。例:

   public GoogleAnalyticsV4 googleAnalytics;

3. スクリプトを保存し、Unity ウィンドウに戻ります。
4. トラッキングする GameObject の [Inspector] ビューに、 作成したスクリプトと Google Analytics（または選択した変数名）という名前のフィールドが 表示されます。GAv4 オブジェクトを [Object Hierarchy] ビューからフィールドにドラッグします。
   GAv4 プレハブを追加するフィールドが表示されない場合は、スクリプトにコンパイル エラーがないことをご確認ください。既存のエラーがある場合、[Inspector] は更新されません。
5. これで、GameObject のトラッキングを開始する準備が整いました。 同じプレハブを使用してトラッキングする他のオブジェクトについて、このプロセスを繰り返します。

次のステップ

• Google アナリティクスに送信できるヒットの種類については、API リファレンスをご覧ください。
• Google アナリティクスを使用してユーザーの操作を測定したり、ゲームの利用状況を確認したりする方法については、モバイルアプリ実装ガイドをご覧ください。

リソース

• トラブルシューティング
• 問題を報告する
• ヘルプ
• 変更履歴