Unity专用企业级SDK / 免费商品
  返回文档

Unity专用企业级SDK

免费商品

免费商品是一种用户无需使用虚拟货币或真实货币购买即可获得的商品类型,包括:

  • 虚拟物品
  • 捆绑包
  • 虚拟货币套餐

免费商品仅适用于授权用户。未授权用户只能查看免费商品的目录。

使用示例:

  • 可在项目的一些重要日子(如项目筹建当天)向用户送出免费商品来回馈用户忠实度。
  • 可在商店中送出新手套装来吸引新用户加入游戏。

可在用户已拥有的情况下限制特殊商品的免费发放。

要设置免费商品:

  1. 将免费商品添加到目录
  2. 实现用户下单免费商品的逻辑
  3. 实现将免费商品发放给用户的逻辑

将免费商品添加到目录

关于创建商品的详细信息,请参阅以下文档章节:

创建或编辑免费商品时,需在付费或免费部分选择免费物品免费套餐免费捆绑包

用户下单免费商品

用户可以通过两种方式下单免费商品:

  • 一键下单(不使用购物车)— 任意数量的某一个SKU,例如100瓶同样的魔法药水。
  • 通过购物车 — 任意数量任意类型的商品。

一键下单免费商品

要实现此方式,请在用户点击目录中的按钮下单免费商品时调用CreateOrderWithSpecifiedFreeItem SDK方法。

成功向该方法发送请求后,艾克索拉侧向用户物品库发放商品将立即发生(无需打开支付中心)。

通过购物车下单免费商品

如用户使用购物车:

  • 如果用户购物车中同时包含付费和免费商品:
    1. 使用PurchaseCart SDK方法获取支付令牌和订单ID。
    2. 实现支付UI的打开。方法是调用OpenPurchaseUi SDK方法并向其传入支付令牌和订单ID。

  • 如用户购物车中仅包含免费商品,请调用CreateOrderWithFreeCartCreateOrderWithParticularFreeCart SDK方法。向该方法发送请求成功后,艾克索拉侧向用户发放商品将立即发生(无需打开支付中心表单)。

将免费商品发放给用户

您可以通过在计时器上调用CheckOrder SDK方法来跟踪免费商品订单的状态。

如果订单成功,请使用显示用户物品库的SDK方法来更新应用程序用户端侧的数据。

注:
如果配置了让您的应用程序服务器来处理艾克索拉Webhook,可在收到order_paid Webhook时更新应用程序客户端侧的数据。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
为此页面评分
为此页面评分
我们还有其他可改进之处吗?

不想回答

感谢您的反馈!

有用链接

上次更新时间: 2023年10月10日

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

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