事件分析
如果集成了支付中心并至少设置了以下帐户之一,可使用此功能:
如果用户授权使用所有Cookie或在GDPR横幅中同意使用分析和成效Cookie,则Google Analytics(分析)和Facebook会收集数据。
集成分析平台
要跟踪用户与支付UI交互时发生的事件,请在您的发布商帐户中连接分析平台:
Google Analytics(分析)
要连接分析平台:
- 在发布商帐户中打开您的项目。
- 前往支付中心 > 设置。
- 在应用部分中选择Google Analytics(分析)。
- 单击连接。
连接Google Analytics(分析)后,相应事件将发送到您的Facebook Analytics帐户。您可以在Google Analytics(分析)的
可跟踪以下事件:
操作 | 描述 |
---|---|
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 的页面(正在处理)。处理完成后,支付状态可能变为success 或error (成功)(错误)。 |
open-status-error | 打开支付状态为error 的页面(错误)。 |
open-status-success | 打开支付状态为success 的页面(成功)。 |
choose-method | 更多列表打开时选择一种支付方式。 |
维度ID | 名称 | 描述 |
---|---|---|
1 | version | 支付中心版本。 |
2 | purchase_invoice_id | 艾克索拉系统中的付款发票ID。 |
3 | external_id | 合作伙伴系统中的付款发票ID。 |
5 | total_sum | 总购买金额,包含所有费用。 |
6 | total_sum_currency | 总购买金额货币。 |
7 | pid | 付款系统的ID。 |
8 | projectId | 项目ID。 |
9 | country | 付款国家/地区。 |
10 | projectName | 项目的名称。 |
Facebook Analytics
要连接分析平台:
- 在发布商帐户中打开您的项目。
- 前往支付中心 > 设置。
- 在应用部分中选择Facebook Pixel。
- 单击连接。
连接Facebook Pixel后,相应事件将发送到您的Facebook Analytics帐户。您可以在Facebook Analytics的
可跟踪以下事件:
事件 | 描述 |
---|---|
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 的页面(正在处理)。处理完成后,支付状态可能变为success 或error (成功)(错误)。 |
open-status-error | 打开支付状态为error 的页面(错误)。 |
open-status-success | 打开支付状态为success 的页面(成功)。 |
choose-method | 更多列表打开时选择一种支付方式。 |
要集成分析平台:
- 前往发布商帐户 > 支付中心 > 设置。
- 在应用部分选择Google Analytics(分析)/Facebook Pixel。
- 输入您的跟踪ID,然后单击连接。
集成Google Analytics(分析)和Facebook Pixel后,相应的事件将发送到您的Google Analytics(分析)和Facebook Pixel帐户。
GameAnalytics
要连接分析平台:- 在发布商帐户中打开您的项目。
- 前往支付中心 > 设置。
- 在应用部分中选择GameAnalytics。
- 单击连接。
- 在GameAnalytics游戏密钥字段,输入游戏密钥。要在您的GameAnalytics帐户中找到该信息:
- 在顶部面板的下拉菜单中,选择该游戏。
- 在
Keys 部分点击Game key 旁边的复制图标。
- 单击连接。
目前,与GameAnalytics的集成可以让您接收成功支付事件的信息。该数据可在您GameAnalytics帐户的
支付UI事件
在iframe、新窗口或通过Pay Station Embed打开支付中心时,通过postMessage
机制处理支付界面事件。
处理通过postMessage
发送的消息的场景示例:
- 订阅接收通过
postMessage
发送的消息。 - 将事件数据解析为JSON格式。
- 实现检查是否存在需处理的事件。
收到所需事件后,实现处理该事件的逻辑。在下方示例中,文本是对主机的输出。您可以添加自己的逻辑。
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 | 以列的形式显示支付UI。value 参数可以是:
{“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的宽度和高度在width 和height 参数中传递。 |
error | 支付过程中发生的错误。错误代码在data.code 参数中传递,在支付UI中显示的错误描述在data.message 参数中显示。 |
external-link-open | 重定向到外部资源。重定向到的地址在url 参数中传递。 |
external-payment-open | 从支付UI重定向至外部支付系统或3-D Secure验证。 |
focus-change | 更改支付中心小组件的焦点元素。焦点状态在hasFocus 参数中传递,可以是true 或false 。 |
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 的页面(正在处理)。处理完成后,支付状态可能变为success 或error (成功)(错误)。 |
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-redeem | 在支付表单中兑换优惠券。 |
close | 关闭支付UI。 |
参数 | 类型 | 描述 |
---|---|---|
action | string | 事件名称。 |
value | string | 其他参数。包含根据用户选择而变的特定事件参数。 |
state | string | 支付UI页面,操作在该页面上完成。 |
date | string | GMT格式的日期和时间。 |
milliseconds | number | Unix时间格式的日期和时间。 |
timezone | string | 用户时区。 |
session_id | string | 会话ID。该会话包含30分钟内或支付UI关闭前用户进行的所有操作。会话从打开支付UI的一刻开始,并在支付UI页面刷新时保存。 |
payment_country | string | 付款国家/地区。 |
purchase_invoice_id | number | 艾克索拉系统中的付款发票ID。 |
purchase_external_id | string | 合作伙伴系统中的付款发票ID。 |
purchase_type | string | 购买类型。可以是virtual item 、virtual currency 、pay2play 、subscription 。 |
purchase_sum | number | 票面购买金额。 |
purchase_currency | string | 购买货币。 |
purchase_sku | string | 已购商品的SKU。 |
purchase_digital_content_sku | string | 已购游戏密钥套餐的SKU。 |
purchase_description | string | 购买描述。 |
virtual_currency_amount | number | 虚拟货币金额。 |
coupon_code | string | 优惠券代码。 |
subscription_package_external_id | number | 订阅ID。 |
subscription_package_name | string | 订阅名称。 |
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。