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

В этом документе объясняются важные понятия об использовании плагина Google Analytics для Unity.

Прежде чем вы начнете

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

Настройка и конфигурация

Выберите платформу для получения подробной информации о конфигурации:

Андроид
  1. Если в вашем проекте еще нет файла AndroidManifest.xml в каталоге <КОРЕНЬ ВАШЕГО ПРОЕКТА>/Assets/Plugins/Android/ , создайте проект для Android, а затем скопируйте AndroidManifest.xml из каталога 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 и скопируйте его в каталог редактора . Библиотеки теперь будут добавляться автоматически во время сборки.

Настройте префаб GAv4

Чтобы настроить префаб GAv4:

  1. Нажмите на объект-префаб GAv4.prefab , который можно найти в Assets/Plugins/GoogleAnalyticsV4 в представлении проекта . Перетащите это в иерархию игры.
  2. В представлении «Инспектор» отобразится компонент «Сценарий» , прикрепленный к префабу, с несколькими перечисленными свойствами. Заполните эти свойства правильными значениями для вашего проекта. Это заполнит объект, чтобы его можно было использовать повсюду в вашем проекте. Например:
    • 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 для отслеживания объекта с помощью Google Analytics:

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

Следующие шаги

Ресурсы