В этой статье описываются основные принципы использования плагина Google Analytics для Unity.
Подготовка
Прежде чем приступить к работе, выполните следующие действия:
- У вас должен быть хотя бы один ресурс Google Analytics и одно представление (профиль), в которые будут отправляться данные из вашей игры.
- Если вы собираетесь отслеживать Транзакции электронной торговли, включите показ этой статистики в отчетах.
- Скачайте пакет googleanalyticsv3.unitypackage из хранилища GitHub и импортируйте его в свой проект Unity (для этого нужно сделать двойной клик на файле).
Создание и настройка групп
Выберите платформу для которой хотите настроить конфигурацию.
- Если в директории (<КОРНЕВАЯ ПАПКА ПРОЕКТА>/Assets/Plugins/Android/ вашего проекта нет файла AndroidManifest.xml, создайте проект для Android и скопируйте этот файл из директории 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 и скопируйте его в директорию Editor. Библиотеки будут добавлены автоматически в процессе сборки.
Настройка объекта GAv3.prefab
Чтобы настроить объект GAv3.prefab, выполните следующие действия:
- Нажмите на объект
GAv3.prefab
, который находится в директории Assets/Plugins/GoogleAnalyticsV3 в окне Project view. - В окне 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
- Затем перетащите объект GAv3 из окна Project view в окно Object Hierarchy.
Отслеживание объекта
После настройки файла prefab GAv3 можно начинать отслеживание объекта при помощи Google Analytics. Для этого выполните следующие действия:
- Выберите объект GameObject, который нужно отслеживать (например, объект Player), и нажмите на него в окне Object Hierarchy. Если у вас ещё нет скрипта, связанного с этим объектом, создайте его, нажав кнопку Add Component в окне Inspector view.
- Создайте общедоступную переменную в классе для объекта GoogleAnalyticsV3. Пример:
public GoogleAnalyticsV3 googleAnalytics;
- Сохраните сценарий и вернитесь в окно Unity.
- В окне Inspector view для отслеживаемого объекта GameObject будет указан созданный вами скрипт и пустое поле Google Analytics (или название выбранной вами переменной). Перетащите объект GAv3 из окна Object Hierarchy в это поле.
- Теперь можно начинать отслеживание объекта GameObject. Повторите эти действия для других объектов, которые нужно отслеживать, используя тот же ресурс prefab.
Дополнительная информация
- В руководстве по API вы узнаете, какие обращения можно отправлять в Google Analytics.
- В руководстве по внедрению мобильных приложений описывается, как с помощью Google Analytics отслеживать взаимодействия пользователей, и даны ответы на вопросы по использованию игр.