Подключение сервисов аналитики
Глоссарий
Событие
Действие пользователя, при совершении которого информация отправляется в систему Google Analytics 4.
Описание
Описание пользовательского действия, при совершении которого событие отправляется в систему Google Analytics 4.
Как это работает
Подключите аналитику к вашему сайту, чтобы отслеживать события, связанные с действиями пользователей на вашем сайте, а также события платежного интерфейса. Xsolla поддерживает автоматическую интеграцию с сервисом Google Analytics с возможностью получать расширенную аналитику событий сайта и платежного интерфейса. Кроме этого, вы можете подключить любой сервис аналитики с помощью Google Tag Manager и получать расширенный список событий вашего сайта и платежного интерфейса. Вы можете настроить аналитику с помощью:
- Google Analytics (автоматическая интеграция).
- Другого сервиса аналитики (требует настройки Google Tag Manager).
Внимание
Xsolla соблюдает международные стандарты защиты данных пользователей. При подключении сторонних сервисов аналитики могут собираться не все данные от пользователей ввиду законодательных актов GDPR и CCPA.
Чтобы сбор данных осуществлялся законно, нужно получить на него согласие пользователя. Пользователь может ознакомиться с условиями сбора данных в cookie-баннере. В зависимости от региона пользователя и ограничений законодательных актов, данные собираются в одном из следующих случаев:
- пользователь согласился на отслеживание и принял все файлы cookie;
- пользователь не отказался от отслеживания.
Также на сбор аналитики влияют:
- блокировщики рекламы — могут блокировать аналитические системы и препятствовать отслеживанию;
- браузеры — Safari, Firefox, Brave могут блокировать сторонние файлы cookie или ограничивать их отслеживание по умолчанию.
Подключение Google Analytics
Примечание
События, которые можно отслеживать на вашем сайте с помощью сервиса Google Analytics, перечислены в разделах События сайта и Ecommerce-cобытия.
- Создайте аккаунт Google Analytics с типом ресурсов Google Analytics 4.
- Получите ID сервиса:
- В боковом меню выберите пункт Администратор.
- На вкладке Администратор выберите необходимый аккаунт и ресурс.
- Перейдите в раздел Потоки данных.
- Нажмите на нужный поток данных.
- Скопируйте ID потока данных.
- В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
- В панели вашего сайта нажмите Настроить.
- Перейдите к разделу Приложения и в блоке 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.
- В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
- В разделе Сайты выберите ваш сайт и нажмите Настроить.
- Перейдите к разделу Приложения и в блоке 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 | Статус платежа. Возможные значения:
| Смена статуса платежа. Если пользователь закрывает страницу или платежный интерфейс и статус меняется после закрытия, сообщение о событии не отправляется. |
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 | Действие со списком. Возможные значения:
| Нажатие кнопки раскрытия или сворачивания списка ежедневных наград. |
События блока Система вознаграждений
| Имя события | Значение параметра | Значение параметра | Описание |
|---|---|---|---|
load | Rewards_landing | Тип цепочки наград. Возможные значения: | Загрузка системы вознаграждений для авторизованного пользователя. |
vp-added | Rewards_landing | Тип цепочки наград. Возможные значения: | Призовые баллы добавлены на баланс пользователя. |
step-achieved | Rewards_landing | Тип цепочки наград. Возможные значения: | Пользователь перешел на новый шаг системы вознаграждений. |
step-collected | Rewards_landing | Тип цепочки наград. Возможные значения: | Награда успешно получена. |
step-opened | Rewards_landing | Тип цепочки наград. Возможные значения: | Открытие модального окна шага при нажатии пользователем карточки шага. |
reward-tab-click | Rewards_landing | Тип цепочки наград. Возможные значения: | Переключение между цепочками наград при нажатии на вкладки. |
reward-button-open-auth | Rewards_landing | Тип цепочки наград. Возможные значения: | Открытие виджета авторизации или виджета ввода ID пользователя при нажатии пользователем кнопки получения награды на карточке шага. |
steps-scroll-right | Rewards_landing | Тип цепочки наград, на которую переключился пользователь. Возможные значения: | Прокрутка вправо по нажатию правой стрелки в слайдере шагов. |
steps-scroll-left | Rewards_landing | Тип цепочки наград. Возможные значения: | Прокрутка влево по нажатию левой стрелки в слайдере шагов. |
События корзины
| Имя события | Значение параметра | Значение параметра | Описание |
|---|---|---|---|
click-cart |
| – | Нажатие значка корзины в хедере. |
open-cart |
| – | Открытие модального окна корзины. |
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.
