Лаунчер / Как отправлять данные в Google Analytics
 На главную

Лаунчер

  • Руководство по интеграции

  • Возможности

  • Инструкции

  • Расширения

  • Справочники

    • Как отправлять данные в Google Analytics

    Содержание

    Как это работает

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

    ПолеОписание
    cidХеш MAC-адреса устройства.
    uidИдентификатор пользователя из JWT.
    Custom Dimension 1Платформа, с которой был запущен лаунчер.
    Custom Dimension 5Идентификатор сессии.
    ulЯзык лаунчера.
    Custom DimensionЭкран лаунчера. Возможные значения: Starting screen, Login screen, Game screen, Game store screen, Game news screen, Opened content screen, Settings screen, Custom tab screen.
    Custom Dimension 8Идентификатор игры:
    • ID из Личного кабинета, если лаунчер запущен автономно;
    • Steam App ID, если лаунчер запущен через Steam.
    anНазвание лаунчера.
    Custom Dimension 3Идентификатор проекта лаунчера.
    Custom Dimension 9Идентификатор проекта Авторизации.
    avВерсия лаунчера.
    Custom Dimension 4Версия сборки лаунчера.
    vpРазмер окна лаунчера.
    srРазрешение экрана.
    uaUser agent для определения операционной системы.
    Custom Dimension 12Идентификатор игры, к которой относится контент, из Личного кабинета. Если контент не связан с конкретной игрой, то поле будет пустым.

    Некоторые события могут содержать дополнительные поля, информация о них приведена в следующих таблицах. Ниже приведен список отправляемых событий, сгруппированных по типам.

    Общие события

    Event actionEvent categoryTrigger
    Successful launchLaunch eventЗапуск лаунчера. Не отправляется при запуске лаунчера после обновления.
    Successful launcher uninstallLauncher uninstallДеинсталляция лаунчера.
    Close AppClose eventЗакрытие лаунчера. Не отправляется при закрытии лаунчера перед обновлением.

    События UI

    Event actionec (GA)Trigger
    Open screenUI EventПользователь открыл экран лаунчера. Дополнительные поля:
    • Event Label — тип вкладки;
    • Event Value — название вкладки (для собственных вкладок).
    Push LogoutUI EventПользователь нажал Выйти.
    Push BuyUI EventПользователь нажал одну из кнопок в автономном лаунчере:
    • Купить игровой пакет на странице игры.
    • Купить предмет, цена которого выражена в виртуальной валюте, в магазине.
    • Добавить в корзину предмет, цена которого выражена в реальной валюте, в магазине.
    Дополнительное поле: Event Label — артикул предмета.

    События обновления лаунчера

    Event actionEvent categoryTrigger
    Checking update startLauncher Update EventЛаунчер начал проверку обновлений.
    Checking update finishLauncher Update EventЛаунчер закончил проверку обновлений. Дополнительное поле ev принимает значение update_found, если на CDN найдена более новая версия, чем на устройстве пользователя и no_updates, если нет.
    Skipping launcher updateLauncher Update EventПользователь пропустил обновление лаунчера.
    Downloading update startLauncher Update EventЛаунчер начал загрузку обновления.
    Downloading update finishLauncher Update EventЛаунчер закончил загрузку обновления.
    Launcher update readyLauncher Update EventЛаунчер закончил обновление.
    Launcher update successLauncher Update EventЛаунчер успешно обновлен.

    События владения игрой

    Event actionEvent categoryTrigger
    Game OwnershipOwnershipДополнительное поле: Event Label — идентификатор игры на платформе.

    События контента

    Event actionEvent categoryTrigger
    Article ViewUI EventБолее 75% контента отображено на экране пользователя. Для контента с типом группа событие не отправляется. Дополнительные поля:
    • Custom Dimension 6 — тип контента;
    • Custom Dimension 7 — тип баннера;
    • Custom Dimension 13 — идентификатор из Личного кабинета или Steam App ID игры, на которую ведет ссылка в контенте;
    • Element Label — URL-адрес, если тип контента — ссылка или видео.
    Article ClickUI EventПользователь нажал на элемент контента.

    События авторизации

    Event actionEvent categoryTrigger
    socialAuthorizationПользователь успешно авторизовался в лаунчере через социальную сеть.
    phoneAuthorizationПользователь успешно авторизовался в лаунчере без пароля с помощью телефона.
    emailAuthorizationПользователь успешно авторизовался в лаунчере без пароля с помощью электронной почты.
    xsolla_loginAuthorizationПользователь успешно авторизовался в лаунчере без пароля с помощью электронной почты с использованием хранилища данных пользователей Иксоллы.
    firebaseAuthorizationПользователь успешно авторизовался в лаунчер без пароля с помощью электронной почты с использованием хранилища данных пользователей Firebase.
    playfabAuthorizationПользователь успешно авторизовался в лаунчере без пароля с помощью электронной почты с использованием хранилища данных пользователей PlayFab.
    proxyAuthorizationПользователь успешно авторизовался в лаунчере без пароля с помощью электронной почты с использованием собственного хранилища данных пользователей.
    deviceAuthorizationПользователь успешно авторизовался в лаунчере через идентификатор устройства.
    server_custom_idAuthorizationПользователь успешно авторизовался в лаунчере через с помощью custom ID (ID пользователя, сформированный на вашем сервере).
    crossAuthorizationПользователь успешно авторизовался в лаунчере с помощью кросс-авторизации. Отправляется при каждом запуске.

    Как настроить

    1. Зарегистрируйтесь в Google Analytics и войдите в ваш аккаунт.
    2. Настройте собственные измерения в Google Analytics как показано в таблице ниже.

    IndexNameScope
    1PlatformSession
    2Is_test. Служебное поле для внутреннего использования Иксоллой.Session
    3Launcher_idSession
    4Launcher build numberSession
    5SessionSession
    6Article idSession
    7Article typeSession
    8Active game idSession
    9Login project idSession
    10Target analytic gameSession
    11PAv4 label ID. Служебное поле для внутреннего использования Иксоллой.Session
    12Game publisher project idSession
    13Target game idSession

    1. Нажмите Admin в боковом меню.
    2. В разделе Property выберите Tracking info > Tracking code и скопируйте ваш Tracking ID.
    3. Откройте ваш проект в Личном кабинете.
    4. Нажмите Лаунчер в боковом меню.
    5. Найдите нужный лаунчер на дашборде и нажмите Редактировать.
    6. Перейдите в раздел Настройки > Общая информация > Аналитика.
    7. Вставьте Tracking ID, скопированный ранее, в поле Google Analytics Tracking ID.
    8. Нажмите Сохранить изменения.

    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Оценить страницу
    Оценить страницу
    Что может сделать страницу еще лучше?

    В другой раз

    Спасибо за обратную связь!
    Последнее обновление: 10 февраля 2023

    Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

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