В какой-то момент разработки своего игрового проекта возникает потребность в том, чтобы собирать статистику по нему. Ведь это позволит понять, что делает игрок, как думает игрок, во время использования нашей игры и даст нам возможность доработать какие-то моменты, укажет нам на вещи, которые раздражают игрока, покажет, что нравится ему и многое другое.
И тут встает выбор, какую именно систему аналитики выбрать. Выбор у нас достаточно приличный: собственная разработка Unity, Google Analytics, Appat, Flurry, Localitycs — и это лишь малая часть тех систем, что нам доступна. Кто хочет знать по какой причине была выбрана система аналитики от Google и как с ней работать, прошу под кат.
Выбор системы
Итак, перед нами предстает столь большое многообразие систем аналитики, но мною была взята Google Analytics, так почему же?
Причин достаточно много и вот основные из них:
- Есть сборка под Unity3D
- Хорошая документация
- Простое API
- Бесплатность
- Работа с PC
И теперь мы можем все разобрать по пунктам, чтобы стало гораздо понятнее:
- Сборка под Unity3D это всегда прекрасно, не нужно «танцевать с бубном» и что-то писать дополнительно для работы с плагином. Такой вещью может похвастаться далеко не каждая система аналитики, но у самых известных такая вещь присутствует.
- Документация сделана на очень хорошем уровне, все считай расписано на 2 веб-страницах, интуитивно и понятно обьясняется настройка и дальнейшая работа с плагином. У других же систем либо нет документации конкретно на сборку под Unity3D, либо она есть, но оставляет желать лучшего.
- C API можно разобраться даже не заходя в документацию, это все, что тут можно сказать. У других плагинов в основе большое нагромождение каких-то дополнительных вещей, для работы с плагином, чего нет у этой системы аналитики.
- Что касается цены то тут все просто, у Google Analytics есть ограничение на количество отслеживаний в месяц, 1 миллион, весьма приличная цифра, особенно если ваше приложение не имеет многомиллионную аудиторию, то этого будет вполне достаточно, но если ваше приложения является таковым, то уже придется связываться с Google. Другие системы аналитики такого не могут предложить, обычно их ограничение на количество отслеживаний намного меньше, либо недоступны какие-то функция отслеживания, т.е. нельзя отследить покупки и т.д.
- В этом пункте и разбирать нечего, многие системы аналитики могут банально не работать с PC и предназначены только для мобильных платформ.
Теперь примерно понятно, от чего была выбрана эта система аналитики, и сейчас мы можем приступить к этапу интеграции плагина в наше приложение.
Интеграция Google Analytics в проект
Первое наперво что нужно сделать, это скачать из репозитория наш плагин и вот что мы видим:
Нас интересует всего несколько вещей это собственно GoogleAnalyticsV4.unitypackage, файл из папки iOS Extras и из папки source библиотека для Android.
Итак, импортируем файлы из GoogleAnalyticsV4.unitypackage, файл из папки iOSExtras закидывайте в папку Editor в корне Assets, этот файл нужен будет для компиляции под iOS, о чем расскажу чуть позже и из папки source/Plugins скопируйте папку Android в папку Plugins, без этой библиотеки банально не будет ничего работать на платформе Android.
А теперь немного о компиляции под iOS. Тот файл, что мы перенесли из iOSExtras необходим, чтобы автоматом подключались библиотеки, необходимые для плагина, но так же нам нужен будет mod_pbxproj.py, который так же выкачиваем из репозитория, ссылка на который есть в документации Google Analytics. Его так же нужно поместить в папку Editor. Теперь автоматом будут подключаться все необходимые библиотеки, но нужно учесть, что это будет работать только тогда, когда вы компилируете из под Mac, в противном случае библиотеки в проект нужно будет подключать вручную.
Библиотеки, которые нужно подключить:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
Для настройки же под Android нам еще понадобиться модифицировать манифест файл, добавив после тега такие строки:
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
С импортом файлов в проект и их настройкой покончено, теперь перейдем к настройкам внутри проекта и начнем с префаба GAv4.prefab, который находится по этому пути:
Я расскажу лишь об основных настройках, которые нам понадобятся и вот какие:
Android Traking Code — код приложения, который вы получите, при создании приложения в Google Analytics, можете использовать как код под приложение, которые вы создали у себя в кабинете под Unity, так и чисто под Android
IOS Traking Code — код приложения, который вы получите, при создании приложения в Google Analytics, можете использовать как код под приложение, которые вы создали у себя в кабинете под Unity, так и чисто под IOS
OtherTraking Code — код приложения, который вы получите, при создании приложения в Google Analytics, можете использовать только код под приложение, которые вы создали у себя в кабинете под Unity
Product Name — имя продукта, которые вы указали при создании приложения
Bundgle Identifire — идентификатор приложения по типу com.company.name
Bundle Version — версия приложения
Немного о кодах отслеживания. Вы можете создать одно приложение, для отслеживания сразу со всех платформ, а можете под каждую платформу создать отдельное приложение. Коды имеют вид UA-XXXXXXX-1.
Это основные настройки, которые необходимо указать, остальные можно почерпнуть информацию из документации, ибо они не столь критичны для работы плагина.
Осталось лишь перенести префаб в сцену и можно приступать к работе. Тут уже все довольно просто, в пример приведу лишь один скрипт, который опишет всю суть работы с Google Analitycs.
using UnityEngine;
public class Analitycs : MonoBehaviour {
public GoogleAnalyticsV4 componentAnalitycs; //Компонент нашей системы аналатики
void Start () {
//Начинаем работу
componentAnalitycs.StartSession ();//Запускаем сессию
componentAnalitycs.LogEvent ("Default Category", "Default Action", "Default Description", 0L); //Оповещаем о событии
componentAnalitycs.LogException ("Description", false);//Оповещаем об ошибке
componentAnalitycs.LogItem ("ID", "Name", "SKU", "Category", 1.99, 0L);//Оповещаем об использовании или покупке предмета
componentAnalitycs.LogScreen ("Menu");//Оповещаем о том, в каком же экране сейчас находится игрок
componentAnalitycs.LogSocial ("FaceBook", "Rep", "Friends");//Оповещаем о социальных действиях
componentAnalitycs.LogTiming ("Category", 0L, "Time Game", "Time");//Фиксируем время, которое игрок потратил на то или иное действие
componentAnalitycs.LogTransaction ("ID", "Affil", 19.99, 1.00, 0.00);//Оповещаем о покупке игрока за реальные деньги
componentAnalitycs.StopSession (); //Закрываем сессию
}
}
Вот и все, теперь можно спокойно работать с системой аналитики. Если же интересна работа конкретно с личным кабинетом Google Analytics, то могу написать отдельную статью, но не думаю, что нужно, там все до боли просто и интуитивно.
