腾讯广告
  1. 定向
腾讯广告
  • 入门与指南
    • 快速入门
    • 术语介绍和技术准备
    • 业务流程
    • 发起请求
    • 接收应答
    • 接口清单
    • V1.3升级指引
  • 授权认证
    • OAuth授权
      • 获取 Authorization Code
      • 获取 Token
  • 账号管理
    • 广告账号
      • 添加腾讯广告服务商子客
      • 更新腾讯广告广告主信息
      • 查询腾讯广告广告主信息
      • 获取竞价广告账户日预算
      • 查询商务管家账号下广告主信息
      • 查询商务管家或同主体下广告主信息
    • 资质
      • 创建广告主资质
      • 更新广告主资质
      • 获取广告主资质
      • 删除广告主资质
    • 资金账户
      • 发起代理商与子客户之间转账
      • 获取资金账户信息
      • 获取资金账户日结明细
      • 获取资金账户日结明细(新,包含日终结余数据)
      • 获取资金流水
      • 获取微信资金账户信息
      • 获取微信资金账户流水信息
      • 获取实时消耗
      • 服务商当日分账户实时消耗
      • 服务商内部划账
      • 同商务管家子客间转账
      • 资金合并类型同商务管家子客间转账
      • 获取资金合并类型资金账户信息
      • 获取资金合并类型资金账户日结明细
      • 获取资金合并类型资金流水
  • 营销资产
    • 推广目标
      • 创建推广目标
      • 更新推广目标
      • 获取推广目标
      • 删除推广目标
      • 推广目标授权接口
      • 获取授权历史记录
      • 获取 Android 渠道包
    • 落地页
      • 获取落地页列表
      • 获取蹊径落地页模板列表
      • 获取蹊径落地页模板
      • 获取蹊径落地页互动模板配置
      • 蹊径-获取落地页列表
      • 蹊径-基于模板创建落地页
      • 蹊径-基于组件创建落地页
      • 蹊径-创建互动落地页
      • 蹊径-送审落地页
      • 蹊径-删除落地页
      • 生成虚拟人
      • 生成点击特效
      • 生成预览 token
    • 落地页号码包
      • 获取蹊径号码包列表
      • 添加蹊径号码包
      • 更新蹊径号码包
      • 获取蹊径微信号列表
      • 更新蹊径微信号
    • 视频
      • 添加视频文件
      • 获取视频文件
      • 修改视频信息
      • 删除视频
    • 图片
      • 添加图片文件
      • 获取图片信息
      • 修改图片信息
      • 删除图片
    • 品牌形象
      • 创建品牌形象
      • 获取品牌形象列表
    • 互动推广页
      • 获取互动推广页
    • 商品库
      • 创建商品库
      • 获取商品库
      • 添加商品
      • 行业列表
      • 获取商品
      • 获取商品详情
      • 更新商品信息
      • 批量更新商品信息
      • 获取审核失败的商品
      • 获取商品类目
      • 创建商品系列
      • 获取商品系列
    • 动态商品图片
      • 创建用于广告投放的动态广告图片
      • 获取动态广告图片信息
    • 动态商品视频
      • 创建用于广告投放的动态广告视频
    • 微信原生页
      • 基于模板创建微信原生页
      • 基于组件创建微信原生页
      • 获取微信落地页列表
      • 删除微信落地页
    • 广告应用分包
      • 创建应用分包
      • 更新应用子包版本
      • 查询应用分包列表
    • 优量汇流量包
      • 联盟流量包模块
      • 联盟流量包模块
      • 联盟流量包获取接口
      • 联盟流量包删除接口
    • 资产授权
      • 资产权限授予
      • 资产权限回收
      • 获取待确认接收授权列表接口
      • 资产预授权确认
      • 更新资产授权权限
    • 朋友圈头像昵称跳转页
      • 创建朋友圈头像昵称跳转页
      • 删除朋友圈头像昵称跳转页
      • 获取朋友圈头像昵称跳转页
    • 附加创意
      • 创建表单组件
      • 获取表单组件详情
      • 获取表单组件列表
    • 弹幕
      • 添加弹幕
      • 获取弹幕
      • 查询运营推荐弹幕列表
    • 本地门店
      • 批量录入门店
      • 批量更新门店信息
      • 批量删除门店信息
      • 查询门店信息
      • 解析门店地址
      • 搜索门店
      • 查询微信支付商户号
      • 查询门店类目
    • 创意组件
      • 创建创意组件
      • 更新创意组件
      • 查询创意组件信息
      • 删除创意组件
      • 更新创意组件状态
  • 广告管理
    • 推广计划
      • 创建推广计划
      • 更新推广计划
      • 获取推广计划
      • 删除推广计划
    • 广告组
      • 创建广告组
      • 更新广告组
      • 获取广告组
      • 删除广告组
    • 广告创意
      • 创建广告创意
      • 更新广告创意
      • 获取广告创意
      • 删除广告创意
    • 动态创意
      • 创建动态创意
      • 更新动态创意
      • 获取动态创意
    • 广告
      • 创建广告
      • 更新广告
      • 获取广告
      • 删除广告
    • 定向
      • 创建定向
        POST
      • 更新定向
        POST
      • 获取定向
        GET
      • 删除定向
        POST
      • 分享定向
        POST
      • 获取定向分享记录
        GET
    • 关键词
      • 创建关键词
      • 替换关键词
      • 删除关键词
      • 获取关键词
    • 否定词
      • 新增推广计划否定词
      • 新增广告组否定词
      • 修改推广计划否定词
      • 修改广告组否定词
      • 查询推广计划否定词
      • 查询广告组否定词
    • 批量操作
      • 创建批量请求
      • 更新广告主日限额信息
      • 更新推广计划日限额信息
      • 更新广告组日限额信息
      • 更新推广计划状态
      • 更新广告组状态
      • 更新广告状态
      • 更新广告组投放时间
      • 更新广告组出价
      • 创建批量异步请求任务
      • 获取批量异步请求任务列表
      • 获取批量异步请求任务详情
    • 出价
      • 获取分人群出价标签
  • 创意工具
    • 文案助手
      • 获取广告文案
    • 图片处理
      • 进行图片处理
    • 广告素材预审
      • 获取广告素材预审结果
    • 视频加字幕
      • 创建视频加字幕任务
    • 创建智能调整
      • 创建智能调整任务
    • 视频封面画图
      • 生成视频封面图
    • 词包
      • 获取词包
    • 通配符
      • 获取落地页通配符
    • 创意示例商品
      • 获取创意示例商品列表
    • 动态商品图片模板
      • 获取动态商品图片模板
    • 动态商品视频模板
      • 获取动态商品视频模板
    • 创意工具通用接口
      • 视频工具任务查询
    • 自动生成创意
      • 创建模板预览接口
      • 更新模板预览接口
      • 获取模板预览接口
      • 获取模板列表接口
    • 素材标签
      • 素材标签列表
      • 素材标签保存
  • 数据洞察
    • 广告数据洞察
      • 获取日报表
      • 获取小时报表
      • 获取定向标签报表
      • 落地页报表数据接口
      • 联盟广告位报表接口
      • 视频流失分析接口
      • 创建异步报表任务
      • 获取异步报表任务
      • 获取文件接口
    • 人群数据洞察
      • 人群洞察分析
    • 订单数据
      • 获取订单
      • 更新订单
    • 线索管理平台
      • 获取线索列表
      • 回传线索状态
      • 获取中间号
      • 获取通话结果
      • 获取一个账号下的全部通话结果
      • 获取网络电话 token
      • 网络电话呼叫
      • 外部线索数据导入
      • 外部线索状态更新
      • 更新线索基本信息
      • 获取无效赔付明细
    • 人群价值分析
      • 人群价值分析
  • 人群管理
    • 客服人群
      • 创建客户人群
      • 更新客户人群
      • 更新客户人群
      • 删除客户人群
    • 客户人群数据文件
      • 上传客户人群数据文件
      • 获取客户人群数据文件
    • 客户人群数预估
      • 人群覆盖数预估
    • 人群授权
      • 添加人群授权
      • 获取人群授权信息
    • 标签人群
      • 标签广场标签获取
    • 客户标签
      • 创建客户标签
      • 获取客户标签
      • 更新客户标签
      • 删除客户标签
    • 标签数据文件
      • 上传客户标签人群数据文件
      • 获取客户标签人群文件
    • 用户属性数据源
      • 创建用户属性数据源
      • 更新用户属性数据源
      • 获取用户属性数据源
    • 用户属性数据
      • 上传用户属性数据
  • 数据上报
    • 用户行为数据源
      • 创建用户行为数据源
      • 获取用户行为数据源
      • 获取用户行为数据源报表
      • 添加数据集
      • 获取数据集
      • 数据源分发关系更新
      • 数据源分发关系获取
    • 用户行为数据
      • 上传用户行为数据
    • 属性数据源
      • 创建属性数据源
      • 获取属性数据源
    • 属性数据源schema
      • 创建属性数据源 schema
      • 更新属性数据源 schema
      • 获取属性数据源 Schema
    • 属性数据文件上传
      • 创建属性数据文件上传会话
      • 提交属性数据文件上传会话
      • 上传属性数据文件
  • 附近推
    • 附近推开户
      • 附近推商家开户
      • 更新附近推商家信息
      • 查询附近推商家信息
    • 附近推账户资金
      • 微信服务商子客之间转账
    • 附近推账户资质
      • 添加附近推商家资质
      • 删除附近推商家资质
      • 查询附近推商家资质信息
    • 附近推广告投放
      • 创建广告
      • 拉取广告列表
      • 更新广告
      • 手动结束广告
      • 拉取曝光预估数据
    • 附近推门店
      • 批量录入门店
      • 批量更新门店信息
      • 批量删除门店信息
      • 查询门店信息
      • 解析门店地址
      • 搜索门店
      • 查询微信支付商户号
      • 查询门店类目
  • 审核工具
    • 素材风险检测
      • 获取元素的预审结果
    • 广告申诉复审
      • 发起广告申诉复审
      • 获取广告申诉复审结果
      • 获取广告申诉复审配额
  • 投放辅助工具
    • 定向标签
      • 获取定向标签
      • 获取行为/兴趣/意向标签覆盖人群数
    • 场景定向标签
      • 获取场景定向标签
    • 创意形式
      • 获取创意规格详情
      • 获取创意规格列表
    • 广告投放能力
      • 查询优化目标权限
    • 预估能力
      • 人数预估
      • 获取出价模拟信息
      • 获取当日转化效果预估数据
    • 广告预览
      • 创建预览
      • 获取预览受众
      • 获取广告预览二维码
    • ·异步任务
      • 创建异步任务
      • 获取异步任务
      • 获取文件接口
    • 拆分对比实验
      • 创建拆分对比实验
      • 更新拆分对比实验
      • 删除拆分对比实验
      • 获取拆分对比实验
    • 广告诊断
      • 获取广告诊断信息
    • 广告创意预览
      • 获取广告创意预览
    • 微信广告标签
      • 获取微信广告标签
    • 广告标签
      • 获取广告标签
    • 转化归因
      • 新增转化归因
      • 获取转化归因
    • 微信原生页
      • 获取原生页授权方信息
      • 获取企业微信客服组列表
      • 增加企业微信组件客服组
      • 更新企业微信组件客服组
      • 获取企业微信组件客服列表
      • 更新企业微信组件客服状态
    • 微信公众号账户升级
      • 获取微信公众号账户升级状态
    • 腾讯广告账户报表指标升级
      • 获取腾讯广告平台广告账户升级状态
    • 探索推广工具
      • 查询关键词流量接口
      • 获取关键词推荐结果
      • 查询行业业务点信息
    • 视频号精选评论管理
      • 设置视频号评论管理
    • 游戏特征信息
      • 获取游戏特征标签
      • 新增游戏 app 特征
      • 更新游戏 app 特征
      • 获取游戏 app 特征
  • 附录
    • 更多信息
  1. 定向

获取定向

开发环境
开发环境
GET
/v1.3/targetings/get

请求参数#

标有*的参数为必填项
名称类型描述
account_id*integer广告主帐号 id,有操作权限的帐号 id,不支持代理商 id
filteringstruct[]过滤条件,若此字段不传,或传空则视为无限制条件,详见 [过滤条件] 数组最小长度 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 }
pageinteger搜索页码,默认值:1 最小值 1,最大值 99999
page_sizeinteger一页显示的数据条数,默认值:10。最小值 1,最大值 100
使用说明
1.
当且仅当根据定向 id 进行查询时,获取的定向列表包含已删除的定向。
2.
v1.0 创建并使用的 targeting 已迁移到 adgroup 信息中,v1.1 的 targeting 模块不支持 v1.0 创建定向包的读写。

应答字段#

名称类型描述
liststruct[]返回信息列表
targeting_idint64定向 id
targeting_namestring定向名称,同一帐号下的定向名称不允许重复
targetingstruct定向详细设置,存放所有定向条件
agestruct[]年龄定向(仅支持单年龄段,范围为 1466,66 代表的是 66 岁及 66 岁以上,如 1866 代表大于等于 18 岁)
mininteger年龄最小值限制,(其中 15、16、17 不可以使用)
maxinteger年龄最大值限制
genderenum[]性别定向(仅单选),[枚举详情]
educationenum[]用户学历,[枚举详情],该功能即将下线,仅部分行业灰度开放,如有问题可联系您的客户运营
marital_statusenum[]婚恋育儿状态,[枚举详情],该功能即将下线,仅部分行业灰度开放,如有问题可联系您的客户运营
working_statusenum[]工作状态,[枚举详情]
geo_locationstruct地理位置定向, 针对朋友圈广告(campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS)地域必填,非朋友圈广告选填 如使用地域定向"regions"、"business_districts"、"custom_locations" 不能同时为空
location_typesenum[]地点类型,[枚举详情],选择限制:对于微信流量(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"]
regionsinteger[]省市区县列表,当投放微信流量(site_set=SITE_SET_WECHAT、SITE_SET_MOMENTS、SITE_SET_MINI_GAME_WECHAT)时,仅支持中国大陆(不包含港澳台)地域 id,可通过 [targeting_tags/get] 接口获取
business_districtsinteger[]商圈 id 列表,可通过 [targeting_tags/get] 接口获取
custom_locationsstruct[]自定义地理位置列表,使用火星系坐标,当广告类型为朋友圈广告时(campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS),custom_locations 的数组长度限制为最小长度 1。
longitudefloat经度,单位度
latitudefloat纬度,单位度
radiusinteger半径,单位米
user_osenum[]操作系统定向, 当 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_deviceenum[]新设备,最近三个月第一次使用该设备的用户,[枚举详情]
device_priceenum[]设备价格定向,该功能即将下线,仅部分行业灰度开放,如有问题可联系您的客户运营,[枚举详情]
device_brand_modelstruct设备品牌型号定向,该功能即将下线,仅部分行业灰度开放,如有问题可联系您的客户运营
included_listinteger[]设备品牌型号定向,可通过 [targeting_tags/get] 接口获取
excluded_listinteger[]排除设备品牌型号列表,不能与 included_list 同时使用,可通过 [targeting_tags/get] 接口获取
network_typeenum[]联网方式定向,[枚举详情]
network_operatorenum[]移动运营商定向,该功能即将下线,仅部分行业灰度开放,如有问题可联系您的客户运营,[枚举详情]
network_sceneenum[]上网场景,[枚举详情]
dressing_indexenum[]穿衣指数,[枚举详情]
uv_indexenum[]紫外线指数,[枚举详情]
makeup_indexenum[]化妆指数,[枚举详情]
climateenum[]气象,[枚举详情]
temperaturestruct[]温度(仅单温度段,以绝对零度值(-273)表示 0 度,依次增加,例如 223323 表示-50 度到 50 度。数字与“”之间不允许存在空格)
mininteger温度最小值限制
maxinteger温度最大值限制
air_quality_indexenum[]空气质量指数,[枚举详情]
app_install_statusenum[]应用安装(应用用户),当且仅当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION 时使用,[枚举详情]
consumption_statusenum[]消费水平,[枚举详情],该功能即将下线,仅部分行业灰度开放,如有问题可联系您的客户运营
game_consumption_levelenum[]游戏消费能力,原 gamer_consumption_ability 定向升级版,gamer_consumption_ability 和 game_consumption_level 不能同时使用.,该功能即将下线,仅部分行业灰度开放,如有问题可联系您的客户运营,[枚举详情]
residential_community_pricestruct[]居住社区价格(仅支持单价格段,范围为:1~100000,单位是“元/m ²”)
mininteger居住社区价格最小值限制,可填写的值为 1,1000,2000,3000,4000,5000,6000,7000,8000,9000,10000,20000,30000,40000,50000,60000,70000,80000,90000,100000
maxinteger居住社区价格最大值限制,可填写的值为 1000,2000,3000,4000,5000,6000,7000,8000,9000,10000,20000,30000,40000,50000,60000,70000,80000,90000,100000,999999999,最大值 999999999 代表 10 万以上
financial_situationenum[]财产状态,该功能即将下线,仅部分行业灰度开放,如有问题可联系您的客户运营,[枚举详情]
consumption_typeenum[]消费类型定向,[枚举详情]
wechat_ad_behaviorstruct微信再营销,原微信广告行为定向升级为微信再营销,当且仅当投放微信流量(site_set=SITE_SET_WECHAT、SITE_SET_MOMENTS)时有效
actionsenum[]包含的行为列表,多个行为之间为并集(or)的关系 数组最小长度 0,最大长度 10 QQ 账号支持枚举列表:{WECHAT_OFFICIAL_ACCOUNT_AD_LIKE,WECHAT_MOMENTS_AD_LIKE,MINI_GAME_WECHAT_REGISTERED },[枚举详情]
excluded_actionsenum[]排除的行为列表,多个行为之间为并集(or)的关系 数组最小长度 0,最大长度 10 QQ 账号支持枚举列表:{WECHAT_OFFICIAL_ACCOUNT_AD_LIKE,WECHAT_MOMENTS_AD_LIKE,MINI_GAME_WECHAT_REGISTERED },[枚举详情]
custom_audienceinteger[]自定义定向用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则组合人群包数不能超过 50。 2022 年 6 月 30 日起,竞价 oCPC、oCPM 场景内,仅能使用“一方人群”的人群包,人群详情可参考[人群管理模块]。
excluded_custom_audienceinteger[]自定义排除用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则组合人群包数不能超过 50。 2022 年 6 月 30 日起,竞价 oCPC、oCPM 场景内,仅能使用“一方人群”的人群包,人群详情可参考[人群管理模块]。
behavior_or_intereststruct行为兴趣意向定向,2022 年 6 月 30 日起,该定向将无法在竞价 oCPC、oCPM 场景使用。
intereststruct行为兴趣意向定向的兴趣部分
targeting_tagsstring[]兴趣标签列表(待废弃,后续仅支持 category_id_list、keyword_list)
category_id_listinteger[]兴趣标签 id 列表,和关键词列表 keyword_list 个数之和不能大于 250,通过[targeting_tags/get]可获取兴趣标签列表 id 和对应标签名称
keyword_liststring[]兴趣关键词列表,和兴趣标签 id 列表 category_id_list 个数之和不能大于 250,通过[targeting_tags/get]可获取兴趣关键词列表
behaviorstruct[]行为兴趣意向定向的行为部分,targeting_tags、category_id_list、keyword_list 三个结构不能同时为空
targeting_tagsstring[]行为标签列表(待废弃,后续仅支持 category_id_list、keyword_list)
category_id_listinteger[]行为标签 id 列表,和关键词列表 keyword_list 个数之和不能大于 250,通过[targeting_tags/get]可获取行为标签列表 id 和对应标签名称
keyword_liststring[]行为关键词列表,和行为标签 id 列表 category_id_list 个数之和不能大于 250,通过[targeting_tags/get]可获取行为关键词列表
sceneenum[]行为兴趣意向定向的行为部分的场景,[枚举详情]
time_windowenum行为兴趣意向定向的行为部分的时间窗,[枚举详情]
intensityenum[]行为兴趣意向定向的行为部分的强度,[枚举详情]
intentionstruct行为兴趣意向定向的意向部分
targeting_tagsinteger[]意向标签列表
wechat_official_account_categoryinteger[]微信流量类型定向,当且仅当投放微信版位(SITE_SET_WECHAT)且非朋友圈广告(campaign_type != CAMPAIGN_TYPE_WECHAT_MOMENTS)时可以使用,通过[targeting_tags/get]可获取微信流量类型
mobile_union_categoryinteger[]移动媒体类型定向,当且仅当投放移动联盟流量时(site_set = SITE_SET_MOBILE_UNION)时可以使用。(字段待废弃,2021 年 10 月 29 日后不支持新建和更新)
business_interestinteger[]商业兴趣定向,通过 [targeting_tags/get] 接口获取
keywordstruct关键词定向
wordsstring[]关键词
app_behaviorstructapp 行为定向
object_typeenum行为对象的类型,仅支持 APP 类目,[枚举详情]
object_id_listinteger[]行为对象的 id,当 object_type = APP_CLASS 时,表示类目 id,类目 id 需填写最细一级 id
time_windowinteger行为对象的有效期,单位天
act_id_listenum[]app 行为对象的行为,[枚举详情]
paid_userenum[]付费用户,[枚举详情]
deprecated_custom_audienceinteger[]自定义人群,通过 [人群管理模块] 创建的人群 id,不支持人群类型为 COMBINE 的人群 id
deprecated_excluded_custom_audienceinteger[]排他人群,通过 [人群管理模块] 创建的人群 id,不支持人群类型为 COMBINE 的人群 id
deprecated_regioninteger[]地域定向,可通过 [targeting_tags/get] 接口获取
excluded_converted_audiencestruct排除已转化用户定向
excluded_dimensionenum排除已转化用户定向范围 同应用,仅当推广目标为应用下载时可以使用,没有选择自定义转化行为(excluded_dimension)时,使用该定向出价需要满足是 oCPC、oCPM 广告; 同商品,仅当 SDPA 商品广告下使用,不支持自定义转化行为默认排除已下单、和已付费用户,不限制出价方式; 非同应用、非同商品,没有选择自定义转化行为(excluded_dimension)时,使用该定向出价需要满足是 oCPC、oCPM 广告;,[枚举详情]
conversion_behavior_listenum[]自定义转化行为,没有选择自定义转化行为(excluded_dimension)时,使用该定向需要校验是 oCPC、oCPM 广告
is_include_unsupported_targetingboolean是否包含不支持定向,true:包含 API 暂不支持读写的定向信息,false:不包含 API 暂不支持读写的定向信息
descriptionstring定向描述
is_deletedboolean是否已删除,true:是,false:否
created_timeinteger创建时间(时间戳)
last_modified_timeinteger最后修改时间(时间戳)
targeting_translationstring已选择定向条件的描述
targeting_source_typeenum定向包来源,自建或者来自分享,[枚举详情] 默认值:自建
share_from_account_idinteger分享的源账户 id 默认值:分享的源账户 id
share_from_targeting_idinteger分享的源定向 id 默认值:分享的源定向 id
page_infostruct分页配置信息
pageinteger搜索页码
page_sizeinteger一页显示的数据条数
total_numberinteger总条数
total_pageinteger总页数
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1.3/targetings/get' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'fields;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'filtering=[{"field":"targeting_name","operator":"EQUALS","values":["定向"]}]' \
--data-urlencode 'page=1' \
--data-urlencode 'page_size=10'
响应示例响应示例
{
    "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
        }
    }
}

请求参数

Header 参数
access_token
string 
必需
以Query Parameter方式在请求路径中传递。 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节。
默认值:
<ACCESS_TOKEN>
timestamp
string 
必需
以Query Parameter方式在请求路径中传递。 当前的时间戳,单位为秒,允许客户端请求最大时间误差为300秒。
MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8,例如当时间戳为1494840119时,表示 2018-05-15 17:21:59
默认值:
<TIMESTAMP>
nonce
string 
必需
以Query Parameter方式在请求路径中传递。 随机字串标识,不超过32个字符,由调用方自行生成,需保证全局唯一性。
默认值:
<NONCE>
fields
string 
必需
指定返回的字段列表,为选填字段,如不填写,则根据默认值进行返回
Body 参数application/x-www-form-urlencoded
account_id
integer 
必需
广告主帐号 id,有操作权限的帐号 id,不支持代理商 id
示例值:
<ACCOUNT_ID>
filtering
string 
可选
过滤条件,若此字段不传,或传空则视为无限制条件,详见 [过滤条件]
数组最小长度 1,最大长度 2
示例值:
[{"field":"targeting_name","operator":"EQUALS","values":["定向"]}]
page
string 
可选
搜索页码,默认值:1
最小值 1,最大值 99999
示例值:
1
page_size
string 
可选
一页显示的数据条数,默认值:10。最小值 1,最大值 100
示例值:
10

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
message_cn
string 
必需
data
object 
必需
list
array [object {7}] 
返回信息列表
必需
page_info
object 
分页配置信息
必需
修改于 2023-11-06 09:20:35
上一页
更新定向
下一页
删除定向
Built with