如何在目录中组合及排列商品

您可以将商品添加到组中来创建多级目录。组可以包含相同或不同类型的商品:

  • 虚拟物品
  • 虚拟货币
  • 虚拟货币套餐
  • 捆绑包
  • 游戏密钥
在组中,您可以按一定顺序排列商品以增加销量及向用户展示热门商品。按组请求商品时,将按照商品在发布商帐户中的顺序获得商品。

注:
不能在发布商帐户中对商品目录中的商品进行排序。

主要功能:

  • 将同一商品添加到多个组中。
  • 将较小的组添加到较大的组中来创建多级目录。
  • 更改组顺序。
  • 更改商品顺序。

通过以下方式之一设置组:

通过发布商帐户进行设置

创建组

要创建虚拟物品组:

  1. 在发布商帐户中打开您的项目,前往商品目录 > 虚拟物品
  2. 单击+并在下拉列表中选择创建组

  1. 指定以下参数:
    • External ID — 唯一组代码。
    • 组名称
  2. 在商店中显示组开关设置为
  3. 单击创建组

编辑组

要编辑某个组:

  1. 在发布商帐户中打开您的项目,前往商品目录 > 虚拟物品部分,单击•••,然后在下拉列表中选择编辑组

  1. 进行所需的更改。
  1. 单击保存更改
注:
如果在商店中隐藏了组(在商店中显示组开关设置为),那么这样的组:
  • 调用获取组列表API时不在响应中返回。
  • 调用获取商品列表的客户端方法时,不在该组包含的商品的属性中显示。

向组中添加商品

要向组中添加虚拟物品,请在创建新物品或编辑现有物品时指定该组。

注:
不属于任何组的商品将自动添加到Ungrouped组,位于组列表末尾。该组中的商品有以下限制:

排列商品

要排列商品(以虚拟物品为例):

  1. 在发布商帐户中打开您的项目,然后前往商品目录 > 虚拟物品部分。
  2. 前往该组。
  3. 将鼠标悬停在虚拟物品编号上,将显示图标,然后将该虚拟物品拖曳到新的位置。

通过API调用进行设置

向组中添加商品

要通过API调用向现有组添加商品,请将包含商品所属组external_id参数的数组传入group字段:

请求示例:

Copy
Full screen
Small screen
 1{
 2  "sku": "sword",
 3  "name": {
 4    "en": "Sword"
 5  },
 6  "is_enabled": true,
 7  "is_free": false,
 8  "order": 1,
 9  "description": {
10    "en": "A sword is a bladed melee weapon intended for cutting or thrusting that is longer than a knife or dagger, consisting of a long blade attached to a hilt."
11  },
12  "prices": [
13    {
14      "amount": 100,
15      "currency": "USD",
16      "is_enabled": true,
17      "is_default": true
18    }
19  ],
20  "vc_prices": [],
21  "is_show_in_store": true,
22  "groups": [
23    "chests",
24    "bonus"
25  ]
26}

获取组列表

注意
通过API调用获取所有组的列表以及指定组的商品列表只适用于虚拟物品。对于其他商品组,请通过筛选进行。
要获取所有组的列表,请使用获取商品组列表API调用。要获取指定组的商品列表,请向按指定组获取商品列表API调用传入external_id参数。

筛选商品

要筛选指定组的商品:

  1. 通过以下API调用获取商品列表:
  2. 使用筛选找到groups参数指定的组中带external_id参数的商品。

本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2025年9月19日

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

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