Подключение сервисов аналитики
Глоссарий
Событие
Описание
Как это работает
Подключите аналитику к вашему сайту, чтобы отслеживать события, связанные с действиями пользователей на вашем сайте, а также события платежного интерфейса. Xsolla поддерживает автоматическую интеграцию с сервисом Google Analytics с возможностью получать расширенную аналитику событий сайта и платежного интерфейса. Кроме этого, вы можете подключить любой сервис аналитики с помощью Google Tag Manager и получать расширенный список событий вашего сайта и платежного интерфейса. Вы можете настроить аналитику с помощью:
- Google Analytics (автоматическая интеграция).
- Другого сервиса аналитики (требует настройки Google Tag Manager).
Xsolla соблюдает международные стандарты защиты данных пользователей. При подключении сторонних сервисов аналитики могут собираться не все данные от пользователей ввиду законодательных актов GDPR и CCPA. Чтобы сбор данных осуществлялся законно, нужно получить на него согласие пользователя. Пользователь может ознакомиться с условиями сбора данных в cookie-баннере. В зависимости от региона пользователя и ограничений законодательных актов, данные собираются в одном из следующих случаев:
- пользователь согласился на отслеживание и принял все файлы cookie;
- пользователь не отказался от отслеживания.
Также на сбор аналитики влияют:
- блокировщики рекламы — могут блокировать аналитические системы и препятствовать отслеживанию;
- браузеры — Safari, Firefox, Brave могут блокировать сторонние файлы cookie или ограничивать их отслеживание по умолчанию.
Подключение Google Analytics
- Создайте аккаунт Google Analytics с типом ресурсов Google Analytics 4.
- Получите ID сервиса:
- В боковом меню выберите пункт Администратор.
- На вкладке Администратор выберите необходимый аккаунт и ресурс.
- Перейдите в раздел Потоки данных.
- Нажмите на нужный поток данных.
- Скопируйте ID потока данных.
В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
Выберите ваш сайт и нажмите Настроить.
В проекте в аккаунте для мобильных игр перейдите в раздел Webshop.
В панели вашего сайта нажмите значок ⋮ и выберите Настроить.
- Перейдите к разделу Приложения и в блоке Google Analytics нажмите Подключить.
- В модальном окне сервиса аналитики укажите ID сервиса аналитики и нажмите Подключить.
- В появившемся модальном окне нажмите Опубликовать.
Если публикация сайта недоступна, убедитесь, что соблюдаются все необходимые условия:
- Отсутствуют незаполненные разделы на сайте (отмечены красным кругом).
- Подписан Лицензионный договор с Xsolla.
- На сайт добавлен раздел с авторизацией пользователей.
Регистрация кастомных параметров событий
С помощью следующих кастомных параметров вы можете конкретизировать события в аналитике:
event_category— позволяет определить из какого блока отправлено событие.event_label— содержит данные события, такие как артикул товара, способ оплаты и другие.
Параметры event_category и event_label унаследованы от Universal Analytics и сохранены для обратной совместимости с существующими панелями. В Google Analytics 4 они передаются как пользовательские параметры событий и по умолчанию не отображаются в стандартных отчетах. Зарегистрируйте их в Google Analytics 4, чтобы использовать при построении воронок и пользовательских отчетов.
Чтобы зарегистрировать параметры событий:
В боковом меню выберите пункт Администратор.
На вкладке Администратор перейдите в раздел Специальные определения.
Нажмите Создать специальный параметр.
В поле Название параметра введите имя параметра, которое вы хотите видеть при построении воронки отслеживания событий.
Пример:
Category.В раскрывающемся списке Область действия выберите Событие.
В поле Описание введите описание (опционально).
В поле Параметр события введите название параметра —
event_categoryилиevent_label.Нажмите Сохранить.
Подключение других сервисов аналитики
- Создайте аккаунт в выбранном вами сервисе аналитики.
- Создайте аккаунт Google Tag Manager (аккаунт GTM).
- Настройте аккаунт GTM для вашей аналитической системы:
- Настройте теги.
- Настройте события и параметры.
- Опубликуйте изменения в GTM.
В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
В разделе Сайты выберите ваш сайт и нажмите Настроить.
В проекте в аккаунте для мобильных игр перейдите в раздел Web Shop.
В панели вашего сайта нажмите значок ⋮ и выберите Настроить.
- Перейдите к разделу Приложения и в блоке Google Tag Manager нажмите Подключить.
- Укажите ID контейнера GTM и нажмите Подключить. Чтобы найти ID контейнера, используйте инструкцию в окне ввода ID Как получить ID.
- Нажмите Подключить.
- В появившемся модальном окне нажмите Опубликовать.
События сайта
События сайта отражают действия пользователя на страницах сайта — нажатия кнопок, открытие виджетов, прокрутку слайдеров и т. д. События содержат только название и кастомные параметры event_category и event_label.
Если вам нужны подробные данные о покупках, см. раздел Ecommerce-cобытия — эти события содержат полный контекст: суммы и валюты покупок, артикулы товаров, способы оплаты, ID транзакций и т. п.
События платежного интерфейса
| Имя события | Значение параметра open | Paystation_landing | Название страницы. | Открытие страницы платежного интерфейса. | | close | Paystation_landing | Название страницы. | Закрытие страницы платежного интерфейса. | | share | Paystation_landing | Название социальной сети. | Нажатие кнопки, чтобы поделиться в социальной сети. | | payment_method_name | Paystation_landing | Название выбранного способа оплаты. | Нажатие кнопки Оплатить на форме ввода платежных данных. | | choose-widget | Paystation_landing | Название виджета способа оплаты. | Нажатие виджета способа оплаты. | | choose-method | Paystation_landing | Название способа оплаты. | Выбор способа оплаты. | | change-status | Paystation_landing |
Статус платежа.
Возможные значения:
created— платеж создан;processing— платеж в обработке;done— платеж успешно завершен;error— ошибка платежа.
purchase-success | Paystation_landing | done | Успешный платеж. Аналогично событию change-status, но отправляется только в случае статуса done. |События блока Хедер
open-login | Header_landing | – | Открытие виджета авторизации при нажатии кнопки авторизации. | | open-uid-widget | Header_landing | – | Открытие виджета ввода ID при нажатии кнопки авторизации. | | click-buy | Header_landing | Артикул товара. | Нажатие кнопки покупки. | | click-googleplay | Header_landing | – | Нажатие кнопки со ссылкой на Google Play. | | click-appstore | Header_landing | – | Нажатие кнопки со ссылкой на App Store. | | click-user-account | Header_landing | – | Нажатие кнопки профиля авторизованного пользователя. | | open-menu | Header_landing | – | Открытие меню в мобильной версии сайта. | | logo-click | Header_landing | – | Нажатие логотипа в хедере. | | change_language | Header_landing | Код выбранного языка. | Переключение языка интерфейса (с обновлением страницы). | | logout | Header_landing | – | Выход из аккаунта. |События виджета ввода ID пользователя
close | UID_widget_landing | – | Закрытие модального окна для ввода ID. | | input | UID_widget_landing | – | Начало ввода значения в поле ввода ID. | | confirm | UID_widget_landing | – | Нажатие кнопки подтверждения ввода ID. | | click-instruction | UID_widget_landing | – | Нажатие ссылки или значка для отображения инструкции Где найти ID игрока. | | error | UID_widget_landing | – | Ошибка идентификации (неверно введенный ID). | | success_id | UID_widget_landing | Введенный пользователем ID. | Успешная идентификация. | | method-validation-start | UID_widget_landing | – | Старт серверной валидации входа после идентификации пользователя. | | authorization-success | UID_widget_landing | – | Успешная авторизация пользователя. | | authorization-by-social | UID_widget_landing | Название социальной сети. | Авторизация через социальную сеть. | | close-instruction | UID_widget_landing | – | Закрытие модального окна с инструкцией Где найти ID игрока. | | deeplink-click | UID_widget_landing | – | Переход по диплинку для входа в приложение. | | qr-click | UID_widget_landing | – | Нажатие QR-кода. | | eye-click | UID_widget_landing | – | Отображение/скрытие значения в поле ввода ID пользователя. |События блока Игровые пакеты
click-buy | Packs_landing | Артикул товара. | Нажатие кнопки покупки. | | open-login | Packs_landing | – | Открытие виджета авторизации при нажатии кнопки покупки. | | open-uid-widget | Packs_landing | – | Открытие виджета ввода ID при нажатии кнопки покупки. | | click-googleplay | Packs_landing | – | Нажатие кнопки со ссылкой на Google Play. | | click-appstore | Packs_landing | – | Нажатие кнопки со ссылкой на App Store. |События блока Рекламный слайдер
click-buy | Promo_landing | Артикул товара. | Нажатие кнопки покупки на слайде. | | open-login | Promo_landing | – | Открытие виджета авторизации при нажатии кнопки покупки на слайде. | | open-uid-widget | Promo_landing | – | Открытие виджета ввода ID при нажатии кнопки покупки на слайде. | | click-googleplay | Promo_landing | – | Нажатие кнопки со ссылкой на Google Play на слайде. | | click-appstore | Promo_landing | – | Нажатие кнопки со ссылкой на App Store на слайде. | | enter-email | Promo_landing | – | Нажатие кнопки подтверждения email-адреса для подписки на новости. |События блока Магазин
auth | Store_landing_buy_button | – | Открытие модального окна авторизации после нажатия кнопки покупки неавторизованным пользователем. | | open-ps | Store_landing_buy_button | Артикул товара. | Инициализация платежного интерфейса после нажатия авторизованным пользователем кнопки покупки в карточке товара. | | auth | Store_landing_pop-up | – | Открытие модального окна авторизации после нажатия неавторизованным пользователем кнопки покупки в модальном окне товара. | | open | Store_landing_pop-up | Артикул товара. | Открытие модального окна товара. | | open-ps | Store_landing_pop-up | Артикул товара. | Инициализация платежного интерфейса после нажатия авторизованным пользователем кнопки покупки в модальном окне товара. |События блока Call-to-action
click-buy | CTA_landing | Артикул товара. | Нажатие кнопки покупки. | | open-login | CTA_landing | – | Открытие виджета авторизации при нажатии кнопки покупки. | | open-uid-widget | CTA_landing | – | Открытие виджета ввода ID при нажатии кнопки покупки. | | enter-email | CTA_landing | – | Нажатие кнопки подтверждения email-адреса для подписки на новости. |События блока Футер
social | Footer_landing | Название социальной сети. | Нажатие кнопки перехода в социальную сеть. |События блока Цепочка предложений
open-auth | Offer_chain_buy_button | Артикул товара. | Открытие модального окна авторизации после нажатия пользователем кнопки покупки. | | open-ps | Offer_chain_buy_button | Артикул товара. | Инициация платежного интерфейса после нажатия пользователем кнопки покупки в карточке товара. | | claim | Offer_chain_buy_button | Артикул товара. | Товар из цепочки предложений получен после нажатия пользователем кнопки на карточке товара. | | open-auth | Offer_chain_pop-up | Артикул товара. | Открытие модального окна авторизации после нажатия неавторизованным пользователем кнопки покупки в модальном окне товара. | | open-ps | Offer_chain_pop-up | Артикул товара. | Инициация платежного интерфейса после нажатия пользователем кнопки покупки в карточке товара. | | claim | Offer_chain_pop-up | Артикул товара. | Товар из цепочки предложений получен после нажатия пользователем кнопки в модальном окне товара. | | open | Offer_chain_pop-up | Артикул товара. | Открытие модального окна товара после нажатия пользователем на карточку товара. | | scroll-right | Offer_chain_landing | – | Прокрутка вправо по нажатию на правую стрелку в слайдере карточек цепочки предложений. | | scroll-left | Offer_chain_landing | – | Прокрутка влево по нажатию на левую стрелку в слайдере карточек цепочки предложений. |События блока Ежедневные награды
| Имя события | Значение параметра open-auth | Daily_reward_landing | – | Открытие виджета авторизации или виджета ввода ID пользователя при нажатии кнопки получения награды на карточке шага. | | open-ps | Daily_reward_landing | Артикул товара. | Получение ежедневной награды. | | expand | Daily_reward_landing |
Действие со списком.
Возможные значения:
more— раскрытие списка;less— сворачивание списка.
События блока Система вознаграждений
| Имя события | Значение параметра load | Rewards_landing |
Тип цепочки наград.
Возможные значения: standard, clan.
vp-added | Rewards_landing |Тип цепочки наград.
Возможные значения: standard, clan.
step-achieved | Rewards_landing |Тип цепочки наград.
Возможные значения: standard, clan.
step-collected | Rewards_landing |Тип цепочки наград.
Возможные значения: standard, clan.
step-opened | Rewards_landing |Тип цепочки наград.
Возможные значения: standard, clan.
reward-tab-click | Rewards_landing |Тип цепочки наград.
Возможные значения: standard, clan.
reward-button-open-auth | Rewards_landing |Тип цепочки наград.
Возможные значения: standard, clan.
steps-scroll-right | Rewards_landing |Тип цепочки наград, на которую переключился пользователь.
Возможные значения: standard, clan.
steps-scroll-left | Rewards_landing |Тип цепочки наград.
Возможные значения: standard, clan.
События корзины
| Имя события | Значение параметра click-cart |
Header_landing — для Web Shop с типом Одностраничный магазин.
Remote_block_landing — для Web Shop с типом Многостраничный веб-портал.
open-cart | <p>Header_landing— для Web Shop с типом **Одностраничный магазин**.</p><p> Remote_block_landing— для Web Shop с типом **Многостраничный веб-портал**.</p> | – | Открытие модального окна корзины. | |close-cart|Cart_landing| – | Закрытие модального окна корзины. | |change-item-quantity|Cart_landing| Артикул товара. | Изменение количества товара в корзине. | |input-code|Cart_landing| – | Применение промокода в корзине. | |error_code|Cart_landing| Код ошибки (например,9811). | Ошибка применения промокода. | | delete|Cart_landing| Артикул товара. | Удаление товара из корзины. | |checkout|Cart_landing| – | Оформление заказа и открытие платежного интерфейса. | |back-to-store|Cart_landing| – | Возврат в магазин из пустой корзины. | |clear|Cart_landing| – | Очистка корзины (нажатие кнопки **Удалить все**). | |continue|Cart_landing| – | Возврат в магазин из корзины (нажатие кнопки **Продолжить покупки**). | |click-checkout|Cart_landing| – | Нажатие кнопки оформления заказа. | |confirm_code|Cart_landing| – | Подтверждение ввода промокода. | |remove-code|Cart_landing| – | Удаление примененного промокода. | |discount-cart|Cart_landing| – | Применение скидки на всю корзину. | |discount-item|Cart_landing| – | Применение скидки на отдельный товар. | |warning-delete|Cart_landing| – | Показ предупреждения перед удалением товара. | |close-warning|Cart_landing| – | Закрытие предупреждения об удалении товара. | |authorization-modal-open-in-cart|Cart_landing` | – | Открытие окна авторизации при оформлении заказа или применении промокода пользователем. |События кастомных action-элементов и навигации
click-link | Динамическая категория (зависит от блока). | – | Переход по ссылке или нажатие кнопки со ссылкой в блоке. | | click-page | Динамическая категория (зависит от блока). | – | Переход на другую страницу сайта при нажатии кнопки. | | click-scroll | Динамическая категория (зависит от блока). | – | Нажатие кнопки прокрутки к определенному блоку. | | click-more-info | Динамическая категория (зависит от блока). | – | Нажатие кнопки Подробнее. | | open-video | Динамическая категория (зависит от блока). | – | Открытие видео в lightbox. | | click-subscription | Динамическая категория (зависит от блока). | – | Нажатие кнопки для подписки на новости. | | input-email | Динамическая категория (зависит от блока). | – | Ввод email-адреса в форме подписки на новости. |Ecommerce-события
Платежный интерфейс Xsolla загружается в отдельном iframe со своим доменом и собственной аналитикой. С лендинга отправляются только события инициализации и завершения оплаты. Детальные данные о ходе оплаты передаются как ecommerce-события.
| Событие | Описание |
|---|---|
open-paystation | Открытие платежного интерфейса. Отправляется при инициализации. |
open-{state_name} | Открытие страницы платежного интерфейса. |
open-payment-credit-card | Открытие платежного интерфейса для ввода данных карты. |
open-payment-saved-methods | Открытие страницы с сохраненными способами оплаты. |
open-payment-payment-methods | Открытие списка всех доступных способов оплаты при нажатии Еще. |
open-payment-{id} | Открытие страницы определенного способа оплаты, где id — ID способа оплаты. |
open-external-pages | Открытие внешних страниц из платежного интерфейса. |
open-status | Открытие страницы статуса платежа. |
open-status-processing | Открытие страницы статуса при обработке платежа (processing). После завершения обработки платежа статус может измениться на успешный (success) или ошибку (error). |
open-status-error | Открытие страницы статуса при ошибке платежа (error). |
open-status-success | Открытие страницы статуса при успешном платеже (success). |
choose-payment-widget | Выбор виджета способа оплаты. |
choose-method | Выбор способа оплаты. |
click-btn-pay | Нажатие кнопки Оплатить на форме ввода платежных данных. |
click-btn-return-url | Нажатие кнопки возврата в магазин (Вернуться в игру). |
click-additional-btn-return-url | Нажатие дополнительной кнопки возврата в магазин. |
create-invoice | Создание транзакции. Трансформируется в событие purchase с дополнительными параметрами покупки (товары, сумма, валюта). |
purchase | Совершение покупки. Событие отправляется при создании счета на оплату и содержит детальную информацию о покупке, включая стоимость товаров и налоги. Событие отправляется только если вы настроили каталог товаров в Личном кабинете. |
change-status | Изменение статуса платежа. Отправляется с дополнительным параметром status. |
Общие параметры события (отправляются с каждым событием):
| Параметр | Описание |
|---|---|
category | Всегда paystation. |
version | Версия платежного интерфейса. |
projectId | ID проекта. |
projectName | Название проекта. |
user_id | ID пользователя. |
v1 | ID пользователя (дублирует user_id). |
country | Код страны платежа. |
external_id | Внешний ID (при наличии). |
purchase_invoice_id | ID заявки на оплату в системе Xsolla. |
pid | ID платежной системы в Xsolla |
total_sum | Итоговая сумма покупки с учетом всех комиссий. |
total_sum_currency | Валюта итоговой суммы покупки. |
purchase_sku | Артикул товара. |
purchase_sku_digitalContent | Артикул цифрового контента. |
Дополнительные параметры события purchase:
| Параметр | Описание |
|---|---|
transaction_id | ID транзакции. |
currency | Валюта. |
value | Сумма без налогов. |
items | Массив товаров с параметрами:
|
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.
