事件分析

如果集成了支付中心并至少设置了以下帐户之一,可使用此功能:

注意

如果用户授权使用所有Cookie或在GDPR横幅中同意使用分析和成效Cookie,则Google Analytics(分析)和Meta会收集数据。

集成分析平台

要跟踪用户与支付UI交互时发生的事件,请在您的发布商帐户中连接分析平台:

Google Analytics(分析)

要连接分析平台:

  1. 在发布商帐户中打开您的项目,然后前往付款 > 支付界面 > 设置部分。
  2. 应用部分中选择Google Analytics(分析)
  3. 单击连接

连接Google Analytics(分析)后,相应事件将发送到您的Google Analytics帐户。您可以在Google Analytics(分析)Engagement > Events > Top Events中找到这些事件。

可跟踪以下事件:

操作描述
open-{state_name}在支付UI中打开一个页面。
click-btn-pay在账单数据项目表单上单击立即支付
return单击返回商店/重新开始按钮。
create-invoice创建交易。
purchase创建一张发票(分配一个交易ID)。事件参数包含交易的详细信息,包括商品价格和税。参数描述见Google Analytics(分析)文档。

仅当在发布商帐户商品目录部分中配置了目录的前提下发送该事件。
open-payment-credit-card打开支付UI以输入卡片详情。
open-payment-saved-methods打开包含已保存的支付方式的页面。
open-payment-payment-methods点击更多时打开所有可用支付方式列表。
open-payment-{id}打开指定支付方式的页面,其中id是支付方式ID。
open-status打开支付状态页面。
open-status-processing打开支付状态为processing的页面(正在处理)。处理完成后,支付状态可能变为successerror(成功)(错误)。
open-status-error打开支付状态为error的页面(错误)。
open-status-success打开支付状态为success的页面(成功)。
choose-method更多列表打开时选择一种支付方式。
Google Analytics(分析)的自定义维度
维度ID名称描述
1version支付中心版本。
2purchase_invoice_id艾克索拉系统中的付款发票ID。
3external_id合作伙伴系统中的付款发票ID。
5total_sum总购买金额,包含所有费用。
6total_sum_currency总购买金额货币。
7pid付款系统的ID。
8projectId项目ID。
9country付款国家/地区。
10projectName项目的名称。

Meta Analytics

要连接分析平台:

  1. 在发布商帐户中打开您的项目,然后前往付款 > 支付界面 > 设置部分。
  2. 应用部分中选择Meta Pixel
  3. 单击连接

连接Meta Pixel后,相应事件将发送到您的Meta Ads Manager帐户。您可以在Meta Ads ManagerAdvertising settings > Datasets and pixels中找到这些事件。

可跟踪以下事件:

事件描述
open-{state_name}在支付UI中打开一个页面。状态名称包含在parameters中传递。
click-btn-pay在账单数据项目表单上单击立即支付。付款方式名称包含在parameters中传递。
return单击返回商店/重新开始按钮。状态名称包含在parameters中传递。
change-status-{status_name}更改付款状态。
如果用户关闭支付UI或离开页面,则状态即改变且不会发送事件消息。
create-invoice创建交易。
open-payment-credit-card打开支付UI以输入卡片详情。
open-payment-saved-methods打开包含已保存的支付方式的页面。
open-payment-payment-methods点击更多时打开所有可用支付方式列表。
open-payment-{id}打开指定支付方式的页面,其中id是支付方式ID。
open-status打开支付状态页面。
open-status-processing打开支付状态为processing的页面(正在处理)。处理完成后,支付状态可能变为successerror(成功)(错误)。
open-status-error打开支付状态为error的页面(错误)。
open-status-success打开支付状态为success的页面(成功)。
choose-method更多列表打开时选择一种支付方式。

集成Google Analytics(分析)Meta Pixel后,相应的事件将发送到您的Google Analytics(分析)和Meta Ads Manager帐户。

GameAnalytics

要连接分析平台:

  1. 在发布商帐户中打开您的项目,然后前往付款 > 支付界面 > 设置部分。
  2. 应用部分中选择GameAnalytics
  3. 单击连接

  1. GameAnalytics游戏密钥字段,输入游戏密钥。要在您的GameAnalytics帐户中找到该信息:
    1. 在顶部面板的下拉菜单中,选择该游戏。
    2. Keys部分点击Game key旁边的复制图标。

注:
如果您的游戏在多个平台上发布且GameAnalytics中对于它们各有专门的项目,可在发布商帐户中输入这些平台中任意一个的游戏密钥。

  1. 单击连接

目前,与GameAnalytics的集成可以让您接收成功支付事件的信息。该数据可在您GameAnalytics帐户的Monetization部分仪表板中找到。

支付UI事件

在iframe、新窗口或通过Pay Station Embed打开支付中心时,通过postMessage机制处理支付界面事件。

处理通过postMessage发送的消息的场景示例:

  1. 订阅接收通过postMessage发送的消息。
  2. 将事件数据解析为JSON格式。
  3. 实现检查是否存在需处理的事件。
  4. 收到所需事件后,实现处理该事件的逻辑。在下方示例中,文本是对主机的输出。您可以添加自己的逻辑。

示例:
Copy
Full screen
Small screen
1window.addEventListener('message', (event) => {
2  const eventData = JSON.parse(event.data);
3
4  if (eventData.command === 'open-payment') {
5    console.log('hello!')
6  }
7});
事件描述
add_saved_account保存支付帐户成功。
add_saved_account_error保存支付帐户时出错。
cancel_save_account用户取消了支付帐户的保存。
cart_display以列的形式显示支付UI。value参数可以是:
  • 1,如果支付UI打开为两列
  • 0,如果支付UI打开为一列,例如管理已保存支付方式的页面
示例{“command”:“cart_display”,“data”:{“value”:“1”,“version”:“Pay Station 4”}}
change-status更改付款状态。如果用户关闭支付UI或离开页面,则状态即改变且不会发送事件消息。
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中打开支付中心时,iframe的宽度和高度在widthheight参数中传递。
error支付过程中发生的错误。错误代码在data.code参数中传递,在支付UI中显示的错误描述在data.message参数中显示。
external-link-open重定向到外部资源。重定向到的地址在url参数中传递。
external-payment-open从支付UI重定向至外部支付系统或3-D Secure验证。
focus-change更改支付中心小组件的焦点元素。焦点状态在hasFocus参数中传递,可以是truefalse
open-{state_name}在支付UI中打开一个页面。
open-payment-credit-card打开支付UI以输入卡片详情。
open-payment-saved-methods打开包含已保存的支付方式的页面。
open-payment-payment-methods点击更多时打开所有可用支付方式列表。
open-payment-{id}打开指定支付方式的页面,其中id是支付方式ID。
open-status打开支付状态页面。
open-status-processing打开支付状态为processing的页面(正在处理)。处理完成后,支付状态可能变为successerror(成功)(错误)。
open-status-error打开支付状态为error的页面(错误)。
open-status-success打开支付状态为success的页面(成功)。
order-status将订单状态更改为done。如通过以下API调用之一创建了订单,则从支付状态页面发送该事件:
关于用户、交易及订单的数据在data对象中传递。

示例: {“command”:“order-status”,“data”:{“user_id”:“123abc-456”,“invoice_id”:123456,“price”:{“amount”:“12.96”,“currency”:“USD”},“order_id”:123456,“items”:[{“id”:123456,“sku”:“booster_min”,“quantity”:2,“amount”:“3.99”,“price”:{“amount”:“3.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:123456,“sku”:“boots_1”,“quantity”:1,“amount”:“2.99”,“price”:{“amount”:“2.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:1234567,“sku”:“xsolla_gloves”,“quantity”:1,“amount”:“1.99”,“price”:{“amount”:“1.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:12345678,“sku”:“reward_vp_a”,“quantity”:5,“amount”:“0”,“price”:{“amount”:“0”,“currency”:“USD”},“tax_category”:“DG00001”}],“version”:“Pay Station 4”}}
resize更改支付UI的大小。在data对象中传入打开的支付UI的宽和高。
示例{“command”:“resize”,“data”:{“dimensions”:{“width”:924,“height”:754},“version”:“Pay Station 4”}}
show-error-page打开一个错误页面。错误代码在value参数中传入。
status前往支付状态页。可传入以下参数:
  • status — 支付状态
  • email — 用户邮箱
  • invoice — 交易ID
  • virtualCurrencyAmount — 所购虚拟货币数量
  • userId — 用户ID
  • discount — 付款应用的折扣
status-redeem在支付表单中兑换优惠券。
close关闭支付UI。
事件参数通过postMessage发送的消息传递。如果尚未收集到参数信息,则会显示空字符串。
参数类型描述
actionstring事件名称。
valuestring其他参数。包含根据用户选择而变的特定事件参数。
statestring支付UI页面,操作在该页面上完成。
datestringGMT格式的日期和时间。
millisecondsnumberUnix时间格式的日期和时间。
timezonestring用户时区。
session_idstring会话ID。该会话包含30分钟内或支付UI关闭前用户进行的所有操作。会话从打开支付UI的一刻开始,并在支付UI页面刷新时保存。
payment_countrystring付款国家/地区。
purchase_invoice_idnumber艾克索拉系统中的付款发票ID。
purchase_external_idstring合作伙伴系统中的付款发票ID。
purchase_typestring购买类型。可以是virtual itemvirtual currencypay2playsubscription
purchase_sumnumber票面购买金额。
purchase_currencystring购买货币。
purchase_skustring已购商品的SKU。
purchase_digital_content_skustring已购游戏密钥套餐的SKU。
purchase_descriptionstring购买描述。
virtual_currency_amountnumber虚拟货币金额。
coupon_codestring优惠券代码。
subscription_package_external_idnumber订阅ID。
subscription_package_namestring订阅名称。
subscription_package_descriptionstring订阅描述。
total_sumnumber总购买金额,包含所有费用。
total_sum_currencystring总购买金额货币。
user_idstring用户ID (v1)。
user_countrystring用户所在国家/地区。
payment_instance_namestring付款方式名称。
事件链接到用户购买商品时执行的所有操作的页面。
状态描述
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(分析)Meta Ads Manager帐户,需先集成这些分析平台。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2025年9月19日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!
无法发送您的反馈
请稍后重试或发送邮件至doc_feedback@xsolla.com与我们联系。