更新定向
全部接口
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 | 地理位置定向, 针对朋友圈广告(campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS)地域必填,非朋友圈广告选填 如使用地域定向"regions"、"business_districts"、"custom_locations" 不能同时为空 |
location_types*
|
enum[] | 地点类型,[枚举详情],选择限制: 数组最小长度 1,最大长度 4 枚举列表:{ RECENTLY_IN, VISITED_IN, LIVE_IN, TRAVEL_IN } |
regions
|
integer[] | 省市区县列表,当投放微信流量(site_set=SITE_SET_WECHAT、SITE_SET_MOMENTS、SITE_SET_MINI_GAME_WECHAT)时,仅支持中国大陆(不包含港澳台)地域 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, IOS_VERSION_14, 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, NET_5G } |
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[] | 行为兴趣意向定向的行为部分,targeting_tags、category_id_list、keyword_list 三个结构不能同时为空 数组长度为 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>"
}
}
可视化调试工具
问题仍未解决?
请前往腾讯广告反馈中心在线提交问题,我们的人工客服将为你服务