商店中商品的显示时限

工作原理

您可以设置商品在商店中的展示时间，以实现以下目的：

• 在特定时间保持商品目录内容的时效性，例如节假日促销期间。
• 提前创建商品，但暂不在商品目录中展示。
• 在商品旁显示计时器，促进用户购买。使用建站器创建商品目录界面时，系统会自动显示计时器。使用自定义界面构建商品目录时，计时器需在己侧实现。

以下场景支持配置展示时间限制：

• 销售游戏内商品⸺虚拟物品、虚拟货币套餐和捆绑包
• 通过游戏Key销售游戏和DLC

配置和更新限制

要创建购买次数有限的商品：

2. 点击Create manually，并在下拉列表中选择Virtual item。

3. 在General settings部分，指定以下内容：
   • SKU
   • 商品所属的一个或多个组（可选）
   • 名称
   • 简短描述
   • 详细描述⸺如需添加，请打开对应开关（可选）

4. 在Media部分，上传一张或多张图片或视频（可选）⸺可从设备上传，也可通过链接添加。对于使用艾克索拉建站器创建的商店，所有商品卡片都会显示标记为Main的文件；其余文件仅会显示在带媒体库的商品卡片中。标记为Main的文件也会在商品目录获取API调用的响应中返回。

5. 在Price settings部分，设置商品价格或创建免费商品：
   • 如需设置价格，请选择Paid item，打开Pricing in real currency和/或Pricing in virtual currency开关，并指定价格。如有需要，可配置区域价格。
   • 如需创建免费商品，请选择Free item。

6. 如需限制商品的可购买数量：
   1. 在Limits部分打开开关并指定数量。
   2. 配置限制重置频率。请从下拉列表中选择一个周期：
      1. Daily。
      2. Weekly。
      3. Monthly。
      4. Custom interval。间隔从商品在商店中的展示开始日期起计算。
      5. No regular refresh。
   3. 根据所选周期设置重置计划，并填写对应参数。

7. 配置商品的显示时间限制（可选）：

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

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

8. 按以下任一方式配置属性（可选）：
   1. 以JSON格式添加属性及属性值。
   2. 手动创建属性及属性值，并将其关联到商品。

9. 如果该付费商品将用于包含随机奖励的玩法机制（如宝箱或扭蛋），请开启Mark as paid randomized reward开关。

10. 点击Create。

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

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

通过API调用设置和更新

如需为商店中的商品设置展示时间限制，请使用以下API调用：

• 创建虚拟物品或更新虚拟物品
• 创建虚拟货币或更新虚拟货币
• 创建虚拟货币套餐或更新虚拟货币套餐
• 创建捆绑包或更新捆绑包
• 创建游戏、按SKU更新游戏或通过ID更新游戏

在创建或更新商品的API调用中传入以下参数：

• periods[0].date_from：商品展示期的开始日期和时间，格式为YYYY-MM-DDThh:mm:ss±TMZ，其中TMZ是hh:mm GMT格式的时区标识。

• periods[0].date_until：商品展示期的结束日期和时间，格式为YYYY-MM-DDThh:mm:ss±TMZ，其中TMZ是hh:mm GMT格式时区标识。如不指定商品展示期的结束时间，请仅指定一个时间段，并传入“periods[0].date_until”: null。

可以为商店中的商品设置多个展示时间段。为此，请在API调用中传入对象数组，其中包含所有时间段的开始和结束日期。

示例：

 1"periods": [
 2      {
 3        "date_from": "2022-06-10T14:00:00+03:00",
 4        "date_until": "2022-06-30T14:00:00+03:00"
 5      },
 6       {
 7        "date_from": "2022-07-10T14:00:00+03:00",
 8        "date_until": "2022-07-30T14:00:00+03:00"
 9      },
10       {
11        "date_from": "2022-08-10T14:00:00+03:00",
12        "date_until": "2022-08-30T14:00:00+03:00"
13      }
14]

获取商品目录API调用会返回请求时在商店中展示的商品。如需获取展示时间尚未开始或已经结束的商品信息，请在请求商品目录时传入show_inactive_time_limited_items参数，并将其值设为1。

在商品目录中显示限制

时效性商品在商品目录中的展示方式取决于具体实现方式⸺通过建站器实现或通过API实现。

通过建站器显示

使用建站器时，系统会自动显示时间限制。在商品销售期结束前30天，计时器会自动显示在商品卡片上，并展示剩余时间：

• 如果距离销售结束还有1周以上，计时器会显示天数和小时数。
• 如果距离销售结束还有1天以上，计时器会显示小时数和分钟数。
• 如果距离销售结束不足1天，计时器会显示分钟数和秒数。

通过API获取限制信息

如果通过API实现商品目录，商品销售时间段信息会在以下商品目录相关API调用的items.periods数组中返回：

• 获取虚拟物品列表
• 获取虚拟货币列表
• 获取虚拟货币套餐列表
• 获取捆绑包列表
• 获取游戏列表

商品可售时间的日期数据可用于在商品目录中显示限制信息⸺例如，展示用户可购买某商品的有效时间段。