更新定向
全部接口
V1.1
loading
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[] | 地点类型，[枚举详情]，选择限制： 数组最小长度 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 字节 |
使用说明
- 地理位置定向的省市区县以及商圈 id、行为兴趣意向定向、微信公众号类型定向、移动媒体类型定向的可选值列表可通过 targeting_tags/get 接口进行获取。
请求示例
curl 'https://api.e.qq.com/v1.1/targetings/update?access_token=<ACCESS_TOKEN>×tamp=<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>"
}
}可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
