fusion2.dialog.showCouponActivity

目录

1 功能说明

1. 接口类型:前端JS接口。
2. 接口功能:建立应用内的平台活动中心,让用户在应用内即可参加消费返利等活动。
3. 功能描述:
(1)调用本接口后,出现活动中心弹框。
(2)弹框的样式,根据平台的不同活动,有不同的样式。
(3)腾讯平台会根据付费用户的属性,为用户推送消费返利、消费满返、金券折扣充值等付费活动。
4. 接口调用限制:
支持的平台:本接口支持QQ空间平台。

2 场景说明

2.1 入口说明

开发者可在应用内明显的位置加入活动按钮,引导用户点击进入应用内活动中心。
应用中放置活动按钮的示例如下:
fusion2.dialog.showCouponActivity_2.png
用户点击相应的链接或按钮后,应用调用本接口(接口调用详见下文第3节说明),弹出活动中心弹框。

开发者可右键点击下面的活动按钮,选择“图片另存为”,下载该按钮图标。
fusion2.dialog.showCouponActivity_3.png

2.2 效果展示

下面是用户点击活动链接或按钮后弹出的活动中心弹框示例:
fusion2.dialog.showCouponActivity_1.png


3 接口调用说明

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

3.1 参数说明

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

透传方式:调用本接口时传入该参数,回调时,在JS中使用opt.context即可获取该透传参数(opt为本接口的回调函数名称)。
例如用户关闭对话框时,会回调onClose获取该参数的值:
onClose : function (opt)

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

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

onSuccess 参数描述:用户操作成功后的回调方法。

方法要求: 回调函数的定义符合标准JS函数定义方式,即:function (opt)。
触发条件:用户点击应用中活动的按钮或链接,弹出活动中心弹框。
可通过如下方式获取该次活动的类型:opt.action。
1:打开应用商城或充值界面;
2:打开应用热门付费活动界面;
3:缺省值,开发平台默认推送的活动界面。

3.2 调用示例

fusion2.dialog.showCouponActivity 
({
    context : "showCouponActivity_12345", 
    onSuccess : function (opt) 
     {  
         switch (opt.action)
         { case 1:  /* do sth. */ break;   
           case 2:  /* do sth. */ break; 
           case 3:  /* do sth. */ break; 
          } 
     },
    onClose : function (opt) 
     {  
        // 通过opt.context可获取接口中传入的context透传参数,以识别请求
        alert("Closed: " + opt.context);  
     }
  })


4 相关文档

为方便开发者配合活动中心进行宣传和推广,鼓励用户付费以及提升用户活跃度,可调用接口v3/pay/check_coupon_activity查询活动相关信息。

FAQ

详见:FusionAPI调用相关问题

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

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部