В какой-то момент разработки своего игрового проекта возникает потребность в том, чтобы собирать статистику по нему. Ведь это позволит понять, что делает игрок, как думает игрок, во время использования нашей игры и даст нам возможность доработать какие-то моменты, укажет нам на вещи, которые раздражают игрока, покажет, что нравится ему и многое другое.

И тут встает выбор, какую именно систему аналитики выбрать. Выбор у нас достаточно приличный: собственная разработка 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, то могу написать отдельную статью, но не думаю, что нужно, там все до боли просто и интуитивно.