list | struct[] | 返回信息列表 |
targeting_id | int64 | 定向 id |
targeting_name | string | 定向名称,同一帐号下的定向名称不允许重复 |
targeting | struct | 定向详细设置,存放所有定向条件 |
age | struct[] | 年龄定向(仅支持单年龄段,范围为 1466,66 代表的是 66 岁及 66 岁以上,如 1866 代表大于等于 18 岁) |
min | integer | 年龄最小值限制,(其中 15、16、17 不可以使用) |
max | integer | 年龄最大值限制 |
gender | enum[] | 性别定向(仅单选),[枚举详情] |
education | enum[] | 用户学历,[枚举详情],该功能即将下线,仅部分行业灰度开放,如有问题可联系您的客户运营 |
marital_status | enum[] | 婚恋育儿状态,[枚举详情],该功能即将下线,仅部分行业灰度开放,如有问题可联系您的客户运营 |
working_status | enum[] | 工作状态,[枚举详情] |
geo_location | struct | 地理位置定向, 针对朋友圈广告(campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS)地域必填,非朋友圈广告选填 如使用地域定向"regions"、"business_districts"、"custom_locations" 不能同时为空 |
location_types | enum[] | 地点类型,[枚举详情],选择限制:对于微信流量(site_set=SITE_SET_WECHAT、SITE_SET_MOMENTS、SITE_SET_MINI_GAME_WECHAT),仅能选择"LIVE_IN"(常住);使用商圈(business_district)以及自定义地理位置(custom_locations)时,仅可选 "VISITED_IN"(去过),"LIVE_IN"(常住);如:["LIVE_IN", "VISITED_IN"] |
regions | integer[] | 省市区县列表,当投放微信流量(site_set=SITE_SET_WECHAT、SITE_SET_MOMENTS、SITE_SET_MINI_GAME_WECHAT)时,仅支持中国大陆(不包含港澳台)地域 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 度,依次增加,例如 223323 表示-50 度到 50 度。数字与“”之间不允许存在空格) |
min | integer | 温度最小值限制 |
max | integer | 温度最大值限制 |
air_quality_index | enum[] | 空气质量指数,[枚举详情] |
app_install_status | enum[] | 应用安装(应用用户),当且仅当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION 时使用,[枚举详情] |
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 | 微信再营销,原微信广告行为定向升级为微信再营销,当且仅当投放微信流量(site_set=SITE_SET_WECHAT、SITE_SET_MOMENTS)时有效 |
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。 2022 年 6 月 30 日起,竞价 oCPC、oCPM 场景内,仅能使用“一方人群”的人群包,人群详情可参考[人群管理模块]。 |
excluded_custom_audience | integer[] | 自定义排除用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则组合人群包数不能超过 50。 2022 年 6 月 30 日起,竞价 oCPC、oCPM 场景内,仅能使用“一方人群”的人群包,人群详情可参考[人群管理模块]。 |
behavior_or_interest | struct | 行为兴趣意向定向,2022 年 6 月 30 日起,该定向将无法在竞价 oCPC、oCPM 场景使用。 |
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、category_id_list、keyword_list 三个结构不能同时为空 |
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)时可以使用。(字段待废弃,2021 年 10 月 29 日后不支持新建和更新) |
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] 接口获取 |
excluded_converted_audience | struct | 排除已转化用户定向 |
excluded_dimension | enum | 排除已转化用户定向范围 同应用,仅当推广目标为应用下载时可以使用,没有选择自定义转化行为(excluded_dimension)时,使用该定向出价需要满足是 oCPC、oCPM 广告; 同商品,仅当 SDPA 商品广告下使用,不支持自定义转化行为默认排除已下单、和已付费用户,不限制出价方式; 非同应用、非同商品,没有选择自定义转化行为(excluded_dimension)时,使用该定向出价需要满足是 oCPC、oCPM 广告;,[枚举详情] |
conversion_behavior_list | enum[] | 自定义转化行为,没有选择自定义转化行为(excluded_dimension)时,使用该定向需要校验是 oCPC、oCPM 广告 |
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 | 已选择定向条件的描述 |
targeting_source_type | enum | 定向包来源,自建或者来自分享,[枚举详情] 默认值:自建 |
share_from_account_id | integer | 分享的源账户 id 默认值:分享的源账户 id |
share_from_targeting_id | integer | 分享的源定向 id 默认值:分享的源定向 id |
page_info | struct | 分页配置信息 |
page | integer | 搜索页码 |
page_size | integer | 一页显示的数据条数 |
total_number | integer | 总条数 |
total_page | integer | 总页数 |