fusion2.dialog.getCoupon

目录

1 功能说明

1. 接口类型:前端JS接口。
2. 接口功能:引导用户进入可以免费获得抵扣券金券的渠道,让用户可以抽取抵扣券金券。
3. 功能描述:
(1)调用本接口后,出现抵扣券抽奖弹出框。
(2)弹框的样式针对:黄钻用户,非黄钻的有抽奖资格的幸运用户,非黄钻的无抽奖资格的用户分别有不同的样式。
(3)本接口作为平台抵扣券体系建设的一部分,提供了用户免费获得抵扣券的渠道。抵扣券使用、展现机制相关文档即将推出,敬请期待。
4. 接口调用限制:
(1)支持的平台:本接口支持QQ空间和朋友平台。
(2)具有抽奖资格的用户每天只能抽奖一次。已经抽过奖后,再调用本接口时,弹框中提示用户今日已经抽奖。

2 场景说明

2.1 入口说明

开发者可在应用内用户的游戏货币展现区域加入抵扣券余额度展示,向用户推广金券可以当Q点使用的概念,同时提供抵扣券抽奖入口。
用户点击该抽奖入口后,应用调用本接口(接口调用详见下文第3节说明),弹出金券抽奖弹框。

平台提供了金券icon的标准素材,作为统一的抵扣券抽奖入口展现(点击这里下载素材)。
下面对入口进行说明:
入口1:
在应用内设置统一的金券领取icon:
-金券领取icon必须使用统一的素材(素材名称:“每日金券抽奖应用内icon.psd”);
-金券领取icon区分领取前和领取后2种状态(即将提供接口供开发者调用,查询是否已经领取了每日金券。在该接口提供前,icon无需区分是否领取);
-用户点击该icon后,即调用本接口,弹出金券抽奖的弹框。

如下图所示:
fusion2.dialog.getCoupon_7.png

入口2:
在适当的地方展现金券余额,然后在余额旁边设置可以领取金券的按钮,引导用户点击领取按钮:
-金券余额旁必须使用统一的素材来表示是金券余额(素材名称:“金券余额展示金券素材1.psd”- “金券余额展示金券素材6.psd”);
-金券余额可通过调用接口v3/pay/get_pubacct_balance来获取;
-金券余额数字的展现样式,以及金券领取的展现样式应用可以自己控制。
-用户点击金券领取按钮后,即调用本接口,弹出金券抽奖的弹框。

如下图所示:
fusion2.dialog.getCoupon_6.png

2.2 效果展示

下面是用户点击领取金券按钮后的金券领取弹框:
1. 黄钻用户
抽奖前:
fusion2.dialog.getCoupon_1.png
抽奖后:
fusion2.dialog.getCoupon_2.png

2. 非黄钻的有抽奖资格的幸运用户
抽奖前:
fusion2.dialog.getCoupon_3.png
抽奖后:
fusion2.dialog.getCoupon_4.png

3. 非黄钻的无抽奖资格的用户
fusion2.dialog.getCoupon_1.png

3 接口调用说明

调用本前端接口前,应用中应该部署Fusion2的跨域文件以及引用脚本,请参阅:Fusion2文档

3.1 参数说明

参数名称 是否必须 类型 描述
context string 参数描述:透传参数,用于回调以识别请求。

透传方式:调用本接口时传入该参数,回调时,在JS中使用opt.context即可获取该透传参数(opt为本接口的回调函数名称)。 例如用户操作成功后,会回调onSuccess时获取该参数的值: onClose : function (opt)

 {      
      alert("Closed: " + opt.context);  
 }
onClose 参数描述:对话框关闭时的回调方法。主要用于对话框关闭后进行UI方面的调整。

方法要求:回调函数名称为opt。即:function (opt)。
触发条件:用户点击弹出框右上角的×按钮,弹出框关闭。

3.2 调用示例

fusion2.dialog.getCoupon 
({
    context : "getCoupon_12345", 
    onClose : function (opt) 
     {  
        // 通过opt.context可获取接口中传入的context透传参数,以识别请求
        alert("Closed: " + opt.context);  
     }
  })


FAQ

详见:FusionAPI调用相关问题

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部