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

定向 (Targeting)

V1.1

loading

本节将为您介绍定向 (Targeting) 相关接口。基于腾讯社交数据,我们为您提供了超过200多种特征和行为标签,您可以自由选择、组合这些特征和行为,精准刻画和锁定您的目标用户进行广告投放。关于定向更详细的介绍可以参考【定向】章节。


创建定向
全部接口
V1.1
loading

所属权限 Ads Management
请求地址 targetings/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
targeting_name*
string 定向名称,同一帐号下的定向名称不允许重复
字段长度最小 1 字节,长度最大 120 字节
targeting
struct 定向详细设置,存放所有定向条件
age
struct[] 年龄定向(仅支持单年龄段,范围为 14~66,66 代表的是 66 岁及 66 岁以上,如 18~66 代表大于等于 18 岁)
数组长度为 1
min*
integer 年龄最小值限制,(其中 15、16、17 不可以使用)
最小值 14,最大值 66
max*
integer 年龄最大值限制
最小值 18,最大值 66
gender
enum[] 性别定向(仅单选),[枚举详情]
数组长度为 1
枚举列表:{ MALE, FEMALE }
education
enum[] 用户学历,[枚举详情]
数组最小长度 1,最大长度 100
枚举列表:{ DOCTOR, MASTER, BACHELOR, SENIOR, JUNIOR, PRIMARY, JUNIOR_COLLEGE }
marital_status
enum[] 婚恋育儿状态,[枚举详情]
数组最小长度 1,最大长度 100
枚举列表:{ SINGLE, IN_LOVE, NEWLY_MARRIED, MARRIED, PARENTING, PARENTING_0, PARENTING_0_6, PARENTING_6_12, PARENTING_12_24, PARENTING_24_36, CHILD_PRE_SCHOOL, CHILD_PRIMARY_SCHOOL, CHILD_JUNIOR_SCHOOL, CHILD_HIGH_SCHOOL }
working_status
enum[] 工作状态,[枚举详情]
数组最小长度 1,最大长度 100
枚举列表:{ COLLEGE_STUDENT, BUSINESS_USER, GOVERNMENT_OFFICER, SCIENCE_EDUCATOR, FINANCIAL_WORKER, LAWYER, ADVERTISING_MARKETING_MEDIA_ART_WORKER, REAL_ESTATE_WORKER, IT_WORKER, CONSTRUCTION_WORKER, HEALTH_CARE_WORKER, SALESMAN, SERVICE_WORKER, TRANSPORTATION_LOGISTICS_WORKER, MECHANIC_WORKER, CUSTOMER_SERVICE_TECHNICAL_SUPPORTER, TRADER_BUYER, FINANCE_HUMAN_RESOURCE_ADMIN, CONSULTANT, ENERGY_MATERIAL_WORKER, FARMER, GOLDEN_COLLAR, WHITE_COLLAR, BLUE_COLLAR, SMALL_BUSINESS_MANAGER }
geo_location
struct 地理位置定向,
针对朋友圈广告地域必填,非朋友圈广告选填
如使用地域定向"regions"、"business_districts"、"custom_locations" 不能同时为空
location_types*
enum[] 地点类型,[枚举详情],选择限制:
  • 对于微信流量,仅能选择"LIVE_IN"(常住);
  • 使用商圈(business_district)以及自定义地理位置(custom_locations)时,仅可选 "VISITED_IN"(去过),"LIVE_IN"(常住);
  • 如:["LIVE_IN", "VISITED_IN"]

    数组最小长度 1,最大长度 4
    枚举列表:{ RECENTLY_IN, VISITED_IN, LIVE_IN, TRAVEL_IN }
    regions
    integer[] 省市区县列表,当投放微信流量时,仅支持中国大陆(不包含港澳台)地域 id,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    business_districts
    integer[] 商圈 id 列表,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    custom_locations
    struct[] 自定义地理位置列表,使用火星系坐标,当广告类型为朋友圈广告时(campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS),custom_locations 的数组长度限制为最小长度 1。
    数组最小长度 1,最大长度 400
    longitude*
    float 经度,单位度
    最小值-180,最大值 180,最多保留 6 位小数
    latitude*
    float 纬度,单位度
    最小值-90,最大值 90,最多保留 6 位小数
    radius*
    integer 半径,单位米
    最小值 200,最大值 25000
    user_os
    string[] 操作系统定向, 当 promoted_object_type=PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP 时,广告只会在 Android 操作系统上展示;当 promoted_object_type=PROMOTED_OBJECT_TYPE_APP_IOS 时,广告只会在 iOS 操作系统上展示,[枚举详情]
    数组最小长度 1,最大长度 100
    可选值:{ IOS, ANDROID, IOS_VERSION_4, IOS_VERSION_5, IOS_VERSION_6, IOS_VERSION_7, IOS_VERSION_8, IOS_VERSION_9, IOS_VERSION_10, IOS_VERSION_11, IOS_VERSION_12, IOS_VERSION_13, ANDROID_VERSION_1, ANDROID_VERSION_2, ANDROID_VERSION_3, ANDROID_VERSION_4, ANDROID_VERSION_5, ANDROID_VERSION_6, ANDROID_VERSION_7, ANDROID_VERSION_8, ANDROID_VERSION_9, ANDROID_VERSION_10 }
    new_device
    enum[] 新设备,最近三个月第一次使用该设备的用户,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ IOS, ANDROID }
    device_price
    enum[] 设备价格定向,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ PRICE_1500_LESS, PRICE_1500_2500, PRICE_2500_3500, PRICE_3500_4500, PRICE_4500_MORE }
    device_brand_model
    struct 设备品牌型号定向
    included_list
    integer[] 设备品牌型号定向,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    最小值 0,最大值 10000000000
    excluded_list
    integer[] 排除设备品牌型号列表,不能与 included_list 同时使用,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    最小值 0,最大值 10000000000
    network_type
    enum[] 联网方式定向,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ WIFI, NET_2G, NET_3G, NET_4G }
    network_operator
    enum[] 移动运营商定向,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ CMCC, CUC, CTC }
    network_scene
    enum[] 上网场景,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ PUBLIC_PLACE, HOME, COMPANY, SCHOOL }
    dressing_index
    enum[] 穿衣指数,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ FREEZING, COLD, CHILLY, COOL, MILDLY_COOL, MILD, WARM, TORRIDITY }
    uv_index
    enum[] 紫外线指数,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ WEAK, TEND_WEAK, MEDIUM, TEND_STRONG, STRONG }
    makeup_index
    enum[] 化妆指数,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ PREVENT_CRACKING, MOISTURING, OIL_CONTROL, UV_PROTECT }
    climate
    enum[] 气象,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ SHINE, CLOUDY, RAINY, FOGGY, SNOWY, SANDY }
    temperature
    struct[] 温度(仅单温度段,以绝对零度值(-273)表示 0 度,依次增加,例如 223~323 表示-50 度到 50 度。数字与“~”之间不允许存在空格)
    数组长度为 1
    min*
    integer 温度最小值限制
    最小值 223,最大值 323
    max*
    integer 温度最大值限制
    最小值 223,最大值 323
    air_quality_index
    enum[] 空气质量指数,[枚举详情]
    数组长度为 1
    枚举列表:{ GOOD, MODERATE, LIGHTLY_POLLUTED, MODERATELY_POLLUTED, HEAVILY_POLLUTED, SEVERELY_POLLUTED }
    app_install_status
    enum[] 应用安装(应用用户),当且仅当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_IOS、PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION 时使用,[枚举详情]
    数组长度为 1
    枚举列表:{ NOT_INSTALLED, INSTALLED }
    consumption_status
    enum[] 消费水平,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ HIGH, LOW }
    game_consumption_level
    enum[] 游戏消费能力,原 gamer_consumption_ability 定向升级版,gamer_consumption_ability 和 game_consumption_level 不能同时使用.,[枚举详情]
    数组最小长度 1,最大长度 2
    枚举列表:{ HIGH, NORMAL }
    residential_community_price
    struct[] 居住社区价格(仅支持单价格段,范围为:1~100000,单位是“元/m ²”)
    数组长度为 1
    min*
    integer 居住社区价格最小值限制,可填写的值为 1,1000,2000,3000,4000,5000,6000,7000,8000,9000,10000,20000,30000,40000,50000,60000,70000,80000,90000,100000
    最小值 1,最大值 100000
    max*
    integer 居住社区价格最大值限制,可填写的值为 1000,2000,3000,4000,5000,6000,7000,8000,9000,10000,20000,30000,40000,50000,60000,70000,80000,90000,100000,999999999,最大值 999999999 代表 10 万以上
    最小值 1000,最大值 999999999
    financial_situation
    enum[] 财产状态,[枚举详情]
    数组最小长度 1,最大长度 2
    枚举列表:{ CAR_OWNERS, HOME_OWNERS }
    consumption_type
    enum[] 消费类型定向,[枚举详情]
    数组最小长度 1,最大长度 2
    枚举列表:{ PAID_GOODS_VIRTUAL, PAID_GOODS_REAL }
    custom_audience
    integer[] 自定义定向用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    数组最小长度 1,最大长度 200
    excluded_custom_audience
    integer[] 自定义排除用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    数组最小长度 1,最大长度 200
    behavior_or_interest
    struct 行为兴趣意向定向
    interest
    struct 行为兴趣意向定向的兴趣部分
    targeting_tags
    string[] 兴趣标签列表(待废弃,后续仅支持 category_id_list、keyword_list)
    数组最小长度 1,最大长度 250
    category_id_list
    integer[] 兴趣标签 id 列表,和关键词列表 keyword_list 个数之和不能大于 250,通过[targeting_tags/get]可获取兴趣标签列表 id 和对应标签名称
    数组最小长度 1,最大长度 250
    最小值 1
    keyword_list
    string[] 兴趣关键词列表,和兴趣标签 id 列表 category_id_list 个数之和不能大于 250,通过[targeting_tags/get]可获取兴趣关键词列表
    数组最小长度 1,最大长度 250
    字段长度最小 1 字节,
    behavior
    struct[] 行为兴趣意向定向的行为部分
    数组长度为 1
    targeting_tags
    string[] 行为标签列表(待废弃,后续仅支持 category_id_list、keyword_list)
    数组最小长度 1,最大长度 250
    category_id_list
    integer[] 行为标签 id 列表,和关键词列表 keyword_list 个数之和不能大于 250,通过[targeting_tags/get]可获取行为标签列表 id 和对应标签名称
    数组最小长度 1,最大长度 250
    最小值 1
    keyword_list
    string[] 行为关键词列表,和行为标签 id 列表 category_id_list 个数之和不能大于 250,通过[targeting_tags/get]可获取行为关键词列表
    数组最小长度 1,最大长度 250
    字段长度最小 1 字节,
    scene*
    enum[] 行为兴趣意向定向的行为部分的场景,[枚举详情]
    数组最小长度 1,最大长度 3
    枚举列表:{ BEHAVIOR_INTEREST_SCENE_ALL, BEHAVIOR_INTEREST_SCENE_APP, BEHAVIOR_INTEREST_SCENE_ECOMMERCE, BEHAVIOR_INTEREST_SCENE_INFORMATION }
    time_window*
    enum 行为兴趣意向定向的行为部分的时间窗,[枚举详情]
    枚举列表:{ BEHAVIOR_INTEREST_TIME_WINDOW_SEVEN_DAY, BEHAVIOR_INTEREST_TIME_WINDOW_FIFTEEN_DAY, BEHAVIOR_INTEREST_TIME_WINDOW_THIRTY_DAY, BEHAVIOR_INTEREST_TIME_WINDOW_THREE_MONTH, BEHAVIOR_INTEREST_TIME_WINDOW_SIX_MONTH, BEHAVIOR_INTEREST_TIME_WINDOW_ONE_YEAR }
    intensity*
    enum[] 行为兴趣意向定向的行为部分的强度,[枚举详情]
    数组长度为 1
    枚举列表:{ BEHAVIOR_INTEREST_INTENSITY_ALL, BEHAVIOR_INTEREST_INTENSITY_HIGH }
    intention
    struct 行为兴趣意向定向的意向部分
    targeting_tags
    integer[] 意向标签列表
    数组最小长度 1,最大长度 250
    最小值 0,最大值 4294967295
    description
    string 定向描述
    字段长度最小 0 字节,长度最大 250 字节

    使用说明

    1. 使用自定义人群(custom_audience)定向和排他人群定向(excluded_custom_audience)时,请注意人群包的状态,待处理、处理中、冻结、解冻中的人群用于广告定向,在人群状态变成“成功可用”前可能会存在曝光异常的现象。有关人群状态请参考 [自定义人群] 接口。
    2. 地理位置定向的省市区县以及商圈 id、行为兴趣意向定向、微信公众号类型定向、移动媒体类型定向的可选值列表可通过 targeting_tags/get 接口进行获取。

    请求示例

    
    curl 'https://api.e.qq.com/v1.1/targetings/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -d 'account_id=<ACCOUNT_ID>' \
    -d 'targeting_name=定向' \
    -d 'targeting={"gender":["MALE"],"age":[{"min":18,"max":30}],"geo_location":{"regions":[110000,310000],"location_types":["LIVE_IN"]}}' \
    -d 'description=description' 
    					

    应答字段

    名称 类型 描述
    targeting_id
    integer 定向 id

    应答示例

    {
        "code": 0,
        "message": "",
        "message_cn": "",
        "data": {
            "targeting_id": "<TARGETING_ID>"
        }
    }

    可视化调试工具


    更新定向
    全部接口
    V1.1
    loading

    所属权限 Ads Management
    请求地址 targetings/update
    请求方法 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
    targeting_id*
    integer 定向 id
    targeting_name
    string 定向名称,同一帐号下的定向名称不允许重复
    字段长度最小 1 字节,长度最大 120 字节
    targeting
    struct 定向详细设置,存放所有定向条件
    age
    struct[] 年龄定向(仅支持单年龄段,范围为 14~66,66 代表的是 66 岁及 66 岁以上,如 18~66 代表大于等于 18 岁)
    数组长度为 1
    min*
    integer 年龄最小值限制,(其中 15、16、17 不可以使用)
    最小值 14,最大值 66
    max*
    integer 年龄最大值限制
    最小值 18,最大值 66
    gender
    enum[] 性别定向(仅单选),[枚举详情]
    数组长度为 1
    枚举列表:{ MALE, FEMALE }
    education
    enum[] 用户学历,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ DOCTOR, MASTER, BACHELOR, SENIOR, JUNIOR, PRIMARY, JUNIOR_COLLEGE }
    marital_status
    enum[] 婚恋育儿状态,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ SINGLE, IN_LOVE, NEWLY_MARRIED, MARRIED, PARENTING, PARENTING_0, PARENTING_0_6, PARENTING_6_12, PARENTING_12_24, PARENTING_24_36, CHILD_PRE_SCHOOL, CHILD_PRIMARY_SCHOOL, CHILD_JUNIOR_SCHOOL, CHILD_HIGH_SCHOOL }
    working_status
    enum[] 工作状态,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ COLLEGE_STUDENT, BUSINESS_USER, GOVERNMENT_OFFICER, SCIENCE_EDUCATOR, FINANCIAL_WORKER, LAWYER, ADVERTISING_MARKETING_MEDIA_ART_WORKER, REAL_ESTATE_WORKER, IT_WORKER, CONSTRUCTION_WORKER, HEALTH_CARE_WORKER, SALESMAN, SERVICE_WORKER, TRANSPORTATION_LOGISTICS_WORKER, MECHANIC_WORKER, CUSTOMER_SERVICE_TECHNICAL_SUPPORTER, TRADER_BUYER, FINANCE_HUMAN_RESOURCE_ADMIN, CONSULTANT, ENERGY_MATERIAL_WORKER, FARMER, GOLDEN_COLLAR, WHITE_COLLAR, BLUE_COLLAR, SMALL_BUSINESS_MANAGER }
    geo_location
    struct 地理位置定向,
    针对朋友圈广告地域必填,非朋友圈广告选填
    如使用地域定向"regions"、"business_districts"、"custom_locations" 不能同时为空
    location_types*
    enum[] 地点类型,[枚举详情],选择限制:
  • 对于微信流量,仅能选择"LIVE_IN"(常住);
  • 使用商圈(business_district)以及自定义地理位置(custom_locations)时,仅可选 "VISITED_IN"(去过),"LIVE_IN"(常住);
  • 如:["LIVE_IN", "VISITED_IN"]

    数组最小长度 1,最大长度 4
    枚举列表:{ RECENTLY_IN, VISITED_IN, LIVE_IN, TRAVEL_IN }
    regions
    integer[] 省市区县列表,当投放微信流量时,仅支持中国大陆(不包含港澳台)地域 id,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    business_districts
    integer[] 商圈 id 列表,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    custom_locations
    struct[] 自定义地理位置列表,使用火星系坐标,当广告类型为朋友圈广告时(campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS),custom_locations 的数组长度限制为最小长度 1。
    数组最小长度 1,最大长度 400
    longitude*
    float 经度,单位度
    最小值-180,最大值 180,最多保留 6 位小数
    latitude*
    float 纬度,单位度
    最小值-90,最大值 90,最多保留 6 位小数
    radius*
    integer 半径,单位米
    最小值 200,最大值 25000
    user_os
    string[] 操作系统定向, 当 promoted_object_type=PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP 时,广告只会在 Android 操作系统上展示;当 promoted_object_type=PROMOTED_OBJECT_TYPE_APP_IOS 时,广告只会在 iOS 操作系统上展示,[枚举详情]
    数组最小长度 1,最大长度 100
    可选值:{ IOS, ANDROID, IOS_VERSION_4, IOS_VERSION_5, IOS_VERSION_6, IOS_VERSION_7, IOS_VERSION_8, IOS_VERSION_9, IOS_VERSION_10, IOS_VERSION_11, IOS_VERSION_12, IOS_VERSION_13, ANDROID_VERSION_1, ANDROID_VERSION_2, ANDROID_VERSION_3, ANDROID_VERSION_4, ANDROID_VERSION_5, ANDROID_VERSION_6, ANDROID_VERSION_7, ANDROID_VERSION_8, ANDROID_VERSION_9, ANDROID_VERSION_10 }
    new_device
    enum[] 新设备,最近三个月第一次使用该设备的用户,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ IOS, ANDROID }
    device_price
    enum[] 设备价格定向,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ PRICE_1500_LESS, PRICE_1500_2500, PRICE_2500_3500, PRICE_3500_4500, PRICE_4500_MORE }
    device_brand_model
    struct 设备品牌型号定向
    included_list
    integer[] 设备品牌型号定向,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    最小值 0,最大值 10000000000
    excluded_list
    integer[] 排除设备品牌型号列表,不能与 included_list 同时使用,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    最小值 0,最大值 10000000000
    network_type
    enum[] 联网方式定向,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ WIFI, NET_2G, NET_3G, NET_4G }
    network_operator
    enum[] 移动运营商定向,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ CMCC, CUC, CTC }
    network_scene
    enum[] 上网场景,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ PUBLIC_PLACE, HOME, COMPANY, SCHOOL }
    dressing_index
    enum[] 穿衣指数,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ FREEZING, COLD, CHILLY, COOL, MILDLY_COOL, MILD, WARM, TORRIDITY }
    uv_index
    enum[] 紫外线指数,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ WEAK, TEND_WEAK, MEDIUM, TEND_STRONG, STRONG }
    makeup_index
    enum[] 化妆指数,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ PREVENT_CRACKING, MOISTURING, OIL_CONTROL, UV_PROTECT }
    climate
    enum[] 气象,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ SHINE, CLOUDY, RAINY, FOGGY, SNOWY, SANDY }
    temperature
    struct[] 温度(仅单温度段,以绝对零度值(-273)表示 0 度,依次增加,例如 223~323 表示-50 度到 50 度。数字与“~”之间不允许存在空格)
    数组长度为 1
    min*
    integer 温度最小值限制
    最小值 223,最大值 323
    max*
    integer 温度最大值限制
    最小值 223,最大值 323
    air_quality_index
    enum[] 空气质量指数,[枚举详情]
    数组长度为 1
    枚举列表:{ GOOD, MODERATE, LIGHTLY_POLLUTED, MODERATELY_POLLUTED, HEAVILY_POLLUTED, SEVERELY_POLLUTED }
    app_install_status
    enum[] 应用安装(应用用户),当且仅当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_IOS、PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION 时使用,[枚举详情]
    数组长度为 1
    枚举列表:{ NOT_INSTALLED, INSTALLED }
    consumption_status
    enum[] 消费水平,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ HIGH, LOW }
    game_consumption_level
    enum[] 游戏消费能力,原 gamer_consumption_ability 定向升级版,gamer_consumption_ability 和 game_consumption_level 不能同时使用.,[枚举详情]
    数组最小长度 1,最大长度 2
    枚举列表:{ HIGH, NORMAL }
    residential_community_price
    struct[] 居住社区价格(仅支持单价格段,范围为:1~100000,单位是“元/m ²”)
    数组长度为 1
    min*
    integer 居住社区价格最小值限制,可填写的值为 1,1000,2000,3000,4000,5000,6000,7000,8000,9000,10000,20000,30000,40000,50000,60000,70000,80000,90000,100000
    最小值 1,最大值 100000
    max*
    integer 居住社区价格最大值限制,可填写的值为 1000,2000,3000,4000,5000,6000,7000,8000,9000,10000,20000,30000,40000,50000,60000,70000,80000,90000,100000,999999999,最大值 999999999 代表 10 万以上
    最小值 1000,最大值 999999999
    financial_situation
    enum[] 财产状态,[枚举详情]
    数组最小长度 1,最大长度 2
    枚举列表:{ CAR_OWNERS, HOME_OWNERS }
    consumption_type
    enum[] 消费类型定向,[枚举详情]
    数组最小长度 1,最大长度 2
    枚举列表:{ PAID_GOODS_VIRTUAL, PAID_GOODS_REAL }
    custom_audience
    integer[] 自定义定向用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    数组最小长度 1,最大长度 200
    excluded_custom_audience
    integer[] 自定义排除用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    数组最小长度 1,最大长度 200
    behavior_or_interest
    struct 行为兴趣意向定向
    interest
    struct 行为兴趣意向定向的兴趣部分
    targeting_tags
    string[] 兴趣标签列表(待废弃,后续仅支持 category_id_list、keyword_list)
    数组最小长度 1,最大长度 250
    category_id_list
    integer[] 兴趣标签 id 列表,和关键词列表 keyword_list 个数之和不能大于 250,通过[targeting_tags/get]可获取兴趣标签列表 id 和对应标签名称
    数组最小长度 1,最大长度 250
    最小值 1
    keyword_list
    string[] 兴趣关键词列表,和兴趣标签 id 列表 category_id_list 个数之和不能大于 250,通过[targeting_tags/get]可获取兴趣关键词列表
    数组最小长度 1,最大长度 250
    字段长度最小 1 字节,
    behavior
    struct[] 行为兴趣意向定向的行为部分
    数组长度为 1
    targeting_tags
    string[] 行为标签列表(待废弃,后续仅支持 category_id_list、keyword_list)
    数组最小长度 1,最大长度 250
    category_id_list
    integer[] 行为标签 id 列表,和关键词列表 keyword_list 个数之和不能大于 250,通过[targeting_tags/get]可获取行为标签列表 id 和对应标签名称
    数组最小长度 1,最大长度 250
    最小值 1
    keyword_list
    string[] 行为关键词列表,和行为标签 id 列表 category_id_list 个数之和不能大于 250,通过[targeting_tags/get]可获取行为关键词列表
    数组最小长度 1,最大长度 250
    字段长度最小 1 字节,
    scene*
    enum[] 行为兴趣意向定向的行为部分的场景,[枚举详情]
    数组最小长度 1,最大长度 3
    枚举列表:{ BEHAVIOR_INTEREST_SCENE_ALL, BEHAVIOR_INTEREST_SCENE_APP, BEHAVIOR_INTEREST_SCENE_ECOMMERCE, BEHAVIOR_INTEREST_SCENE_INFORMATION }
    time_window*
    enum 行为兴趣意向定向的行为部分的时间窗,[枚举详情]
    枚举列表:{ BEHAVIOR_INTEREST_TIME_WINDOW_SEVEN_DAY, BEHAVIOR_INTEREST_TIME_WINDOW_FIFTEEN_DAY, BEHAVIOR_INTEREST_TIME_WINDOW_THIRTY_DAY, BEHAVIOR_INTEREST_TIME_WINDOW_THREE_MONTH, BEHAVIOR_INTEREST_TIME_WINDOW_SIX_MONTH, BEHAVIOR_INTEREST_TIME_WINDOW_ONE_YEAR }
    intensity*
    enum[] 行为兴趣意向定向的行为部分的强度,[枚举详情]
    数组长度为 1
    枚举列表:{ BEHAVIOR_INTEREST_INTENSITY_ALL, BEHAVIOR_INTEREST_INTENSITY_HIGH }
    intention
    struct 行为兴趣意向定向的意向部分
    targeting_tags
    integer[] 意向标签列表
    数组最小长度 1,最大长度 250
    最小值 0,最大值 4294967295
    description
    string 定向描述
    字段长度最小 0 字节,长度最大 250 字节

    使用说明

    1. 地理位置定向的省市区县以及商圈 id、行为兴趣意向定向、微信公众号类型定向、移动媒体类型定向的可选值列表可通过 targeting_tags/get 接口进行获取。

    请求示例

    
    curl 'https://api.e.qq.com/v1.1/targetings/update?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -d 'account_id=<ACCOUNT_ID>' \
    -d 'targeting_id=<TARGETING_ID>' \
    -d 'targeting_name=定向' \
    -d 'targeting={"gender":["MALE"],"age":[{"min":18,"max":30}],"geo_location":{"regions":[110000,310000],"location_types":["LIVE_IN"]}}' \
    -d 'description=description' 
    					

    应答字段

    名称 类型 描述
    targeting_id
    integer 定向 id

    应答示例

    {
        "code": 0,
        "message": "",
        "message_cn": "",
        "data": {
            "targeting_id": "<TARGETING_ID>"
        }
    }

    可视化调试工具


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

    所属权限 Ads Management,Ads Insights
    请求地址 targetings/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[] 过滤条件,若此字段不传,或传空则视为无限制条件,详见 [过滤条件]
    数组最小长度 1,最大长度 2
    field*
    string 过滤字段
    可选值:{ targeting_id, targeting_name, created_time, last_modified_time }
    operator*
    enum 操作符
    当 field 取值 targeting_id 时,枚举列表:{ EQUALS, IN }
    当 field 取值 targeting_name 时,枚举列表:{ EQUALS, CONTAINS }
    当 field 取值 created_time 时,枚举列表:{ EQUALS, LESS_EQUALS, LESS, GREATER_EQUALS, GREATER }
    当 field 取值 last_modified_time 时,枚举列表:{ EQUALS, LESS_EQUALS, LESS, GREATER_EQUALS, GREATER }
    values*
    string[] 字段取值,values 数组的个数限制与 operator 的取值相关,详见 [过滤条件]

    当 field 取值 targeting_name 时,
    字段长度最小 1 字节,长度最大 120 字节

    当 field 取值 created_time 时,
    字段长度为 10 字节

    当 field 取值 last_modified_time 时,
    字段长度为 10 字节
    page
    integer 搜索页码,默认值:1
    最小值 1,最大值 99999
    page_size
    integer 一页显示的数据条数,默认值:10。最小值 1,最大值 100

    使用说明

    1. 当且仅当根据定向 id 进行查询时,获取的定向列表包含已删除的定向。
    2. v1.0 创建并使用的 targeting 已迁移到 adgroup 信息中,v1.1 的 targeting 模块不支持 v1.0 创建定向包的读写。

    请求示例

    
    curl -G 'https://api.e.qq.com/v1.1/targetings/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -d 'account_id=<ACCOUNT_ID>' \
    -d 'filtering=[{"field":"targeting_name","operator":"EQUALS","values":["定向"]}]' \
    -d 'page=1' \
    -d 'page_size=10' 
    					

    应答字段

    名称 类型 描述
    list
    struct[] 返回信息列表
    targeting_id
    integer 定向 id
    targeting_name
    string 定向名称,同一帐号下的定向名称不允许重复
    targeting
    struct 定向详细设置,存放所有定向条件
    age
    struct[] 年龄定向(仅支持单年龄段,范围为 14~66,66 代表的是 66 岁及 66 岁以上,如 18~66 代表大于等于 18 岁)
    min
    integer 年龄最小值限制,(其中 15、16、17 不可以使用)
    max
    integer 年龄最大值限制
    gender
    enum[] 性别定向(仅单选),[枚举详情]
    education
    enum[] 用户学历,[枚举详情]
    marital_status
    enum[] 婚恋育儿状态,[枚举详情]
    working_status
    enum[] 工作状态,[枚举详情]
    geo_location
    struct 地理位置定向,
    针对朋友圈广告地域必填,非朋友圈广告选填
    如使用地域定向"regions"、"business_districts"、"custom_locations" 不能同时为空
    location_types
    enum[] 地点类型,[枚举详情],选择限制:
  • 对于微信流量,仅能选择"LIVE_IN"(常住);
  • 使用商圈(business_district)以及自定义地理位置(custom_locations)时,仅可选 "VISITED_IN"(去过),"LIVE_IN"(常住);
  • 如:["LIVE_IN", "VISITED_IN"]
    regions
    integer[] 省市区县列表,当投放微信流量时,仅支持中国大陆(不包含港澳台)地域 id,可通过 [targeting_tags/get] 接口获取
    business_districts
    integer[] 商圈 id 列表,可通过 [targeting_tags/get] 接口获取
    custom_locations
    struct[] 自定义地理位置列表,使用火星系坐标,当广告类型为朋友圈广告时(campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS),custom_locations 的数组长度限制为最小长度 1。
    longitude
    float 经度,单位度
    latitude
    float 纬度,单位度
    radius
    integer 半径,单位米
    user_os
    enum[] 操作系统定向, 当 promoted_object_type=PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP 时,广告只会在 Android 操作系统上展示;当 promoted_object_type=PROMOTED_OBJECT_TYPE_APP_IOS 时,广告只会在 iOS 操作系统上展示,[枚举详情]
    new_device
    enum[] 新设备,最近三个月第一次使用该设备的用户,[枚举详情]
    device_price
    enum[] 设备价格定向,[枚举详情]
    device_brand_model
    struct 设备品牌型号定向
    included_list
    integer[] 设备品牌型号定向,可通过 [targeting_tags/get] 接口获取
    excluded_list
    integer[] 排除设备品牌型号列表,不能与 included_list 同时使用,可通过 [targeting_tags/get] 接口获取
    network_type
    enum[] 联网方式定向,[枚举详情]
    network_operator
    enum[] 移动运营商定向,[枚举详情]
    network_scene
    enum[] 上网场景,[枚举详情]
    dressing_index
    enum[] 穿衣指数,[枚举详情]
    uv_index
    enum[] 紫外线指数,[枚举详情]
    makeup_index
    enum[] 化妆指数,[枚举详情]
    climate
    enum[] 气象,[枚举详情]
    temperature
    struct[] 温度(仅单温度段,以绝对零度值(-273)表示 0 度,依次增加,例如 223~323 表示-50 度到 50 度。数字与“~”之间不允许存在空格)
    min
    integer 温度最小值限制
    max
    integer 温度最大值限制
    air_quality_index
    enum[] 空气质量指数,[枚举详情]
    app_install_status
    enum[] 应用安装(应用用户),当且仅当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_IOS、PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION 时使用,[枚举详情]
    mini_game_qq_status
    enum[] QQ 小游戏使用定向,[枚举详情],当且仅当投放 QQ 小游戏推广目标(promoted_object_type= PROMOTED_OBJECT_TYPE_MINI_GAME_QQ)时可以使用
    consumption_status
    enum[] 消费水平,[枚举详情]
    game_consumption_level
    enum[] 游戏消费能力,原 gamer_consumption_ability 定向升级版,gamer_consumption_ability 和 game_consumption_level 不能同时使用.,[枚举详情]
    residential_community_price
    struct[] 居住社区价格(仅支持单价格段,范围为:1~100000,单位是“元/m ²”)
    min
    integer 居住社区价格最小值限制,可填写的值为 1,1000,2000,3000,4000,5000,6000,7000,8000,9000,10000,20000,30000,40000,50000,60000,70000,80000,90000,100000
    max
    integer 居住社区价格最大值限制,可填写的值为 1000,2000,3000,4000,5000,6000,7000,8000,9000,10000,20000,30000,40000,50000,60000,70000,80000,90000,100000,999999999,最大值 999999999 代表 10 万以上
    financial_situation
    enum[] 财产状态,[枚举详情]
    consumption_type
    enum[] 消费类型定向,[枚举详情]
    wechat_ad_behavior
    struct 微信再营销,原微信广告行为定向升级为微信再营销,当且仅当投放微信广告时有效
    actions
    enum[] 包含的行为列表,多个行为之间为并集(or)的关系
    数组最小长度 0,最大长度 10
    QQ 账号支持枚举列表:{WECHAT_OFFICIAL_ACCOUNT_AD_LIKE,WECHAT_MOMENTS_AD_LIKE,MINI_GAME_WECHAT_REGISTERED },[枚举详情]
    excluded_actions
    enum[] 排除的行为列表,多个行为之间为并集(or)的关系
    数组最小长度 0,最大长度 10
    QQ 账号支持枚举列表:{WECHAT_OFFICIAL_ACCOUNT_AD_LIKE,WECHAT_MOMENTS_AD_LIKE,MINI_GAME_WECHAT_REGISTERED },[枚举详情]
    custom_audience
    integer[] 自定义定向用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    excluded_custom_audience
    integer[] 自定义排除用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    behavior_or_interest
    struct 行为兴趣意向定向
    interest
    struct 行为兴趣意向定向的兴趣部分
    targeting_tags
    string[] 兴趣标签列表(待废弃,后续仅支持 category_id_list、keyword_list)
    category_id_list
    integer[] 兴趣标签 id 列表,和关键词列表 keyword_list 个数之和不能大于 250,通过[targeting_tags/get]可获取兴趣标签列表 id 和对应标签名称
    keyword_list
    string[] 兴趣关键词列表,和兴趣标签 id 列表 category_id_list 个数之和不能大于 250,通过[targeting_tags/get]可获取兴趣关键词列表
    behavior
    struct[] 行为兴趣意向定向的行为部分
    targeting_tags
    string[] 行为标签列表(待废弃,后续仅支持 category_id_list、keyword_list)
    category_id_list
    integer[] 行为标签 id 列表,和关键词列表 keyword_list 个数之和不能大于 250,通过[targeting_tags/get]可获取行为标签列表 id 和对应标签名称
    keyword_list
    string[] 行为关键词列表,和行为标签 id 列表 category_id_list 个数之和不能大于 250,通过[targeting_tags/get]可获取行为关键词列表
    scene
    enum[] 行为兴趣意向定向的行为部分的场景,[枚举详情]
    time_window
    enum 行为兴趣意向定向的行为部分的时间窗,[枚举详情]
    intensity
    enum[] 行为兴趣意向定向的行为部分的强度,[枚举详情]
    intention
    struct 行为兴趣意向定向的意向部分
    targeting_tags
    integer[] 意向标签列表
    wechat_official_account_category
    integer[] 微信流量类型定向,当且仅当投放微信版位(SITE_SET_WECHAT)且非朋友圈广告(campaign_type != CAMPAIGN_TYPE_WECHAT_MOMENTS)时可以使用,通过[targeting_tags/get]可获取微信流量类型
    mobile_union_category
    integer[] 移动媒体类型定向,当且仅当投放移动联盟流量时(site_set = SITE_SET_MOBILE_UNION)时可以使用
    business_interest
    integer[] 商业兴趣定向,通过 [targeting_tags/get] 接口获取
    keyword
    struct 关键词定向
    words
    string[] 关键词
    app_behavior
    struct app 行为定向
    object_type
    enum 行为对象的类型,仅支持 APP 类目,[枚举详情]
    object_id_list
    integer[] 行为对象的 id,当 object_type = APP_CLASS 时,表示类目 id,类目 id 需填写最细一级 id
    time_window
    integer 行为对象的有效期,单位天
    act_id_list
    enum[] app 行为对象的行为,[枚举详情]
    paid_user
    enum[] 付费用户,[枚举详情]
    deprecated_custom_audience
    integer[] 自定义人群,通过 [人群管理模块] 创建的人群 id,不支持人群类型为 COMBINE 的人群 id
    deprecated_excluded_custom_audience
    integer[] 排他人群,通过 [人群管理模块] 创建的人群 id,不支持人群类型为 COMBINE 的人群 id
    deprecated_region
    integer[] 地域定向,可通过 [targeting_tags/get] 接口获取
    is_include_unsupported_targeting
    boolean 是否包含不支持定向,true:包含 API 暂不支持读写的定向信息,false:不包含 API 暂不支持读写的定向信息
    description
    string 定向描述
    is_deleted
    boolean 是否已删除,true:是,false:否
    created_time
    integer 创建时间(时间戳)
    last_modified_time
    integer 最后修改时间(时间戳)
    targeting_translation
    string 已选择定向条件的描述
    page_info
    struct 分页配置信息
    page
    integer 搜索页码
    page_size
    integer 一页显示的数据条数
    total_number
    integer 总条数
    total_page
    integer 总页数

    应答示例

    {
        "code": 0,
        "message": "",
        "message_cn": "",
        "data": {
            "list": [
                {
                    "targeting_id": "<TARGETING_ID>",
                    "targeting_name": "定向",
                    "targeting": {
                        "gender": [
                            "MALE"
                        ],
                        "age": [
                            {
                                "min": 18,
                                "max": 30
                            }
                        ],
                        "geo_location": {
                            "regions": [
                                110000,
                                310000
                            ],
                            "location_types": [
                                "LIVE_IN"
                            ]
                        }
                    },
                    "description": "description",
                    "is_deleted": false,
                    "created_time": 1491019858,
                    "last_modified_time": 1491098468
                }
            ],
            "page_info": {
                "page": 1,
                "page_size": 10,
                "total_number": 1,
                "total_page": 1
            }
        }
    }

    可视化调试工具


    删除定向
    全部接口
    V1.1
    loading

    所属权限 Ads Management
    请求地址 targetings/delete
    请求方法 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
    targeting_id*
    integer 定向 id

    使用说明

    1. 删除定向后,引用这个定向的所有广告将会没有曝光。

    请求示例

    
    curl 'https://api.e.qq.com/v1.1/targetings/delete?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -d 'account_id=<ACCOUNT_ID>' \
    -d 'targeting_id=<TARGETING_ID>' 
    					

    应答字段

    名称 类型 描述
    targeting_id
    integer 定向 id

    应答示例

    {
        "code": 0,
        "message": "",
        "message_cn": "",
        "data": {
            "targeting_id": "<TARGETING_ID>"
        }
    }

    可视化调试工具