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

定向标签 (Targeting Tags)

V1.1

loading


本节将为您介绍定向标签 (Targeting Tags) 相关接口。 该接口用于获取创建定向时,可能需要填写的地域(REGION)、商圈(BUSINESS_DISTRICT)、商业兴趣(BUSINESS_INTEREST,即将下线), APP类目(APP_CATEGORY,即将下线), 行为(BEHAVIOR), 兴趣(INTEREST), 微信公众号类型定向(WECHAT_OFFICIAL_ACCOUNT_CATEGORY), 移动媒体类型定向(MOBILE_UNION_CATEGORY)对应的可用标签值。

所属权限(scope):Ads Management, Ads Insight


获取定向标签
全部接口
V1.1
loading

所属权限 Ads Insight,Ads Management
请求地址 targeting_tags/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
type*
string 标签类型,可选值:REGION(地域),BUSINESS_DISTRICT(商圈),BUSINESS_INTEREST(商业兴趣,待下线),APP_CATEGORY(APP 类目),BEHAVIOR(行为),INTEREST(兴趣),INTENTION(意向),WECHAT_OFFICIAL_ACCOUNT_CATEGORY(微信流量类型定向),MOBILE_UNION_CATEGORY(移动媒体类型),DEVICE_BRAND_MODEL(设备品牌型号定向)
tag_spec
struct 获取定向标签的条件
behavior_spec
struct 获取行为定向标签的条件,type 为 BEHAVIOR 时必填
query_mode*
enum 定向标签查询方式,[枚举详情]
枚举列表:{ TARGETING_TAG_QUERY_MODE_SEARCH, TARGETING_TAG_QUERY_MODE_RECOMMEND, TARGETING_TAG_QUERY_MODE_COMMON, TARGETING_TAG_QUERY_MODE_ADVANCED_RECOMMEND, TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST }
query_spec
struct 查询定向标签的条件,当 query_mode 为 TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST、TARGETING_TAG_QUERY_MODE_SEARCH 和 TARGETING_TAG_QUERY_MODE_RECOMMEND 时必填
query
string 用于搜索或推荐的词
字段长度最小 1 字节,长度最大 200 字节
query_list
string[] 批量检查关键词,应答结果仅返回有效关键词,当且仅当 query_mode 为 TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST 时可填且必填
数组最小长度 1,最大长度 250
字段长度最小 1 字节,长度最大 64 字节
max_result_number
integer 最大结果数,默认 10,最大结果数
最小值 1,最大值 50
excluding_targeting_tags
string[] 已经选中的标签,在结果中不会再次出现
数组最小长度 1,最大长度 250
advanced_recommend_type
enum 优质推荐类型,当 query_mode 为 TARGETING_TAG_QUERY_MODE_ADVANCED_RECOMMEND 时必填,[枚举详情]
枚举列表:{ ADVANCED_RECOMMEND_TYPE_SYSTEMATIC, ADVANCED_RECOMMEND_TYPE_INDUSTRY_HOT }
interest_spec
struct 获取兴趣定向标签的条件,type 为 INTEREST 时必填
query_mode*
enum 定向标签查询方式,[枚举详情]
枚举列表:{ TARGETING_TAG_QUERY_MODE_SEARCH, TARGETING_TAG_QUERY_MODE_RECOMMEND, TARGETING_TAG_QUERY_MODE_COMMON, TARGETING_TAG_QUERY_MODE_ADVANCED_RECOMMEND, TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST }
query_spec
struct 查询定向标签的条件,当 query_mode 为 TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST、TARGETING_TAG_QUERY_MODE_SEARCH 和 TARGETING_TAG_QUERY_MODE_RECOMMEND 时必填
query
string 用于搜索或推荐的词
字段长度最小 1 字节,长度最大 200 字节
query_list
string[] 批量检查关键词,应答结果仅返回有效关键词,当且仅当 query_mode 为 TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST 时可填且必填
数组最小长度 1,最大长度 250
字段长度最小 1 字节,长度最大 64 字节
max_result_number
integer 最大结果数,默认 10,最大结果数
最小值 1,最大值 50
excluding_targeting_tags
string[] 已经选中的标签,在结果中不会再次出现
数组最小长度 1,最大长度 250
advanced_recommend_type
enum 优质推荐类型,当 query_mode 为 TARGETING_TAG_QUERY_MODE_ADVANCED_RECOMMEND 时必填,[枚举详情]
枚举列表:{ ADVANCED_RECOMMEND_TYPE_SYSTEMATIC, ADVANCED_RECOMMEND_TYPE_INDUSTRY_HOT }

请求示例


curl -G 'https://api.e.qq.com/v1.1/targeting_tags/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'type=REGION' 
					

应答字段

名称 类型 描述
list
struct[] 返回信息列表
id
integer id,当 tag_class 为 KEYWORD 时,不返回
name
string 名称
parent_id
integer 父节点 id,当节点为根节点时,该值为 0
parent_name
string 父节点标签名,如果没有父节点返回空字符串
city_level
enum 城市级别,仅当 type=REGION、BUSINESS_DISTRICT 时有效,[枚举详情]
tag_class
enum 行为兴趣标签返回类型,仅当 type=BEHAVIOR、INTEREST 时有效,[枚举详情]

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "id": 110000,
                "name": "北京市",
                "parent_id": 0,
                "parent_name": "",
                "city_level": "CITY_LEVEL_FIRST"
            }
        ]
    }
}

可视化调试工具