Плагин Google Analytics для Unity версии 3 (прошлого поколения): руководство для разработчиков

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

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

Чтобы настроить объект GAv3.prefab, выполните следующие действия:

  1. Нажмите на объект GAv3.prefab, который находится в директории Assets/Plugins/GoogleAnalyticsV3 в окне Project view.
  2. В окне Inspector отобразится компонент скрипта, связанный с файлом 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
  3. Затем перетащите объект GAv3 из окна Project view в окно Object Hierarchy.

Отслеживание объекта

После настройки файла prefab GAv3 можно начинать отслеживание объекта при помощи Google Analytics. Для этого выполните следующие действия:

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

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

Ресурсы