Statistic

Материал из wiki.appsalutecreator.com
Перейти к: навигация, поиск
Statistic 4.png

Объект Statistic предназначен для отправки игровых событий на сервер статистики. Для работы объекту нужны ссылки на объекты экономики и опций.

Также в проекте должен быть объект для отправки статистики.

Важно! Все параметры нужно указывать через объект Statistic. Механизм отправки статистики с непосредственным указанием параметров объекту statesender является устаревшим и приводит к появлению ворнингов.

Для настройки событий нужно открыть окно объекта (двойной клик по объекту в дереве проекта или на области свойств)

Окно настройки событий событий

Statistic 1.png

В данном окне мы можем добавлять и редактировать группы для событий и сами события.

Statistic 5.png
Statistic 6.png
Statistic 7.png
Statistic 8.png



















Каждое событие может иметь произвольное количество параметров, которое ограничено сервисом статистики, куда отправляются данные. Каждое событие может включать статические и пользовательские параметры. Пользовательские параметры добавляются как подобъекты события. Статические события выбираются из списка слева

Statistic 3.png

Свойства события

  • имя события
  • приоритет - глобальный фильтр для событий, при указании конкретного значения события с меньшим приоритетом отправляться не будут.
  • одноразовое - Отправлять событие только один раз.
  • префикс при первом - префикс при первом отправлении данного события.

receiver - Система статистики, которой нужно отправлять события.

  • Flurry
  • AppStat
  • Google
  • Amazon

static_events - Статические параметры событий

  • exp - опыт внутри уровня.
  • level - уровень игрока.
  • xplevel - уровень игрока.
  • res1 - количество ресурса 1.
  • coins_left - количество ресурса 1.
  • res2 - количество ресурса 2.
  • diams_left - количество ресурса 2.
  • en - текущая энергия
Statistic 2.png
  • res1log - логарифмический остаток монет.
  • res1logfl - логарифмический остаток монет.
  • coins_left_log - логарифмический остаток монет.
  • res1sp - количество потраченного ресурса 1.
  • res2sp - количество потраченного ресурса 2.
  • res1ea - количество заработанного ресурса 1.
  • res2ea - количество заработанного ресурса 2.
  • t_log_ses - 24 * log(время сессии).

Также для всех событий автоматически добавляются параметры t_log_cal и t_log_play, которые представляют логарифмическое календарное и игровое время. Также для всех событий можно добавить пользовательский параметр, который будет добавляться автоматически.

Использование объекта

Для того, что бы отправить событие объекту Statistic нужно вызвать состояние, соответствующие имени события. (На пример для события указанного на рисунке нужно вызвать состояние my_event). Следовательно имя каждого события должно быть уникально.

Иногда возникает необходимость отправлять несколько событий, которые отличаются частью имени. Что бы не добавлять несколько событий можно использовать заменяемую часть имени. Вместо части, которую мы будем заменять, нужно указать %r%. Перед отправкой данного события объекту нужно установить в параметр replace_string строку, на которую мы заменим %r%.

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

Автособытия get и use

Отправляется автоматически каждый раз, когда происходит начисление предметов из экономики (покупка, добавление). Событие автоматически оправляет параметры source, num и id начисляемого предмета.

Если нужно отправлять дополнительные параметры или изменять стандартные, нужно в объекте статистики создать событие get_%r%.

%r% будет заменен на название категории (как в автособытии). Каждый предмет в экономике должен относиться к какому-то определенному фильтру, иначе событие будет отправляться без категории. В событие нужно добавить обязательные параметры source, num и id, соответственно параметры "flurry_add_item_source", "flurry_add_item_num" и "flurry_add_item_id" у самого статистического объекта.

Если нужно изменить, что попадало в параметры "source" и "num" автособытия, то нужно записывать в "flurry_add_item_source", "flurry_add_item_num" самого статистического объекта перед вызовом события.


Заполнение параметров source, num и id при отправке события get_%r%:

1) если там пусто - заполнится автоматически.

2) если там не пусто - отправится заполненное значение.

3) после отправки события пишется пустая строка. (Поэтому параметры нужно прописывать для каждого add_param).


Заведенное в объекте статистики событие get_%r% отправляется вместо автособытия.

Дефолтное событие use_%r% имеет параметры: id, exp_level, t_log_cal, t_log_play. Так же можно добавить ивент в объект статистики для добавления других параметров.

События для рекламы

Заполняются и отправляются автоматически. Нужно лишь завести в объекте ивенты adConfigLoaded, adLoaded, adStart и adShowSuccess.

Пример

S:\!MOBILE\!!!EditorGames\Wiki_sample

Statistic_test.zip