v3/user/del_app_flag

注:本接口目前只对DAU大于5万以上的游戏类应用开放。

目录

1 功能说明

本接口用以清除用户标识customflag中用户群ID信息或高潜付费信息。

用户标识customflag是一个4字节的数字,其含义如下:
d0~d7:用户在应用中所属的用户群ID,1表示濒临沉默用户,2表示沉默用户。
d29:高潜付费用户标志,1表示该用户是高潜付费用户,0表示该用户不是高潜付费用户。
另外,customflag是四字节无符号数字,使用时应当做unsigned int来解析,如果开发语言(如java)中没有unsigned int类型,请使用long类型来解析,否则可能会出现溢出情况。
例如:customflag=2684354562,二进制bit位d31~d0依次为 10100000 00000000 00000000 00000010,其d0~d7位为00000010,即该用户的群用户ID为2,是沉默用户;其d29位为1,所以也是高潜付费用户。

在应用做活动的整个过程中,用户标识的使用分为如下三个步骤:
1. 当用户进入应用时,若该用户存在有效的用户标识,平台会将用户标识通过app_appbitmap参数传递给应用;
2. 应用收到app_appbitmap参数后,根据标志位含义判断该用户是否是目标用户(如濒临流失、流失、高潜付费用户等),如果用户是目标用户,则调用v3/user/get_app_flag 接口查询用以再次确认用户标识;
3. 当用户参与活动后,调用本接口用以清除用户标识中的用户群ID信息或高潜付费标识。


2 接口调用说明

2.1 URL

http://[域名]/v3/user/del_app_flag

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
acttype unsigned int 指定操作类型。

1:清除用户customflag中的用户群ID信息。
3:清除用户高潜付费标识位。

usergroupid unsigned int 用户群ID,当acttype=1时需传入。
请通过v3/user/get_app_flag查询用户标识customflag中的用户群ID。

2.6 请求示例

http://openapi.tencentyun.com/v3/user/del_app_flag?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
sig=VrN%2BTn5J%2Fg4IIo0egUdxq6%2B0otk%3D&
pf=qzone&
format=json&
userip=112.90.139.30&
acttype=1&
usergroupid=2

2.7 返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0 返回码
msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

2.8 错误返回码说明

公共错误返回码:公共返回码说明#OpenAPI V3.0 返回码
本接口私有错误返回码:

ret 返回码含义
2001 传入的用户群ID与该用户的用户群ID不匹配。
2002 传入的用户群ID没有上线的活动。

2.9 正确返回示例

JSON示例:

{
"ret":0,
"is_lost":0,
}

2.10 错误返回示例

{
"ret":2001,
"msg":"用户群ID错误"
}

3 示例代码

您可以直接下载并使用腾讯开放平台提供的SDK,并参考SDK里面的给出的示例代码进行接口调用。
详见:SDK下载#OpenAPI V3.0 SDK下载

4 接口调试

您可以使用腾讯开放平台提供的API联调工具进行接口调试。
请登录:http://open.qq.com/tools

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部