入门与指南专题介绍帐号管理营销资产广告管理数据洞察人群管理数据接入接口清单
授权认证 帐号管理 营销资产 广告管理 数据洞察 辅助工具 用户行为数据 用户人群数据 用户标签数据 用户属性数据
附录

人群数据洞察(Audience Insights)

V1.1

loading


本节将为您介绍如何获取人群洞察结果,更详细的介绍可以参考【人群数据洞察】章节。

所属权限(scope):Audience Management


人群洞察分析

custom_audience_insights/get

GET

*为必填项
名称 类型 描述
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 }
  • 目前仅支持 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_ch": "",
    "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
                    }
                ]
            }
        ]
    }
}