Аналитика событий
Вы можете использовать эту функцию, если у вас уже подключен продукт Pay Station и настроен хотя бы один сервис аналитики: Google Analytics или Facebook Ads/Facebook Analytics.
Интеграция с сервисами аналитики
Подключите Google Analytics или Facebook Pixel в Личном кабинете, чтобы отслеживать события, связанные с действиями пользователей в платежном интерфейсе.
Вы можете отслеживать следующие события:
Google Analytics
| Действие | Описание |
|---|---|
| open-{state_name} | Открытие страницы платежного интерфейса. |
| click-btn-pay | Нажатие на кнопку Оплатить на форме ввода платежных данных. |
| return | Нажатие на кнопку Вернуться в магазин/Начать заново. |
| create-invoice | Создание транзакции. |
| open-payment-credit-card | Открытие платежного интерфейса для ввода данных карты. |
| open-payment-saved-methods | Открытие страницы с сохраненными способами оплаты. |
| open-payment-payment-methods | Открытие списка всех доступных способов оплаты при нажатии Еще. |
| open-payment-{id} | Открытие страницы определенного способа оплаты, где id — ID способа оплаты. |
| open-status | Открытие страницы статуса платежа. |
| open-status-processing | Открытие страницы статуса платежа в статусе обработки (processing). После завершения обработки платежа статус может измениться на успешный (success) или ошибку (error). |
| open-status-error | Открытие страницы статуса платежа в статусе ошибки (error). |
| open-status-success | Открытие страницы статуса платежа в успешном статусе (success). |
| choose-method | Выбор способа оплаты при переходе из списка Еще. |
Специальные параметры и показатели Google Analytics
| Показатель | Название | Описание |
|---|---|---|
| 1 | version | Версия платежного интерфейса. |
| 2 | purchase_invoice_id | ID заявки на оплату в системе Xsolla. |
| 3 | external_id | ID заявки на оплату в системе партнера. |
| 4 | purchase_sku | Артикул товара в покупке. |
| 5 | total_sum | Итоговая сумма покупки с учетом всех комиссий. |
| 6 | total_sum_currency | Валюта итоговой суммы покупки. |
| 7 | pid | ID платежной системы. |
| 8 | projectId | ID проекта. |
| 9 | country | Страна платежа. |
| 10 | projectName | Название проекта. |
| 12 | purchase_sku_digitalContent | Артикул пакета игровых ключей в покупке. |
Facebook Analytics
| Событие | Описание |
|---|---|
| open-{state_name} | Открытие страницы платежного интерфейса. В parameters передается название страницы. |
| click-btn-pay | Нажатие на кнопку Оплатить на форме ввода платежных данных. В parameters передается название платежного метода. |
| return | Нажатие на кнопку Вернуться в магазин/Начать заново. В parameters передается статус платежа. |
| change-status-{status_name} | Смена статуса платежа. Если пользователь закрывает страницу или платежный интерфейс и статус меняется после закрытия, сообщение о событии не отправляется. |
| create-invoice | Создание транзакции. |
| open-payment-credit-card | Открытие платежного интерфейса для ввода данных карты. |
| open-payment-saved-methods | Открытие страницы с сохраненными способами оплаты. |
| open-payment-payment-methods | Открытие списка всех доступных способов оплаты при нажатии Еще. |
| open-payment-{id} | Открытие страницы определенного способа оплаты, где id — ID способа оплаты. |
| open-status | Открытие страницы статуса платежа. |
| open-status-processing | Открытие страницы статуса платежа в статусе обработки (processing). После завершения обработки платежа статус может измениться на успешный (success) или ошибку (error). |
| open-status-error | Открытие страницы статуса платежа в статусе ошибки (error). |
| open-status-success | Открытие страницы статуса платежа в успешном статусе (success). |
| choose-method | Выбор способа оплаты при переходе из списка Еще. |
Для подключения сервиса аналитики:
- Перейдите в Личный кабинет > Pay Station > Настройки.
- В разделе Приложения выберите Google Analytics/Facebook Pixel.
- Укажите ID сервиса аналитики и нажмите Подключить.
Когда вы интегрируете Google Analytics и Facebook Pixel, соответствующие события будут отправляться в ваши учетные записи Google Analytics и Facebook Analytics.
Информация о событиях хранится:
- Google Analytics: Behaviour > Events > Top Events
- Facebook Analytics: Business Settings > Measure & Report > Analytics > Pixels > Overview
События платежного интерфейса
События платежного интерфейса обрабатываются с помощью механизма postMessage, если платежный интерфейс открывается в iframe, новом окне или с помощью скрипта Pay Station Embed.
Пример сценария обработки сообщений, отправленных через postMessage:
- Подпишитесь на получение сообщений, отправленных через
postMessage. - Осуществите парсинг данных по событию в формат JSON.
- Реализуйте проверку на наличие события, которое необходимо обработать.
- При получении нужного события реализуйте логику его обработки. В примере ниже в консоль выводится текст. Вы можете добавить свою логику.
Пример:
Copy
window.addEventListener('message', (event) => {
const eventData = JSON.parse(event.data);
if (eventData.command === 'open-payment') {
console.log('hello!')
}
});| Событие | Описание |
|---|---|
| add_saved_account | Успешное сохранение платежного аккаунта. |
| add_saved_account_error | Ошибка при сохранении платежного аккаунта. |
| cancel_save_account | Отмена пользователем сохранения платежного аккаунта. |
| cart_display | Отображение платежного интерфейса в виде колонок. В параметре value передается:
{"command":"cart_display","data":{"value":"1","version":"Pay Station 4"}}. |
| change-status | Смена статуса платежа. Если пользователь закрывает страницу или платежный интерфейс и статус меняется после закрытия, сообщение о событии не отправляется. |
| choose-method | Выбор способа оплаты при переходе из списка Еще. |
| click-custom-package-continue | Нажатие на кнопку Далее при покупке произвольного количества виртуальной валюты. |
| click-comment | Нажатие на кнопку для отправки комментария. |
| click-buy-package | Нажатие на кнопку Купить при покупке пакета виртуальной валюты. |
| click-buy-gift-package | Нажатие на кнопку при покупке пакета виртуальной валюты в подарок. |
| click-buy-gift-custom-package | Нажатие на кнопку при покупке произвольного количества виртуальной валюты в подарок. |
| click-btn-pay | Нажатие на кнопку Оплатить на форме ввода платежных данных. |
| click-btn-continue | Нажатие на кнопку покупки подписки. |
| click-btn-apply | Нажатие на кнопку Далее при погашении купона. |
| click-btn-activate | Нажатие на кнопку Активировать при активации ключа. |
| click-btn-accept | Нажатие на кнопку покупки цифрового контента. |
| create-invoice | Создание транзакции. |
| dimensions | Открытие платежного интерфейса в iframe. В параметрах width и height передается ширина и высота iframe. |
| error | Возникновение ошибки во время совершения платежа. В параметре data.code передается код ошибки, в параметре data.message — описание ошибки, которое также отображается в платежном интерфейсе пользователю. |
| external-link-open | Переход на внешний ресурс. В параметре url передается адрес, по которому происходит переход. |
| external-payment-open | Переход из платежного интерфейса на внешнюю платежную систему или верификацию 3-D Secure. |
| focus-change | Изменение фокуса на элементах виджета платежного интерфейса. Состояние фокуса передается в параметре hasFocus, может принимать значение true или false. |
| open-{state_name} | Открытие страницы платежного интерфейса. |
| open-payment-credit-card | Открытие платежного интерфейса для ввода данных карты. |
| open-payment-saved-methods | Открытие страницы с сохраненными способами оплаты. |
| open-payment-payment-methods | Открытие списка всех доступных способов оплаты при нажатии Еще. |
| open-payment-{id} | Открытие страницы определенного способа оплаты, где id — ID способа оплаты. |
| open-status | Открытие страницы статуса платежа. |
| open-status-processing | Открытие страницы статуса платежа в статусе обработки (processing). После завершения обработки платежа статус может измениться на успешный (success) или ошибку (error). |
| open-status-error | Открытие страницы статуса платежа в статусе ошибки (error). |
| open-status-success | Открытие страницы статуса платежа в успешном статусе (success). |
| order-status | Изменение статуса заказа на done. Отправляется со страницы статуса платежа, если заказ был создан через один из следующих методов API: |
| resize | Изменение размера платежного интерфейса. В объекте data передаются ширина и высота открытого платежного интерфейса.Пример: {"command":"resize","data":{"dimensions":{"width":924,"height":754},"version":"Pay Station 4"}}. |
| show-error-page | Переход пользователя на страницу с ошибкой. В параметре value передается код ошибки. |
| status | Переход на страницу статуса платежа. Могут передаваться следующие параметры:
|
| status-redeem | Погашение купона на платежной форме. |
| widget-close | Закрытие платежного интерфейса. |
В каждом сообщении от postMessage передаются параметры события. Если информация по параметру еще не собрана, придет пустая строка.
| Параметр | Тип | Описание |
|---|---|---|
| action | string | Имя события. |
| value | string | Дополнительный параметр, содержит специфические параметры события, которые меняются в зависимости от выбора пользователя. |
| state | string | Страница платежного интерфейса, на которой совершено действие. |
| date | string | Дата и время в формате GMT. |
| milliseconds | number | Дата и время в формате Unix time. |
| timezone | string | Часовой пояс пользователя. |
| session_id | string | ID сессии. К сессии относятся действия пользователя на протяжении 30 минут или до момента закрытия платежного интерфейса. Сессия начинается с момента открытия платежного интерфейса и сохраняется при перезагрузке страницы, на которой открыт платежный интерфейс. |
| payment_country | string | Страна платежа. |
| purchase_invoice_id | number | ID заявки на оплату в системе Xsolla. |
| purchase_external_id | string | ID заявки на оплату в системе партнера. |
| purchase_type | string | Тип покупки. Может принимать значение: virtual item, virtual currency, pay2play, subscription. |
| purchase_sum | number | Номинальная сумма покупки. |
| purchase_currency | string | Валюта покупки. |
| purchase_sku | string | Артикул товара в покупке. |
| purchase_digital_content_sku | string | Артикул пакета игровых ключей в покупке. |
| purchase_description | string | Описание покупки. |
| virtual_currency_amount | number | Количество виртуальной валюты. |
| coupon_code | string | Код купона. |
| subscription_package_external_id | number | ID подписки. |
| subscription_package_name | string | ID подписки. |
| subscription_package_description | string | Описание подписки. |
| total_sum | number | Итоговая сумма покупки с учетом всех комиссий. |
| total_sum_currency | string | Валюта итоговой суммы покупки. |
| user_id | string | ID пользователя (v1). |
| user_country | string | Страна пользователя. |
| payment_instance_name | string | Название способа оплаты. |
События привязаны к страницам, на которых пользователь совершает действия при покупке.
| Шаг | Описание |
|---|---|
| cart | Страница с выбранным товаром и подтверждением покупки за виртуальную валюту. |
| coupon | Форма для ввода купона. |
| giftcard | Страница со списком подарочных карт (виджет Подарочные карты). |
| giftrecipient | Страница покупки товара в подарок. |
| history | Страница с историей покупок. |
| index | Служебная страница, на которую происходит переход при открытии приложения. Не отображается пользователю. |
| legal | Мобильная версия страницы со ссылками на юридические документы. |
| list | Список способов оплаты. |
| paybycash | Страница с выбором способа оплаты через терминалы (виджет Оплата наличными). |
| payment | Платежная форма. |
| paymentaccount | Страница с сохраненными платежными аккаунтами. |
| paymentreturn | Служебная страница, на которую происходит переход после оплаты в платежной системе, и с которой происходит дальнейший переход на страницу статуса. Не отображается пользователю. |
| pincart | Страница с выбором платформы для покупки цифрового контента. |
| pricepoint | Магазин с виртуальной валютой. |
| savedmethod | Список сохраненных способов оплаты. |
| shippingaddress | Форма заполнения адреса доставки. |
| status | Страница статуса. |
| subscription | Магазин с планами подписок. |
| subscriptionchange | Изменение плана подписки. |
| useraccount | Страница информации об аккаунте (имя пользователя, баланс) с настройкой Отключить шаг подтверждения для будущих покупок. |
| userinventory | Инвентарь пользователя. |
| usermenu | Мобильная версия страницы с меню пользователя. |
| usersubscription | Управление подписками пользователя. |
| usersubscriptioninfo | Страница с деталями подписки. |
| virtualitem | Магазин с виртуальными товарами. |
Чтобы отправлять события в ваши учетные записи Google Analytics и Facebook Analytics, необходимо настроить интеграцию с данными сервисами аналитики.
Была ли статья полезна?
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.Оценить страницу
Оценить страницу
В другой раз
Спасибо за обратную связь!
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.
