v3/user/get_app_flag

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

目录

1 功能说明

本接口查询用户在应用中的用户标识customflag,以便针对特定用户做拉动流失活动或高潜付费活动。

用户标识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参数后,根据标志位含义判断该用户是否是目标用户(如濒临流失、流失、高潜付费用户等),如果用户是目标用户,则调用本接口查询用以再次确认用户标识;
3. 当用户参与活动后,调用 v3/user/del_app_flag 以清除用户标识中的用户群ID信息或高潜付费标识。

注:
对于已下线、未上线的活动,查询到的customflag中的d0~d7位或d29位将被清除,用0填充。

2 接口调用说明

2.1 URL

http://[域名]/v3/user/get_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)私有参数
无。

2.6 请求示例

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

2.7 返回参数说明

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

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

customflag 应用中的用户标识。

2.8 错误返回码说明

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

2.9 正确返回示例

JSON示例:

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

2.10 错误返回示例

{
"ret":1002,
"msg":"请先登录"
}

3 示例代码

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

4 接口调试

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

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部