Плагин Google Analytics для Unity: руководство для разработчиков

В этой статье описываются основные принципы использования плагина Google Analytics для Unity.

Подготовка

Прежде чем приступить к работе, выполните следующие действия:

Создание и настройка групп

Выберите платформу, для которой хотите настроить конфигурацию.

Android
  1. Если в директории (<КОРНЕВАЯ ПАПКА ПРОЕКТА>/Assets/Plugins/Android/ вашего проекта нет файла AndroidManifest.xml, создайте проект для Android и скопируйте этот файл из директории Temp/StagingArea/ (она должна быть в той папке, где создан проект). Добавьте файл в директорию <КОРНЕВАЯ ПАПКА ПРОЕКТА>/Assets/Plugins/Android/.
  2. Добавьте следующие разрешения для AndroidManifest.xml в <КОРНЕВАЯ ПАПКА ПРОЕКТА>/Assets/Plugins/Android/ перед тегом <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, скопируйте файл PostProcessBuildPlayer_GA из директории iOS Extras в директорию <КОРНЕВАЯ ПАПКА ПРОЕКТА>/Assets/Editor.
  3. Скачайте скрипт mod_pbxproj.py и скопируйте его в директорию Editor. Библиотеки будут добавлены автоматически в процессе сборки.

Настройка объекта GAv4.prefab

Выполните следующие действия:

  1. Найдите объект GAv4.prefab в папке Assets/Plugins/GoogleAnalyticsV3 в окне Project view. Перетащите его в иерархию игры.
  2. В окне Inspector отобразится компонент скрипта, связанный с файлом 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.prefab можно начинать отслеживание объекта при помощи Google Analytics. Для этого выполните следующие действия:

  1. Выберите объект GameObject, который нужно отслеживать (например, объект Player), и нажмите на него в окне Object Hierarchy. Если у вас ещё нет скрипта, связанного с этим объектом, создайте его, нажав кнопку Add Component в окне Inspector view.
  2. Создайте общедоступную переменную в классе для объекта GoogleAnalyticsV4. Пример:
    public GoogleAnalyticsV4 googleAnalytics;
  3. Сохраните сценарий и вернитесь в окно Unity.
  4. В окне Inspector view для отслеживаемого объекта GameObject будет указан созданный вами скрипт и пустое поле Google Analytics (или название выбранной вами переменной). Перетащите объект GAv4 из окна Object Hierarchy в это поле.
  5. Теперь можно начинать отслеживание объекта GameObject. Повторите эти действия для других объектов, которые нужно отслеживать, используя тот же ресурс prefab.

Дополнительная информация

Ресурсы