fusion2.dialog.showVipGift

特别声明
1.本接口仅针对已经接入支付的应用。
2.请先在自助营销平台提交活动申请(活动申请详见这里),审核通过的应用将获得接口权限及活动批号信息。
3.本接口属于下面的流程图所示第二个环节(总体开发说明详见这里)。

marketing_13.png

目录

1 功能说明

“道具领取”前端JS接口,弹框模式。
本接口适用场景: 黄钻每日礼包赠送活动。
接入黄钻的应用,可以向黄钻以及年费黄钻用户发放每日黄钻礼包。该营销活动可以促使用户转化为黄钻以及年费黄钻,提升用户付费及活跃度。

用户点击礼包后,即出现道具/物品领取弹框,前台接口会自行判断用户是否具有领取道具的资格,并显示不同的弹框界面:
(1)符合资格的用户可在该弹框中确认领取道具/物品。
(2)如果不符合资格(即非黄钻用户),则弹框中提示用户非黄钻,并引导用户去开通黄钻。
(3)如果符合规则但是当日已经领取过,则弹框中提示已经领取过。

2 接口调用说明

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

接口说明如下:

fusion2.dialog.showVipGift

({

// 必须。赠送道具/物品的营销活动ID。

// 在开发者管理系统“支付结算”tab下的“营销接入”提交活动申请后,将获取该营销活动ID。

actid : "xxx",


// 必须。 领取道具/物品的token,通过调用v3/pay/get_token接口获取。

token : "xxx",


// 必须。识别token是由哪台机器分配的识别号,通过调用v3/pay/get_token接口获取。

mid : "xxx",


// 可选。表示是否使用沙箱测试环境。应用发布前,请务必注释掉该行。

// sandbox值为布尔型。true:使用; false或不指定:不使用。

sandbox : true,


// 可选。前台使用的上下文变量,用于回调时识别请求的来源。

context: "xxx",


// 可选。用户领取成功时的回调方法。
// 其中opt.context为调用该接口时的context对象。
// 如果用户领取成功,则立即回调onSuccess,当用户关闭对话框时再回调onClose。

onSuccess : function (opt) { alert(opt.context);},


// 可选。用户取消领取时的回调方法。
// 其中opt.context为调用该接口时的context对象。
// 如果用户领取失败或没有领取,关闭对话框时将先回调onCancel再回调onClose。

onCancel : function (opt) { alert(opt.context); },


// 可选。对话框关闭时的回调方法。
// 主要用于对话框关闭后进行UI方面的调整,onSuccess和onCancel则用于应用逻辑的处理,避免过度耦合。

onClose : function (opt) { }

});

3 效果展示

用户点击活动链接,应用调用前台接口展示道具/礼品领取弹框,前台接口将自行判断用户是否具有领取资格。
下面是具有领取资格且当日没有领取过道具的用户看到的弹框样式:

marketing_9.png

相关文档

上一步:v3/pay/get_token

下一步: 回调赠送道具发货URL的协议说明_V3.0


其他相关文档:每日礼包赠送

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

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部