获取定向

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主帐号 id，有操作权限的帐号 id，不支持代理商 id
filtering	struct[]	过滤条件，若此字段不传，或传空则视为无限制条件，详见 [过滤条件] 数组最小长度 1，最大长度 2
field*	string	过滤字段可选值：{ targeting_id, targeting_name, created_time, last_modified_time, targeting_source_type, share_from_account_id, share_from_targeting_id }
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 } 当 field 取值 targeting_source_type 时，枚举列表：{ EQUALS } 当 field 取值 share_from_account_id 时，枚举列表：{ EQUALS, IN } 当 field 取值 share_from_targeting_id 时，枚举列表：{ EQUALS, IN }
values*	string[]	字段取值，values 数组的个数限制与 operator 的取值相关，详见 [过滤条件] 当 field 取值 targeting_name 时，字段长度最小 1 字节，长度最大 120 字节当 field 取值 created_time 时，字段长度为 10 字节当 field 取值 last_modified_time 时，字段长度为 10 字节当 field 取值 targeting_source_type 时，枚举列表：{ TARGETING_SOURCE_TYPE_CREATE, TARGETING_SOURCE_TYPE_SHARE }
page	integer	搜索页码，默认值：1 最小值 1，最大值 99999
page_size	integer	一页显示的数据条数，默认值：10。最小值 1，最大值 100

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

应答字段

名称	类型	描述
list	struct[]	返回信息列表
targeting_id	int64	定向 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	地理位置定向，针对朋友圈广告（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 度，依次增加，例如 223~~323 表示-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	总页数

application/json

Body

code

integer

必需

message

string

必需

message_cn

string

必需

data

object

必需

list

array [object {7}]

返回信息列表

必需

page_info

object

分页配置信息

必需

请求参数#

应答字段#

请求参数

返回响应

请求参数

应答字段