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

组和组内商品的顺序会影响目录在您的商店中（网站或应用程序）显示的效果。正确配置的顺序可以帮助您更有效地进行销售：您可以优先向用户展示热门商品和组。

当请求商品组列表时，组会按照排序顺序返回。同样，当按组请求商品时，商品会按照排序顺序返回。未指定组的商品会自动添加到未分组组中——这些商品无法排序，也不会在按组请求商品时返回。

主要功能：

• 将一个商品添加到多个组。
• 对组进行排序。
• 对组内商品进行排序。

设置组：

1. 在发布商帐户中创建和编辑组。
2. 添加商品并获取组信息：
   • 通过发布商帐户
   • 通过API调用

通过发布商帐户进行设置

创建组

创建组：

1. 在发布商帐户中打开您的项目，前往商品目录 > 全部商品部分。
2. 单击编辑组和顺序。

3. 单击创建组。

4. 指定所需参数：
   • 外部ID — 唯一的组ID。
   • 组名称。

5. 向组中添加商品（可选）。如果您的目录中尚无商品，您可以先保存当前设置，稍后再返回此步骤。
6. 在下拉列表中选择状态启用以在商店中显示该组。
7. 单击创建。

编辑组

要编辑组：

1. 在发布商帐户中打开您的项目，前往商品目录 > 全部商品部分。
2. 单击编辑组和顺序。
3. 单击所需组旁的⋮按钮，在下拉列表中选择编辑。

4. 进行必要的更改后，单击保存。

删除组

您只能删除不包含任何商品的组。

要删除组：

1. 在发布商帐户中打开您的项目，前往商品目录 > 全部商品部分。
2. 在过滤器字段中选择组。所有包含在其中的商品将显示出来。

3. 在组列中，取消选中要删除的组的复选框。
4. 单击编辑组和顺序。
5. 单击所需组旁的⋮，在下拉列表中选择删除。

向组中添加商品

要将商品（以虚拟物品为例）添加到所需组中，请在创建或编辑虚拟物品时指定组：

• 在虚拟物品的基本设置中；

• 在虚拟物品列表中的组下拉列表中。

排列商品

要排列商品（以虚拟物品为例）：

1. 在发布商帐户中打开您的项目，前往商品目录 > 全部商品部分。
2. 单击编辑组和顺序。
3. 单击所需组旁的⋮，在下拉列表中选择编辑。
4. 单击⌄展开虚拟物品块。
5. 将鼠标悬停在虚拟物品编号上。将显示☰图标。将虚拟物品拖动到所需位置。您还可以将商品直接移动到列表的顶部或底部。为此，请单击⋮并选择相应的选项。

6. 单击保存。

对组进行排序

对组进行排序：

通过API设置

向组中添加商品

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

• 游戏密钥 — 使用创建游戏、按SKU更新游戏和通过ID更新游戏API调用。
• 虚拟物品 — 使用创建虚拟物品和更新虚拟物品API调用。
• 虚拟货币 — 使用创建虚拟货币和更新虚拟货币API调用。
• 虚拟货币套餐 — 使用创建虚拟货币套餐和更新虚拟货币套餐API调用。
• 捆绑包 — 使用创建捆绑包和更新捆绑包API调用。

请求示例：

 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调用传入external_id参数。

筛选商品

要筛选指定组的商品：

1. 通过以下API调用获取商品列表：
   • 获取游戏列表
   • 获取虚拟货币列表
   • 获取虚拟货币套餐列表
   • 获取捆绑包列表
2. 使用筛选找到groups参数指定的组中带external_id参数的商品。