В этом документе объясняются важные понятия об использовании плагина Google Analytics для Unity.
Прежде чем вы начнете
Прежде чем начать, убедитесь, что вы выполнили следующие пункты:
- У вас должен быть хотя бы один ресурс Google Analytics и представление (профиль) , в которое можно отправлять данные из вашей игры.
- Если вы хотите отслеживать транзакции электронной торговли, включите электронную торговлю в своих отчетах .
- Загрузите googleanalyticsv3.unitypackage из репозитория плагина Google Analytics для Unity и импортируйте его в свой проект Unity (вы сможете сделать это, дважды щелкнув файл).
Настройка и конфигурация
Выберите платформу для получения подробной информации о конфигурации:
- Если в вашем проекте еще нет файла AndroidManifest.xml в каталоге <КОРЕНЬ ВАШЕГО ПРОЕКТА>/Assets/Plugins/Android/ , создайте проект для Android, а затем скопируйте AndroidManifest.xml из каталога Temp/StagingArea/ (он будет находиться в каталоге, который вы выбрали для сборки). Вставьте его в <КОРЕНЬ ВАШЕГО ПРОЕКТА>/Assets/Plugins/Android/ .
- Добавьте следующие разрешения для AndroidManifest.xml в <ВАШЕ КОРНЕВОЕ ПРОЕКТА> /Assets/Plugins/Android/ над тегом
<application>
:<uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
- Если вы хотите включить отслеживание кампании , добавьте службу следующим образом:
<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>
- Добавьте следующие библиотеки в свой проект Xcode:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- Если вы предпочитаете, чтобы библиотеки автоматически добавлялись при сборке для iOS, скопируйте файл PostProcessBuildPlayer_GA из каталога iOS Extras и поместите его в каталог <КОНЕЦ ВАШЕГО ПРОЕКТА>/Assets/Editor .
- Загрузите скрипт mod_pbxproj.py и скопируйте его в каталог редактора . Библиотеки теперь будут добавляться автоматически во время сборки.
Настройте префаб GAv3
Для настройки префаба GAv3 необходимы следующие шаги:
- Нажмите на префаб-объект
GAv3.prefab
, который можно найти в Assets/Plugins/GoogleAnalyticsV3 в представлении проекта . - В представлении «Инспектор» отобразится компонент «Сценарий» , прикрепленный к префабу, с несколькими перечисленными свойствами. Заполните эти свойства правильными значениями для вашего проекта. Это заполнит объект, чтобы его можно было использовать повсюду в вашем проекте. Например:
-
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
-
- Перетащите заполненный GAv3 из представления «Проект» вверх в иерархию объектов .
Отследить объект
После настройки префаба GAv3 вы готовы начать отслеживание объекта с помощью Google Analytics, выполнив следующие действия:
- Определите GameObject, который вы хотите отслеживать (например, объект Player), и щелкните его в представлении «Иерархия объектов» . Если у вас еще нет скрипта, прикрепленного к объекту, который вы хотите отслеживать, создайте новый скрипт, используя кнопку «Добавить компонент» в представлении «Инспектор» .
- Создайте общедоступную переменную в классе для хранения объекта GoogleAnalyticsV3. Например:
public GoogleAnalyticsV3 googleAnalytics;
- Сохраните скрипт и вернитесь в окно Unity.
- В представлении Inspector для GameObject , который вы хотите отслеживать, вы увидите созданный вами скрипт и поле для заполнения под названием Google Analytics (или выбранное вами имя переменной). Перетащите объект GAv3 из представления иерархии объектов в поле.
- Теперь вы готовы начать отслеживать этот GameObject . Повторите процесс для других объектов, которые вы хотите отслеживать, используя тот же префаб.
Следующие шаги
- Просмотрите Справочник по API , чтобы узнать, какие обращения вы можете отправлять в Google Analytics.
- Прочтите Руководство по внедрению мобильного приложения , чтобы узнать, как использовать Google Analytics для измерения взаимодействия с пользователем и ответа на вопросы об использовании игр.