虚拟物品

工作原理

虚拟物品是指用户可以使用真实货币或虚拟货币购买,或作为奖励获得的游戏内物品。这类物品没有实体形式,仅能在游戏内使用。常见的虚拟物品包括皮肤、药水、武器等影响游戏玩法或角色外观的元素。

主要功能:

  • 灵活的定价配置:
    • 为单个物品设置真实货币和/或虚拟货币价格。
    • 创建免费商品。
  • 自动检测用户的国家/地区和货币
  • 可用性配置:
    • 在特定区域限制商品销售
    • 限制可购买的物品数量
    • 限制物品在商店中的展示时间
    • 配置不可购买的物品。物品可以从目录中隐藏,但仍可作为捆绑包的一部分或作为其他物品的奖励提供
注:
虚拟物品可以在发布商帐户中创建、通过API调用创建,或通过导入目录创建。 本指南介绍如何手动创建虚拟物品以及如何使用API调用。有关创建其他物品类型的详细信息,请参见商品目录部分。
注:
虚拟物品可以在您的帐户中创建、通过API调用创建,或通过导入目录创建。 本指南介绍如何手动创建虚拟物品以及如何使用API调用。有关创建其他物品类型的详细信息,请参见商品目录部分。
注:
虚拟物品可以在移动端游戏专用帐户中创建、通过API调用创建,或通过导入目录创建。 本指南介绍如何手动创建虚拟物品以及如何使用API调用。有关创建其他物品类型的详细信息,请参见商品目录部分。

设置方法

在发布商帐户中设置

注:
在配置物品之前,建议先创建组,以便对物品进行分类并管理它们在商店中的显示方式。

在您的帐户中设置

注:
在配置物品之前,建议先创建组,以便对物品进行分类并管理它们在商店中的显示方式。
  1. 在发布商帐户中打开项目,前往Items catalog > All items > Virtual items部分。
  1. 在帐户中打开项目,前往Items catalog > All items > Virtual items部分。
  1. 在帐户中打开项目,前往Items catalog > All items > Virtual items部分。
  1. 在帐户中打开项目,前往Items catalog > All items > Virtual items部分。
  1. 在移动游戏专用帐户中打开项目,并前往Catalog部分。
  1. 点击Create manually,并在下拉列表中选择Virtual item。
  1. 在General settings部分,指定以下内容:
    • SKU
    • 商品所属的一个或多个组(可选)
    • 名称
    • 简短描述
    • 详细描述⸺如需添加,请打开对应开关(可选)
  1. 在Media部分,上传一张或多张图片或视频(可选)⸺可从设备上传,也可通过链接添加。对于使用艾克索拉建站器创建的商店,所有商品卡片都会显示标记为Main的文件;其余文件仅会显示在带媒体库的商品卡片中。标记为Main的文件也会在商品目录获取API调用的响应中返回。
  1. 在Price settings部分,设置商品价格或创建免费商品:
    • 如需设置价格,请选择Paid item,打开Pricing in real currency和/或Pricing in virtual currency开关,并指定价格。如有需要,可配置区域价格。
    • 如需创建免费商品,请选择Free item。
注:

一个商品可以设置多个真实货币价格和多个虚拟货币价格。在这种情况下,需要分别为两类货币指定默认货币⸺从真实货币中选择一种,从虚拟货币中选择一种。

只有项目中已创建对应虚拟货币时,才能使用该虚拟货币设置价格。

  1. 如需限制商品的可购买数量:
    1. 在Limits部分打开开关并指定数量。
    2. 配置限制重置频率。请从下拉列表中选择一个周期:
      1. Daily。
      2. Weekly。
      3. Monthly。
      4. Custom interval。间隔从商品在商店中的展示开始日期起计算。
      5. No regular refresh。
    3. 根据所选周期设置重置计划,并填写对应参数。
注:
默认情况下,达到购买限制后,商品会从商品目录中隐藏。如果已配置自动重置限制,勾选Show item even after users reach the purchase limit复选框后,可让商品保持可见,直到下一个重置周期开始。
  1. 配置商品的显示时间限制(可选):

    1. 在Add specific display period部分打开开关。
    2. 指定时区以及该时间段的开始和结束时间。

    如不需要指定商品显示期的结束时间,请打开No end date开关。

注:
如需为目录中的该商品添加另一个显示时间段,请点击+。如果一个商品有多个显示时间段,则每个时间段都必须设置结束日期。显示时间在指定分钟的最后一秒结束。例如,如果结束时间设置为12:00,显示时间将持续至12:00:59。
  1. 按以下任一方式配置属性(可选):
    1. 以JSON格式添加属性及属性值。
    2. 手动创建属性及属性值,并将其关联到商品。
  1. 如果该付费商品将用于包含随机奖励的玩法机制(如宝箱或扭蛋),请开启Mark as paid randomized reward开关。
注:
如果游戏在对这类玩法机制有法律限制的国家/地区分发,可能需要启用此参数。
  1. 点击Create。

  2. 在打开的窗口中,选择商品状态,然后点击Continue。

创建的商品会显示在All items部分。

通过API设置

要设置虚拟物品,可以使用虚拟物品和虚拟货币方法组中Admin子部分的调用。

注意
Admin子部分的调用不用于在前端构建商店目录。不要将其用于落地页、网页商城和游戏内逻辑。
任务API调用
创建虚拟物品。创建虚拟物品。
获取虚拟物品信息。获取虚拟物品。
获取虚拟物品列表。获取虚拟物品列表。
按指定组获取虚拟物品列表。在按指定组外部ID获取虚拟物品列表 API调用中传递参数external_id。
按组获取虚拟物品列表(管理端)。在按指定组ID获取虚拟物品列表 API调用中传递参数group_id。
更新虚拟物品。更新虚拟物品。
删除虚拟物品。删除虚拟物品。
限制可购买的虚拟物品数量。在创建虚拟物品或更新虚拟物品 API调用中传递以下参数:
  • limits — 指定可购买的虚拟物品的最大数量。
  • limits.recurrent_schedule — 定义重置该限制的频率。

在商店中显示虚拟物品

虚拟物品的显示方式取决于目录的实现方式——通过建站器或通过API。

通过建站器显示

要在您的网站上显示虚拟物品:

  1. 创建虚拟物品。

注:
要在建站器中显示虚拟物品,请提前创建组——虚拟物品只能作为组的一部分显示在商店目录中。
  1. 在发布商帐户的项目中,进入Storefronts > Websites部分。

  2. 在所需网站的窗格中,点击Open Site Builder。

  1. 在您的帐户的项目中,进入Storefronts > Websites部分。

  2. 在所需网站的窗格中,点击Open Site Builder。

  1. 在您的帐户的项目中,进入Storefronts > Websites部分。

  2. 在所需网站的窗格中,点击Open Site Builder。

  1. 在您的帐户的项目中,进入Storefronts > Websites部分。

  2. 在所需网站的窗格中,点击Open Site Builder。

  1. 在移动端游戏专用帐户的项目中,进入Web Shop部分。

  2. 点击所需网站的窗格。

  1. 如果网站包含多个页面,请选择需要的页面:

    1. 点击编辑器顶部的当前页面标题。
    2. 在下拉列表中选择所需页面。

  2. 在Store区块中,将Item type字段设为Virtual items,并在Item group字段中选择要在网站上销售的商品组。

  1. 设置商品卡片布局。

  2. 完成所有必要更改并准备发布网站后:

    1. 在建站器右上角,点击Publish。
    2. 勾选要发布的页面。
    3. 点击Publish。

注意

如果无法发布网站,请确保满足以下条件:

  • 网站中没有空白区段(以红色指示标记)。
  • 已与艾克索拉签署许可协议。
  • 已发布主页或已选择主页进行发布。在主页之前不能发布子页面。

网站发布后,将出现包含虚拟物品组的区段。如果未显示任何物品,请检查其状态是否为 Available,且未启用基于时间的显示限制。

通过API获取虚拟物品信息

要在客户端获取虚拟物品目录,请使用[虚拟物品和虚拟货币]方法组中Catalog子部分的方法。使用这些方法无需授权。

任务API调用
通过SKU获取虚拟物品。在通过SKU获取虚拟物品 API调用中传递参数item_sku。
获取虚拟物品列表。获取虚拟物品列表。
按指定组获取虚拟物品列表。在按指定组获取物品列表 API调用中传递参数external_id。
获取项目的全部虚拟物品列表。获取全部虚拟物品列表。

向用户发放虚拟物品

根据物品类型和集成设置,虚拟物品将通过以下方式之一发放给用户:

  • 如果已集成PlayFab,虚拟货币和虚拟物品会自动发放到用户的PlayFab物品库中。
  • 如果使用自定义发货系统,所有虚拟物品和虚拟货币都由您方发放。建议设置Webhook处理程序,在后端接收订单数据。所需数据包含在Successful payment for order Webhook中。

有关此方法以及其他获取购买数据的方法的更多信息,请参见设置订单状态跟踪部分。

本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。

有用链接

上次更新时间: 2026年7月6日

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

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