Google Analytics вместе с Unity3D09.08.2015 19:49

a26637202320435aad829468524d82ea.png

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

И тут встает выбор, какую именно систему аналитики выбрать. Выбор у нас достаточно приличный: собственная разработка Unity, Google Analytics, Appat, Flurry, Localitycs — и это лишь малая часть тех систем, что нам доступна. Кто хочет знать по какой причине была выбрана система аналитики от Google и как с ней работать, прошу под кат.

Выбор системы


Итак, перед нами предстает столь большое многообразие систем аналитики, но мною была взята Google Analytics, так почему же?

Причин достаточно много и вот основные из них:

  • Есть сборка под Unity3D
  • Хорошая документация
  • Простое API
  • Бесплатность
  • Работа с PC


И теперь мы можем все разобрать по пунктам, чтобы стало гораздо понятнее:

  • Сборка под Unity3D это всегда прекрасно, не нужно «танцевать с бубном» и что-то писать дополнительно для работы с плагином. Такой вещью может похвастаться далеко не каждая система аналитики, но у самых известных такая вещь присутствует.
  • Документация сделана на очень хорошем уровне, все считай расписано на 2 веб-страницах, интуитивно и понятно обьясняется настройка и дальнейшая работа с плагином. У других же систем либо нет документации конкретно на сборку под Unity3D, либо она есть, но оставляет желать лучшего.
  • C API можно разобраться даже не заходя в документацию, это все, что тут можно сказать. У других плагинов в основе большое нагромождение каких-то дополнительных вещей, для работы с плагином, чего нет у этой системы аналитики.
  • Что касается цены то тут все просто, у Google Analytics есть ограничение на количество отслеживаний в месяц, 1 миллион, весьма приличная цифра, особенно если ваше приложение не имеет многомиллионную аудиторию, то этого будет вполне достаточно, но если ваше приложения является таковым, то уже придется связываться с Google. Другие системы аналитики такого не могут предложить, обычно их ограничение на количество отслеживаний намного меньше, либо недоступны какие-то функция отслеживания, т.е. нельзя отследить покупки и т.д.
  • В этом пункте и разбирать нечего, многие системы аналитики могут банально не работать с PC и предназначены только для мобильных платформ.

Теперь примерно понятно, от чего была выбрана эта система аналитики, и сейчас мы можем приступить к этапу интеграции плагина в наше приложение.

Интеграция Google Analytics в проект


Первое наперво что нужно сделать, это скачать из репозитория наш плагин и вот что мы видим:

fd5b5e9f51474163906153db3726bc72.png

Нас интересует всего несколько вещей это собственно 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 нам еще понадобиться модифицировать манифест файл, добавив после тега такие строки:

С импортом файлов в проект и их настройкой покончено, теперь перейдем к настройкам внутри проекта и начнем с префаба GAv4.prefab, который находится по этому пути:
0ef633a79e6b4f908744b655069e0b96.png

Я расскажу лишь об основных настройках, которые нам понадобятся и вот какие:
7ff7599e16a54c9db8bfdd02086aabac.png

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, то могу написать отдельную статью, но не думаю, что нужно, там все до боли просто и интуитивно.

© Habrahabr.ru