fusion2.dialog.reactiveWithGift

目录

1 功能说明

1. 接口类型:前端JS接口。
2. 接口功能:用最轻量的方式鼓励用户召回自己的流失好友。
3. 功能描述:
(1)应用在用户登录时调用该接口,腾讯会自动判断当前用户是否有需要拉回的流失好友。
(2)若当前用户有需要拉回的好友,则弹出前台fusion框,引导用户给这些好友赠送礼物,帮助应用拉回流失用户。
(3)用户确认给选定的好友发送礼物后,这些好友会收到QQTips;同时,应用需要给当前用户也发送适当的礼物
(4)好友点击QQTips即可进入应用,并收到应用发送的回流大礼包。
(5)若当前用户没有需要拉回的好友,则不弹出前台fusion框,用户照常进入应用。
4. 接口调用限制
(1)应用状态:接入了腾讯平台防流失系统,关于防流失系统的介绍可以查看这里
(2)支持的平台:目前支持空间平台。
(3)调用的频率限制:每个用户每天最多调用一次。

2 场景说明

2.1 弹框效果展示

1. 应用在用户登录时,调用该fusion API,弹出下面的框:
(1)弹框中列出待拉回的流失好友。
(2)好友默认是被选中的,用户可以取消选中。
(3)用户点击“赠送”或取消后,弹窗消失。
轻量好友召回框示例如下图所示:
reactiveWithGift_image001.png

2.2 结果展现

1. 用户发送礼物成功后,相应的好友在其QQ客户端会收到tips提醒,点击链接即可进入应用。
tips示例如下:
reactiveWithGift_image002.png
注:Tips中的“99Q点大礼包”文案是可自定义的,定义字段见参数说明中的msg。

3 接口调用说明

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

3.1 参数说明

参数名称 是否必须 类型 描述
msg string 参数描述:显示在轻量好友召回框内,以及Tips上的礼物名称。

长度限制:建议控制在8个汉字内,更多的字符会被截断。 建议直接用最具有吸引力的道具名称。比如“20个精力”,等等。

source string 参数描述:透传参数,由开发者自定义该参数。

开发者可根据这个参数的内容,判断被召唤的用户是点击哪个好友发送的召回请求。 例如: 用户A向C发送召回请求时,source的值为“openid=001”,用户B向C发送召回请求时,source的值为“openid=002”。当用户C点击请求信息的链接进入应用时,url中会携带app_custom参数,如果app_custom的值为“openid=001”,说明C响应的是A的召唤,如果app_custom的值为“openid=002”,说明C响应的是B的召唤。

onSuccess 参数描述:用户操作成功后的回调方法。
OnError 参数描述:用户发送失败时的回调方法
onCancel 参数描述:用户取消操作后的回调方法。
onClose 参数描述:对话框关闭时的回调方法。

3.2 调用示例

fusion2.dialog.reactiveWithGift ({

//必填,用户在好友召回界面看到的礼包名称,长度请控制在8个汉字以内,超出部分将会被截断
msg : string;

//可选。用户发送成功时的回调方法
onSuccess : function () { },

//可选。用户发送失败时的回调方法
onError : function () { },

//可选。用户取消发送,关闭对话框时的回调方法
onCancel : function () { },

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

});

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部