事件分析

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

注意

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

集成分析平台

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

Google Analytics（分析）

要连接分析平台：

  1. 在发布商帐户中打开您的项目。
  2. 前往支付中心 > 设置。
  3. 在应用部分中选择Google Analytics（分析）。
  4. 单击连接。

连接Google Analytics（分析）后，相应事件将发送到您的Facebook Analytics帐户。您可以在Google Analytics（分析）的Behaviour > 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的页面(正在处理)。处理完成后，支付状态可能变为success或error(成功)(错误)。
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项目的名称。

Facebook Analytics

要连接分析平台：

  1. 在发布商帐户中打开您的项目。
  2. 前往支付中心 > 设置。
  3. 在应用部分中选择Facebook Pixel。
  4. 单击连接。

连接Facebook Pixel后，相应事件将发送到您的Facebook Analytics帐户。您可以在Facebook Analytics的Business Settings > Measure & Report > Analytics > Pixels > Overview中找到这些事件。

可跟踪以下事件：

事件描述
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更多列表打开时选择一种支付方式。

要集成分析平台：

  1. 前往发布商帐户 > 支付中心 > 设置。
  2. 在应用部分选择Google Analytics（分析）/Facebook Pixel。
  3. 输入您的跟踪ID，然后单击连接。

集成Google Analytics（分析）和Facebook Pixel后，相应的事件将发送到您的Google Analytics（分析）和Facebook Pixel帐户。

GameAnalytics

要连接分析平台：
  1. 在发布商帐户中打开您的项目。
  2. 前往支付中心 > 设置。
  3. 在应用部分中选择GameAnalytics。
  4. 单击连接。

  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
    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参数可以是：
    • 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的宽度和高度在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 — 支付状态
    • 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 item、virtual currency、pay2play、subscription。
    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（分析）和Facebook Analytics帐户，需先集成这些分析平台。
    本文对您的有帮助吗？
    谢谢！
    我们还有其他可改进之处吗？ 留言
    非常抱歉
    请说明为何本文没有帮助到您。 留言
    感谢您的反馈！
    我们会查看您的留言并运用它改进用户体验。
    上次更新时间: 2024年10月3日

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

    报告问题
    我们非常重视内容质量。您的反馈将帮助我们做得更好。
    请留下邮箱以便我们后续跟进
    感谢您的反馈！