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

为不断夯实平台能力,更好地发挥大数据价值,腾讯广告数据管理平台(DMP)全新推出“标签广场”,以标签和人群的形式引入腾讯强大的二方数据以及三方数据能力,拓展数据维度的同时,丰富数据使用方式。不仅提供更加精细、行业化的标签数据,以及时效性更强、更适合营销场景的人群数据,同时,还支持标签互相组合或与一方人群组合等多种灵活的运算组合方式,并同步对生成人群支持洞察和价值分析等功能,为广告主对营销推广提供更加丰富多样的营销新玩法。

标签广场具体功能及应用场景

标签广场包括两个模块:标签专区 和 热点人群。其中标签专区分为三部分:标签地图、专属推荐和行业推荐。具体结构和功能如下:

——标签地图

标签地图是一个标签索引区,展示DMP提供的所有标签信息,包含消费状态、文化生活、工作状态等全面基础的“人口学属性”标签以及涵盖游戏、电商、金融、交通乃至全行业的定制化“垂直行业”标签,未来会逐步开放更多行业数据能力。

应用场景:

当客户有明确的目标圈定人群时,可以根据基础的人口学属性标签、定制化的行业标签以及优质的第三方标签,直接选取适合的标签或通过交并差组合的形式生成新的人群,也可将已有人群与标签进行组合。
例如:某卡牌游戏客户想对高消费群体做定投,可选取游戏垂直行业“游戏付费-1000元以上”和小游戏用户中的“卡牌”两个标签做交集,生成目标人群。

——标签推荐

专属推荐和行业推荐是一个定制化推荐模块,DMP会根据每一个客户账号属性以及所属行业特征,为客户推荐更加合适和优质的标签,帮助广告主高效圈定人群。

应用场景:

当客户不知道如何选择标签进行投放时,可以选择专属推荐和行业推荐中的标签进行尝试投放,快速定位有效标签,降低选择标签的成本。
例如:某电商行业客户从专属推荐模块中选取“消费水平-高消费”和“消费类型-虚拟商品”两个标签做并集,组合生成新的人群。

——热点人群

热点人群是一个按营销场景推出的主题标签组合专区,会结合行业特征与诉求,围绕一系列营销场景、节假日、时事话题推出一系列带有主题色彩的人群,目前已开放国庆节、双十一等营销标签主题,未来将持续丰富。

应用场景:

客户可在特定时期选择适合人群直接添加至我的人群用于广告投放或者组合等操作。
例如,某电脑品牌在开学季主题下选取了“大学新生群体”和“购买电脑意向人群”添加至我的人群中,在促销季对两个人群进行了该品牌的广告定向投放。

接口详情


标签广场标签获取
全部接口
V1.1
loading

所属权限 Audience Management
请求地址 labels/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
filtering
struct[] 过滤条件,若此字段不传,或传空则视为无限制条件,详见 [过滤条件]
field*
string 过滤字段
可选字段:{label_group, parent_id, display_label_name}
operator*
enum 操作符
当 field 取值 label_group 时,枚举列表:{ IN },当 field 取值 parent_id 时,枚举列表:{ NOT_IN },当 field 取值 display_label_name 时,枚举列表:{ CONTAINS }
values*
string[] 字段取值,values 数组的个数限制与 operator 的取值相关,详见 [过滤条件]
当 field 取值 label_group 时,枚举列表:{MAP, POP},其中 MAP 代表标签地图,POP 代表热点人群;当 field 取值 parent_id 时,传入需要排除的 parent_id ;当 field 取值 display_label_name 时,传入需要检索的标签名称文本
page
integer 当前页码,默认 1
最小值 1,最大值 2147483647
page_size
integer 分页大小,默认 10
最小值 1,最大值 100

请求示例


curl -G 'https://api.e.qq.com/v1.1/labels/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[{"field":"label_group","operator":"IN","values":["MAP"]},{"field":"parent_id","operator":"NOT_IN","values":[12344,23434]},{"field":"display_label_name","operator":"CONTAINS","values":["电竞"]}]' \
-d 'page=1' \
-d 'page_size=100' 
					

应答字段

名称 类型 描述
list
struct[] 返回数组列表
label_id
integer 标签 id
audience_id
integer 人群 id,通过 [custom_audiences] 模块创建客户人群获得
display_label_name
string 标签名称
description
string 标签描述
user_count
integer 用户覆盖数
page_info
struct 分页信息
page
integer 当前页码
page_size
integer 分页大小
total_number
integer 总行数
total_page
integer 总页数

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "label_id": 101,
                "audience_id": 123,
                "display_label_name": "标签",
                "description": "描述",
                "user_count": 12345
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 100,
            "total_number": 1,
            "total_page": 1
        }
    }
}

可视化调试工具

标签添加到人群列表
全部接口
V1.1
loading

所属权限
请求地址 label_audiences/add
请求方法 post

全局参数

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

参数名称 参数类型
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
label_id*
integer 标签 id
最小值 0,最大值 2147483647

请求示例


curl 'https://api.e.qq.com/v1.1/label_audiences/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
    "account_id": "<ACCOUNT_ID>",
    "label_id": 123
}'
					

应答字段

名称 类型 描述
audience_id
integer 人群 id,通过 [custom_audiences] 模块创建客户人群获得

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "audience_id": "<AUDIENCE_ID>"
    }
}

可视化调试工具