如何设置商品在商店中的显示时间限制

您可以设置商品在商店中的显示时间,以实现以下目的:

  • 保持目录与某段时间的相关性,例如节假日促销期间
  • 提前创建商品但不在目录中显示
  • 通过在商品旁边显示计时器,激励用户购买
注:
使用建站器创建目录界面时,会自动显示计时器。在自己的界面中创建目录时,需实现计时器的显示。
限制显示时间适用于以下商品类型:
  • 虚拟物品
  • 虚拟货币和虚拟货币套餐
  • 捆绑包
注:
对于虚拟物品、虚拟货币套餐和捆绑包,可通过发布商帐户和API调用进行配置。对于虚拟货币,只能用API调用进行配置。
要通过发布商帐户为某虚拟货币、虚拟货币套餐及捆绑包设置在商店中的显示时间限制,请选择时间段,然后指定时区及开始和结束日期。如不希望指定商品的显示结束日期,请勾选无结束日期复选框。
注:
创建虚拟物品、虚拟货币或虚拟货币套餐后,您可以为该商品设置相应状态,使其可销售、不可销售或一定情况下可销售。
要通过API设置商品在商店中的显示时间限制,请使用:将以下参数传入商品创建或商品更新API调用:
  • periods[0].date_from,包含YYYY-MM-DDThh:mm:ss±TMZ格式的商品显示开始日期和时间,其中TMZhh:mm GMT格式的时区
  • periods[0].date_until,包含YYYY-MM-DDThh:mm:ss±TMZ格式的商品显示结束日期和时间,其中TMZhh:mm GMT格式的时区。如不要指定商品显示结束时间,请传入null

可为商店中的商品设置多个显示时间段。方法是在API调用中传入一个包含所有时间段开始和结束时间的对象数组。

示例

Copy
Full screen
Small screen
    "periods": [
          {
            "date_from": "2022-06-10T14:00:00+03:00",
            "date_until": "2022-06-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-07-10T14:00:00+03:00",
            "date_until": "2022-07-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-08-10T14:00:00+03:00",
            "date_until": "2022-08-30T14:00:00+03:00"
          }
    ]
    

    获取目录方法返回发出请求时在商店中显示的商品。要获取尚未开始或已过显示时间段的商品的信息,请在请求目录时传入值为1show_inactive_time_limited_items参数。

    注:

    对于捆绑包中的商品,其显示时间限制不予考虑。

    示例

    1. 您创建了一个Booster虚拟物品并将其显示时间设置为10月29日至11月15日。

    2. 您创建了一个包含BoosterLegendary Start Pack捆绑包。该捆绑包没有时间限制,因此始终在商店中可见。

    3. 一个用户在10月20日打开了您的游戏内商店。您使用以下方法:

    您未在上述方法中传入show_inactive_time_limited_items参数。

    4. 您获得商品目录:

    • 获取虚拟物品列表的响应中不包含Booster,因为其显示时间段为10月29日至11月5日。如在获取虚拟物品列表中传入了参数show_inactive_time_limited_items:1,则Booster包含在响应中,且periods数组指示其可供购买的时间段。
    • 获取捆绑包列表响应中包含Booster,因为其属于Legendary Start Pack捆绑包,无论show_inactive_time_limited_items参数的值如何,用户都可以获取。

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

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

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