接口文档SDK业务专题开发者工具

人群洞察分析
全部接口
V1.1
loading

所属权限 Audience Management
请求地址 custom_audience_insights/get
请求方法 get

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考

参数名称 参数类型
access_token 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节
timestamp

当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。

MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳

MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59

nonce 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性
fields get 接口增加 fields 字段,用于指定返回参数的字段列表,为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写,则根据默认值进行返回

请求参数

参数仅适用于腾讯广告平台,暂不支持微信公众平台。
标有*的参数为必填项

名称 类型 描述
account_id*
integer 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id
audience_id*
integer 人群 id,通过 [custom_audiences] 模块创建客户人群获得,仅支持 LBS、KEYWORD、AD、USER_ACTION 类型的人群透视
dimension_type*
enum[] 透视维度数组,目前仅支持单维度,[枚举详情]
数组长度为 1
枚举列表:{ AGE, GENDER, EDUCATION, RESIDENT_AREA_CODE, USER_BUSINESS_INTEREST, RELATIONSHIP_STATUS, LOCARD_INTEREST, LOCARD_BEHAVIOR_CATEGORY }

使用说明

  1. 目前仅支持 LBS、KEYWORD、AD、USER_ACTION 类型的人群;人群数必须大于 1000 ;人群必须是 SUCCESS 状态。

请求示例


curl -G 'https://api.e.qq.com/v1.1/custom_audience_insights/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'audience_id=<AUDIENCE_ID>' \
-d 'dimension_type=["AGE"]' 
					

应答字段

名称 类型 描述
list
struct[] 返回数组列表
dimension_type
enum 透视维度,[枚举详情]
match_rate
float 有效用户比例:某维度下,所有项的已知人数和,占该人群数的比例。 例如 2000 人的人群,已知 1600 人为男,200 人为女,200 人未知,则性别的有效用户比为 90%,对应的 match_rage 值为 0.9。
distribution
struct[] 人群分布信息列表
dimension_value
string 人群分布区间名称,参见[透视维度]
percentage
integer 百分比:某维度下,一项值的人群,占所有已知项人群和的比例。 例如 2000 人的人群,已知 1600 人为男,200 人为女,200 人未知,则男性百分比为 89%,对应的的 percentage 的值为 89。
tgi
float 目标人群指数:某维度下,人群的一项值百分比除以腾讯大盘中该项值百分比的比例, 表明该项值和大盘的偏离程度。例如 2000 人的人群,已知 1600 人为男,200 人为女,200 人未知,则男性 TGI 为 0.89/大盘男性比例。

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "dimension_type": "AGE",
                "match_rate": 0.9899999999999999911182158029987476766109466552734375,
                "distribution": [
                    {
                        "dimension_value": "1~17",
                        "percentage": 5,
                        "tgi": 0.299999999999999988897769753748434595763683319091796875
                    },
                    {
                        "dimension_value": "18~23",
                        "percentage": 15,
                        "tgi": 0.95999999999999996447286321199499070644378662109375
                    },
                    {
                        "dimension_value": "24~30",
                        "percentage": 27,
                        "tgi": 0.7199999999999999733546474089962430298328399658203125
                    },
                    {
                        "dimension_value": "31~40",
                        "percentage": 26,
                        "tgi": 1.5300000000000000266453525910037569701671600341796875
                    },
                    {
                        "dimension_value": "41~50",
                        "percentage": 17,
                        "tgi": 1.87000000000000010658141036401502788066864013671875
                    },
                    {
                        "dimension_value": "51~65",
                        "percentage": 9,
                        "tgi": 2.160000000000000142108547152020037174224853515625
                    },
                    {
                        "dimension_value": "66~127",
                        "percentage": 0,
                        "tgi": 2.850000000000000088817841970012523233890533447265625
                    }
                ]
            }
        ]
    }
}

可视化调试工具