人群数据洞察(Audience Insights)
V1.1
loading
本节将为您介绍如何获取人群洞察结果，更详细的介绍可以参考【人群数据洞察】章节。
所属权限（scope）：Audience Management
人群洞察分析
全部接口
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 }
使用说明
- 目前仅支持 LBS_CROSS_CITY、LBS_CUSTOM_LOCATION、LBS_POI、KEYWORDD、AD、APP_ACTION_DATA_COMBINE、APP_ACTION_DATA、UNION_ACTION_DATA、WEBSITE_ACTION_DATA、WEBSITE_ACTION_DATA_COMBINE、PACKAGE、CUSTOM_AUDIENCE_COMBINE、CUSTOM_AUDIENCE_SAVED、TAG、LABEL、LOOKALIKE 类型的人群;人群数必须大于 1000 ；人群必须是 SUCCESS 状态。
请求示例
curl -G 'https://api.e.qq.com/v1.1/custom_audience_insights/get?access_token=<ACCESS_TOKEN>×tamp=<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
}
]
}
]
}
}
可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
loading
本节将为您介绍如何获取人群洞察结果，更详细的介绍可以参考【人群数据洞察】章节。
所属权限（scope）：Audience Management
人群洞察分析
全部接口
V1.1
loading
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 } |
使用说明
- 目前仅支持 LBS_CROSS_CITY、LBS_CUSTOM_LOCATION、LBS_POI、KEYWORDD、AD、APP_ACTION_DATA_COMBINE、APP_ACTION_DATA、UNION_ACTION_DATA、WEBSITE_ACTION_DATA、WEBSITE_ACTION_DATA_COMBINE、PACKAGE、CUSTOM_AUDIENCE_COMBINE、CUSTOM_AUDIENCE_SAVED、TAG、LABEL、LOOKALIKE 类型的人群;人群数必须大于 1000 ；人群必须是 SUCCESS 状态。
请求示例
curl -G 'https://api.e.qq.com/v1.1/custom_audience_insights/get?access_token=<ACCESS_TOKEN>×tamp=<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
}
]
}
]
}
}可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
