人数预估 (Estimation)
V1.1
loading
本节将为您介绍人数预估 (Estimation) 相关接口。该接口支持查询在指定广告组相关信息（广告版位、出价、标的物、投放时间段等）、广告创意相关信息（创意形式id）、定向等条件下的覆盖人数。特别说明：当接口传入adgroup_id时，则表示基于历史广告预估覆盖人数以及获取建议出价，如广告未审核通过，则会存在获取数据为0的情况。
- 人数预估（estimation/get）
所属权限（scope）：Ads Management
预估覆盖人数
全部接口
V1.1
loading
所属权限
Audience Management
请求地址
estimation/get
请求方法
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
adgroup
struct
广告组信息所组成的对象
adgroup_id
int64
广告组 id
adgroup_name
string
广告组名称，同一帐号下的广告组名称不允许重复
字段长度最小 1 字节，长度最大 120 字节
automatic_site_enabled
boolean
是否开启自动版位功能，此字段与 site_set 字段至少需要写入一个。
可选值：{ true, false }
site_set
enum[]
投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO 的组合，[枚举详情]
数组最小长度 1，最大长度 32
枚举列表：{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_MYAPP, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_KUAISHOU, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_MOBILE_YYB, SITE_SET_QQSHOPPING, SITE_SET_CHANNELS, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN, SITE_SET_FREETRADE, SITE_SET_QBSEARCH, SITE_SET_FREETRADE_FINDER, SITE_SET_BROWSER_MOBILE, SITE_SET_SEARCH_SCENE, SITE_SET_BROWSER_PC, SITE_SET_CHANNELS_CONTENT_PROMOTION, SITE_SET_FREETRADE_WEAPP, SITE_SET_FREETRADE_QQ, SITE_SET_YUNXUAN }
bid_amount
integer
广告出价，单位为分，出价限制：
CPC 出价限制：介于 10 分-10,000 分之间（0.1 元-100 元，单位为人民币） CPM 出价限制：介于 150 分-99,900 分之间（1.5 元-999 元，单位为人民币，当 SITE_SET 仅为 SITE_SET_PCQQ 时，介于 50 分-99,900 分之间） CPA 出价限制：介于 100 分-50,000 分之间（1 元-500 元，单位为人民币） oCPC/oCPM 出价限制：介于 1 分-500,000 分之间（0.01 元-5000 元，单位为人民币）
promoted_object_type
enum
标的物类型，[枚举详情]
枚举列表：{ PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_QUICK_APP, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_QQ_MESSAGE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT }
billing_event
enum
计费类型，optimization_goal、billing_event 必须同时填写，[枚举详情]
枚举列表：{ BILLINGEVENT_CLICK, BILLINGEVENT_APP_DOWNLOAD, BILLINGEVENT_IMPRESSION }
optimization_goal
enum
广告优化目标类型，optimization_goal、billing_event 必须同时填写。目前 OPTIMIZATIONGOAL_LEADS_COLLECT、OPTIMIZATIONGOAL_APPLY、OPTIMIZATIONGOAL_PRE_CREDIT、OPTIMIZATIONGOAL_CREDIT、OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS 等五个目标灰度开放中，[枚举详情]
枚举列表：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_PHONE_CALL, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_R3, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED }
promoted_object_id
string
推广目标 id，详见 [查询推广目标 id]
字段长度最小 0 字节，长度最大 128 字节
time_series
string
投放时间段，格式为 48 * 7 位字符串，且都为 0 和 1，以半个小时为最小粒度，从周一零点开始至周日 24 点结束。0 为不投放，1 为投放，全传 1 视为全时段投放，不允许全部传 0。
字段长度为 336 字节
adcreative
struct[]
创意信息所组成的对象
数组最小长度 1，最大长度 10
adcreative_template_id*
integer
创意形式 id，具体请咨询您的运营接口人，也可通过 [创意规格查询工具] 进行查询
adcreative_elements
struct
创意元素，不同 adcreative_template_id 要求的元素不尽相同，其中部分创意形式的文案元素支持换行能力，使用“\n ”表示换行，占 0.5 个等宽字符，建议行数不超过 6 行，具体情况可通过 [创意规格查询工具] 进行查询
deep_link_url
string
应用直达页 URL，微信朋友圈广告（site_set=SITE_SET_MOMENTS）的创意形式，promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_ANDROID 时，需要同时填写 deeplink_ios_appid ； 或 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_IOS 时，需要同时填写 deeplink_anroid_appid，以确保双端都能支持应用直达。
字段长度最小 0 字节，长度最大 2048 字节
targeting
struct
定向详细设置，存放所有定向条件
age
struct[]
年龄定向（仅支持单年龄段，范围为 14~66，66 代表的是 66 岁及 66 岁以上，如 18~66 代表大于等于 18 岁）
数组最小长度 1，最大长度 5
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 }
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"]
数组最小长度 1，最大长度 5
枚举列表：{ RECENTLY_IN, VISITED_IN, LIVE_IN, TRAVEL_IN, LIVE_AND_RECENTLY, INTELLIGENCE }
regions
integer[]
省市区县列表，当投放微信流量（site_set=SITE_SET_WECHAT、SITE_SET_MOMENTS、SITE_SET_MINI_GAME_WECHAT）时，仅支持中国大陆（不包含港澳台）地域 id，可通过 [targeting_tags/get] 接口获取
数组最小长度 0，最大长度 1000
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, IOS_VERSION_15, IOS_VERSION_16, IOS_VERSION_17, 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, ANDROID_VERSION_11, ANDROID_VERSION_12, ANDROID_VERSION_13, ANDROID_VERSION_14, WINDOWS, MAC }
device_price
enum[]
设备价格定向，该功能即将下线，仅部分行业灰度开放，如有问题可联系您的客户运营，[枚举详情]
数组最小长度 1，最大长度 100
枚举列表：{ PRICE_1500_LESS, PRICE_1500_2500, PRICE_2500_3500, PRICE_3500_4500, PRICE_4500_MORE }
network_type
enum[]
联网方式定向，[枚举详情]
数组最小长度 1，最大长度 100
枚举列表：{ WIFI, NET_2G, NET_3G, NET_4G, NET_5G }
network_operator
enum[]
移动运营商定向，该功能即将下线，仅部分行业灰度开放，如有问题可联系您的客户运营，[枚举详情]
数组最小长度 1，最大长度 100
枚举列表：{ CMCC, CUC, CTC }
app_install_status
enum[]
应用安装（应用用户），当且仅当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION 时使用，[枚举详情]
数组长度为 1
枚举列表：{ NOT_INSTALLED, INSTALLED }
mini_game_qq_status
enum[]
QQ 小游戏使用定向，[枚举详情]，当且仅当投放 QQ 小游戏推广目标（promoted_object_type= PROMOTED_OBJECT_TYPE_MINI_GAME_QQ）时可以使用
数组长度为 1
枚举列表：{ NOT_USED, USED }
consumption_status
enum[]
消费水平，[枚举详情]，该功能即将下线，仅部分行业灰度开放，如有问题可联系您的客户运营
数组最小长度 1，最大长度 100
枚举列表：{ HIGH, LOW }
game_consumption_level
enum[]
游戏消费能力，原 gamer_consumption_ability 定向升级版，gamer_consumption_ability 和 game_consumption_level 不能同时使用.，该功能即将下线，仅部分行业灰度开放，如有问题可联系您的客户运营，[枚举详情]
数组最小长度 1，最大长度 2
枚举列表：{ HIGH, NORMAL }
paid_user
enum[]
付费用户，[枚举详情]
数组最小长度 1，最大长度 100
枚举列表：{ APP_PAID, ECOMMERCE_PAID, LATENT_VIR_PAY }
wechat_ad_behavior
struct
微信广告行为定向，当且仅当投放微信广告时有效
actions
enum[]
包含的行为列表，多个行为之间为并集（or）的关系，[枚举详情]
数组最小长度 0，最大长度 10
枚举列表：{ WECHAT_OFFICIAL_ACCOUNT_FOLLOWED, WECHAT_COUPON_OBTAINED, WECHAT_OFFICIAL_ACCOUNT_AD_LIKE, WECHAT_MOMENTS_AD_LIKE }
excluded_actions
enum[]
排除的行为列表，多个行为之间为并集（or）的关系，[枚举详情]
数组最小长度 0，最大长度 10
枚举列表：{ WECHAT_OFFICIAL_ACCOUNT_FOLLOWED, WECHAT_COUPON_OBTAINED, WECHAT_OFFICIAL_ACCOUNT_AD_LIKE, WECHAT_MOMENTS_AD_LIKE }
custom_audience
integer[]
定向用户群，通过 [人群管理模块] 创建的人群 id，custom_audience 和 excluded_custom_audience 个数之和不能超过 50 个
数组最小长度 1，最大长度 50
excluded_custom_audience
integer[]
排除用户群，通过 [人群管理模块] 创建的人群 id，custom_audience 和 excluded_custom_audience 个数之和不能超过 50 个
数组最小长度 1，最大长度 50
behavior_or_interest
struct
行为兴趣意向定向，2022 年 6 月 30 日起，该定向将无法在竞价 oCPC、oCPM 场景使用。
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
mobile_union_category
integer[]
移动媒体类型定向，当且仅当投放移动联盟流量时（site_set = SITE_SET_MOBILE_UNION）时可以使用。（字段待废弃，2021 年 10 月 29 日后不支持新建和更新）
数组最小长度 1，最大长度 200
financial_situation
enum[]
财产状态，该功能即将下线，仅部分行业灰度开放，如有问题可联系您的客户运营，[枚举详情]
数组最小长度 1，最大长度 2
枚举列表：{ CAR_OWNERS, HOME_OWNERS }
campaign_spec
struct
推广计划信息
campaign_id
int64
推广计划 id
campaign_type
enum
推广计划类型，[枚举详情]
枚举列表：{ CAMPAIGN_TYPE_NORMAL, CAMPAIGN_TYPE_WECHAT_MOMENTS, CAMPAIGN_TYPE_SEARCH, CAMPAIGN_TYPE_FREETRADE, CAMPAIGN_TYPE_CONTENT_PROMOTION }
daily_budget
integer
推广计划日预算，单位为分，微信朋友圈广告（campaign_type = CAMPAIGN_TYPE_WECHAT_MOMENTS）不可使用，其他广告可使用。日预算需介于 5,000 分-4,000,000,000 分之间（50 元-40,000,000 元，单位为人民币）；
scene_spec
struct
场景定向
display_scene
enum[]
广告展示场景，当且仅当投放优量汇流量时可以使用，[枚举详情]
数组最小长度 0，最大长度 32
枚举列表：{ DISPLAY_SCENE_BANNER, DISPLAY_SCENE_INLINE, DISPLAY_SCENE_SPLASH, DISPLAY_SCENE_NATIVE, DISPLAY_SCENE_REWARDED_VIDEO }
使用说明
- campaign_spec、adgroup、adcreative、targeting、scene_spec 不能同时为空，如 adgroup 结构同时传了 adgroup_id 和其余字段，则以其余字段信息为准； campaign_spec 结构的逻辑同 adgroup 结构。
请求示例
curl 'https://api.e.qq.com/v1.1/estimation/get?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'targeting={"gender":["MALE"],"age":[{"min":18,"max":30}],"geo_location":{"regions":[110000,310000],"location_types":["LIVE_IN"]}}' \
-d 'campaign_spec={
"campaign_id": "<CAMPAIGN_ID>"
}' \
-d 'scene_spec={
"display_scene": []
}'
应答字段
名称
类型
描述
max_active_user_count
integer
预估最大覆盖用户数
approximate_count
integer
预估日覆盖用户数最大值
impression
integer
预估日曝光量最大值
min_bid_amount
integer
出价下限，单位为分
max_bid_amount
integer
出价上限，单位为分
suggest_min_bid_amount
integer
建议最小出价，单位为分
suggest_max_bid_amount
integer
建议最大出价，单位为分
suggest_bid_content_ocpa
string
oCPC/oCPM 广告返回建议内容
min_users_daily
integer
预估日覆盖用户数下限
max_users_daily
integer
预估日覆盖用户数上限
min_exposure_daily
integer
预估日曝光量下限
max_exposure_daily
integer
预估日曝光量上限
targeting_status
enum
定向状态，[枚举详情]
suggest_targeting
string[]
建议调整的定向，字符数组
is_real_exposure_supported
boolean
当前请求是否满足真实曝光量预估要求
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"max_active_user_count": 10232887,
"approximate_count": 1023288,
"impression": 102311,
"min_bid_amount": 117,
"max_bid_amount": 199,
"suggest_targeting": []
}
}
可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
loading
本节将为您介绍人数预估 (Estimation) 相关接口。该接口支持查询在指定广告组相关信息（广告版位、出价、标的物、投放时间段等）、广告创意相关信息（创意形式id）、定向等条件下的覆盖人数。特别说明：当接口传入adgroup_id时，则表示基于历史广告预估覆盖人数以及获取建议出价，如广告未审核通过，则会存在获取数据为0的情况。
- 人数预估（estimation/get）
所属权限（scope）：Ads Management
预估覆盖人数
全部接口
V1.1
loading
V1.1
loading
| 所属权限 | Audience Management |
| 请求地址 | estimation/get |
| 请求方法 | 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 |
|
adgroup
|
struct | 广告组信息所组成的对象 |
|
adgroup_id
|
int64 | 广告组 id |
|
adgroup_name
|
string | 广告组名称，同一帐号下的广告组名称不允许重复 字段长度最小 1 字节，长度最大 120 字节 |
|
automatic_site_enabled
|
boolean | 是否开启自动版位功能，此字段与 site_set 字段至少需要写入一个。 可选值：{ true, false } |
|
site_set
|
enum[] | 投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO 的组合，[枚举详情] 数组最小长度 1，最大长度 32 枚举列表：{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_MYAPP, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_KUAISHOU, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_MOBILE_YYB, SITE_SET_QQSHOPPING, SITE_SET_CHANNELS, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN, SITE_SET_FREETRADE, SITE_SET_QBSEARCH, SITE_SET_FREETRADE_FINDER, SITE_SET_BROWSER_MOBILE, SITE_SET_SEARCH_SCENE, SITE_SET_BROWSER_PC, SITE_SET_CHANNELS_CONTENT_PROMOTION, SITE_SET_FREETRADE_WEAPP, SITE_SET_FREETRADE_QQ, SITE_SET_YUNXUAN } |
|
bid_amount
|
integer | 广告出价，单位为分，出价限制： |
|
promoted_object_type
|
enum | 标的物类型，[枚举详情] 枚举列表：{ PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_QUICK_APP, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_QQ_MESSAGE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT } |
|
billing_event
|
enum | 计费类型，optimization_goal、billing_event 必须同时填写，[枚举详情] 枚举列表：{ BILLINGEVENT_CLICK, BILLINGEVENT_APP_DOWNLOAD, BILLINGEVENT_IMPRESSION } |
|
optimization_goal
|
enum | 广告优化目标类型，optimization_goal、billing_event 必须同时填写。目前 OPTIMIZATIONGOAL_LEADS_COLLECT、OPTIMIZATIONGOAL_APPLY、OPTIMIZATIONGOAL_PRE_CREDIT、OPTIMIZATIONGOAL_CREDIT、OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS 等五个目标灰度开放中，[枚举详情] 枚举列表：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_PHONE_CALL, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS, OPTIMIZATIONGOAL_24H_FIRSTPAY, OPTIMIZATIONGOAL_STORE_STAY, OPTIMIZATIONGOAL_R3, OPTIMIZATIONGOAL_LOW_PRICE_INSURANCE_PAYMENT, OPTIMIZATIONGOAL_UNDERWRITING, OPTIMIZATIONGOAL_FIRST_WITHDRAW, OPTIMIZATIONGOAL_BRIDGING_COURSE_COMPLETED } |
|
promoted_object_id
|
string | 推广目标 id，详见 [查询推广目标 id] 字段长度最小 0 字节，长度最大 128 字节 |
|
time_series
|
string | 投放时间段，格式为 48 * 7 位字符串，且都为 0 和 1，以半个小时为最小粒度，从周一零点开始至周日 24 点结束。0 为不投放，1 为投放，全传 1 视为全时段投放，不允许全部传 0。 字段长度为 336 字节 |
|
adcreative
|
struct[] | 创意信息所组成的对象 数组最小长度 1，最大长度 10 |
|
adcreative_template_id*
|
integer | 创意形式 id，具体请咨询您的运营接口人，也可通过 [创意规格查询工具] 进行查询 |
|
adcreative_elements
|
struct | 创意元素，不同 adcreative_template_id 要求的元素不尽相同，其中部分创意形式的文案元素支持换行能力，使用“\n ”表示换行，占 0.5 个等宽字符，建议行数不超过 6 行，具体情况可通过 [创意规格查询工具] 进行查询 |
|
deep_link_url
|
string | 应用直达页 URL，微信朋友圈广告（site_set=SITE_SET_MOMENTS）的创意形式，promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_ANDROID 时，需要同时填写 deeplink_ios_appid ； 或 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_IOS 时，需要同时填写 deeplink_anroid_appid，以确保双端都能支持应用直达。 字段长度最小 0 字节，长度最大 2048 字节 |
|
targeting
|
struct | 定向详细设置，存放所有定向条件 |
|
age
|
struct[] | 年龄定向（仅支持单年龄段，范围为 14~66，66 代表的是 66 岁及 66 岁以上，如 18~66 代表大于等于 18 岁） 数组最小长度 1，最大长度 5 |
|
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 } |
|
geo_location
|
struct | 地理位置定向， 针对朋友圈广告（campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS）地域必填，非朋友圈广告选填 如使用地域定向"regions"、"business_districts"、"custom_locations" 不能同时为空 |
|
location_types*
|
enum[] | 地点类型，[枚举详情]，选择限制： 数组最小长度 1，最大长度 5 枚举列表：{ RECENTLY_IN, VISITED_IN, LIVE_IN, TRAVEL_IN, LIVE_AND_RECENTLY, INTELLIGENCE } |
|
regions
|
integer[] | 省市区县列表，当投放微信流量（site_set=SITE_SET_WECHAT、SITE_SET_MOMENTS、SITE_SET_MINI_GAME_WECHAT）时，仅支持中国大陆（不包含港澳台）地域 id，可通过 [targeting_tags/get] 接口获取 数组最小长度 0，最大长度 1000 |
|
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, IOS_VERSION_15, IOS_VERSION_16, IOS_VERSION_17, 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, ANDROID_VERSION_11, ANDROID_VERSION_12, ANDROID_VERSION_13, ANDROID_VERSION_14, WINDOWS, MAC } |
|
device_price
|
enum[] | 设备价格定向，该功能即将下线，仅部分行业灰度开放，如有问题可联系您的客户运营，[枚举详情] 数组最小长度 1，最大长度 100 枚举列表：{ PRICE_1500_LESS, PRICE_1500_2500, PRICE_2500_3500, PRICE_3500_4500, PRICE_4500_MORE } |
|
network_type
|
enum[] | 联网方式定向，[枚举详情] 数组最小长度 1，最大长度 100 枚举列表：{ WIFI, NET_2G, NET_3G, NET_4G, NET_5G } |
|
network_operator
|
enum[] | 移动运营商定向，该功能即将下线，仅部分行业灰度开放，如有问题可联系您的客户运营，[枚举详情] 数组最小长度 1，最大长度 100 枚举列表：{ CMCC, CUC, CTC } |
|
app_install_status
|
enum[] | 应用安装（应用用户），当且仅当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION 时使用，[枚举详情] 数组长度为 1 枚举列表：{ NOT_INSTALLED, INSTALLED } |
|
mini_game_qq_status
|
enum[] | QQ 小游戏使用定向，[枚举详情]，当且仅当投放 QQ 小游戏推广目标（promoted_object_type= PROMOTED_OBJECT_TYPE_MINI_GAME_QQ）时可以使用 数组长度为 1 枚举列表：{ NOT_USED, USED } |
|
consumption_status
|
enum[] | 消费水平，[枚举详情]，该功能即将下线，仅部分行业灰度开放，如有问题可联系您的客户运营 数组最小长度 1，最大长度 100 枚举列表：{ HIGH, LOW } |
|
game_consumption_level
|
enum[] | 游戏消费能力，原 gamer_consumption_ability 定向升级版，gamer_consumption_ability 和 game_consumption_level 不能同时使用.，该功能即将下线，仅部分行业灰度开放，如有问题可联系您的客户运营，[枚举详情] 数组最小长度 1，最大长度 2 枚举列表：{ HIGH, NORMAL } |
|
paid_user
|
enum[] | 付费用户，[枚举详情] 数组最小长度 1，最大长度 100 枚举列表：{ APP_PAID, ECOMMERCE_PAID, LATENT_VIR_PAY } |
|
wechat_ad_behavior
|
struct | 微信广告行为定向，当且仅当投放微信广告时有效 |
|
actions
|
enum[] | 包含的行为列表，多个行为之间为并集（or）的关系，[枚举详情] 数组最小长度 0，最大长度 10 枚举列表：{ WECHAT_OFFICIAL_ACCOUNT_FOLLOWED, WECHAT_COUPON_OBTAINED, WECHAT_OFFICIAL_ACCOUNT_AD_LIKE, WECHAT_MOMENTS_AD_LIKE } |
|
excluded_actions
|
enum[] | 排除的行为列表，多个行为之间为并集（or）的关系，[枚举详情] 数组最小长度 0，最大长度 10 枚举列表：{ WECHAT_OFFICIAL_ACCOUNT_FOLLOWED, WECHAT_COUPON_OBTAINED, WECHAT_OFFICIAL_ACCOUNT_AD_LIKE, WECHAT_MOMENTS_AD_LIKE } |
|
custom_audience
|
integer[] | 定向用户群，通过 [人群管理模块] 创建的人群 id，custom_audience 和 excluded_custom_audience 个数之和不能超过 50 个 数组最小长度 1，最大长度 50 |
|
excluded_custom_audience
|
integer[] | 排除用户群，通过 [人群管理模块] 创建的人群 id，custom_audience 和 excluded_custom_audience 个数之和不能超过 50 个 数组最小长度 1，最大长度 50 |
|
behavior_or_interest
|
struct | 行为兴趣意向定向，2022 年 6 月 30 日起，该定向将无法在竞价 oCPC、oCPM 场景使用。 |
|
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 |
|
mobile_union_category
|
integer[] | 移动媒体类型定向，当且仅当投放移动联盟流量时（site_set = SITE_SET_MOBILE_UNION）时可以使用。（字段待废弃，2021 年 10 月 29 日后不支持新建和更新） 数组最小长度 1，最大长度 200 |
|
financial_situation
|
enum[] | 财产状态，该功能即将下线，仅部分行业灰度开放，如有问题可联系您的客户运营，[枚举详情] 数组最小长度 1，最大长度 2 枚举列表：{ CAR_OWNERS, HOME_OWNERS } |
|
campaign_spec
|
struct | 推广计划信息 |
|
campaign_id
|
int64 | 推广计划 id |
|
campaign_type
|
enum | 推广计划类型，[枚举详情] 枚举列表：{ CAMPAIGN_TYPE_NORMAL, CAMPAIGN_TYPE_WECHAT_MOMENTS, CAMPAIGN_TYPE_SEARCH, CAMPAIGN_TYPE_FREETRADE, CAMPAIGN_TYPE_CONTENT_PROMOTION } |
|
daily_budget
|
integer | 推广计划日预算，单位为分，微信朋友圈广告（campaign_type = CAMPAIGN_TYPE_WECHAT_MOMENTS）不可使用，其他广告可使用。 |
|
scene_spec
|
struct | 场景定向 |
|
display_scene
|
enum[] | 广告展示场景，当且仅当投放优量汇流量时可以使用，[枚举详情] 数组最小长度 0，最大长度 32 枚举列表：{ DISPLAY_SCENE_BANNER, DISPLAY_SCENE_INLINE, DISPLAY_SCENE_SPLASH, DISPLAY_SCENE_NATIVE, DISPLAY_SCENE_REWARDED_VIDEO } |
使用说明
- campaign_spec、adgroup、adcreative、targeting、scene_spec 不能同时为空，如 adgroup 结构同时传了 adgroup_id 和其余字段，则以其余字段信息为准； campaign_spec 结构的逻辑同 adgroup 结构。
请求示例
curl 'https://api.e.qq.com/v1.1/estimation/get?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'targeting={"gender":["MALE"],"age":[{"min":18,"max":30}],"geo_location":{"regions":[110000,310000],"location_types":["LIVE_IN"]}}' \
-d 'campaign_spec={
"campaign_id": "<CAMPAIGN_ID>"
}' \
-d 'scene_spec={
"display_scene": []
}'
应答字段
| 名称 | 类型 | 描述 |
|---|---|---|
|
max_active_user_count
|
integer | 预估最大覆盖用户数 |
|
approximate_count
|
integer | 预估日覆盖用户数最大值 |
|
impression
|
integer | 预估日曝光量最大值 |
|
min_bid_amount
|
integer | 出价下限，单位为分 |
|
max_bid_amount
|
integer | 出价上限，单位为分 |
|
suggest_min_bid_amount
|
integer | 建议最小出价，单位为分 |
|
suggest_max_bid_amount
|
integer | 建议最大出价，单位为分 |
|
suggest_bid_content_ocpa
|
string | oCPC/oCPM 广告返回建议内容 |
|
min_users_daily
|
integer | 预估日覆盖用户数下限 |
|
max_users_daily
|
integer | 预估日覆盖用户数上限 |
|
min_exposure_daily
|
integer | 预估日曝光量下限 |
|
max_exposure_daily
|
integer | 预估日曝光量上限 |
|
targeting_status
|
enum | 定向状态，[枚举详情] |
|
suggest_targeting
|
string[] | 建议调整的定向，字符数组 |
|
is_real_exposure_supported
|
boolean | 当前请求是否满足真实曝光量预估要求 |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"max_active_user_count": 10232887,
"approximate_count": 1023288,
"impression": 102311,
"min_bid_amount": 117,
"max_bid_amount": 199,
"suggest_targeting": []
}
}可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
