接口文档SDK业务专题开发者工具

预估覆盖人数
全部接口
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
integer 广告组 id
adgroup_name
string 广告组名称,同一帐号下的广告组名称不允许重复
字段长度最小 1 字节,长度最大 120 字节
automatic_site_enabled
boolean 是否开启自动版位功能(暂不包含 SITE_SET_WECHAT 和 SITE_SET_MOMENTS),此字段与 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 }
bid_amount
integer 广告出价,单位为分,出价限制:
  • CPC 出价限制:介于 10 分-10,000 分之间(0.1 元-100 元,单位为人民币)
  • CPM 出价限制:介于 150 分-99,900 之间(1.5 元-999 元,单位为人民币)
  • CPA 出价限制:介于 100 分-10,000 分之间(1 元-100 元,单位为人民币)
  • oCPC/oCPM 出价限制:介于 10 分-500,000 分之间(0.1 元-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_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 }
    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_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_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_PHONE_CALL, 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_LIKE }

    微信公众账号逻辑

    可投组合可通过 Capabilities/get 接口获取,创建后不支持修改
    promoted_object_id
    string 推广目标 id,详见 [查询推广目标 id]
    字段长度最小 0 字节,长度最大 128 字节
    time_series
    string 投放时间段,格式为 48 * 7 位字符串,且都为 0 和 1,以半个小时为最小粒度,从周一零点开始至周日 24 点结束。0 为不投放,1 为投放,全传 1 视为全时段投放,不允许全部传 0。朋友圈广告的投放时间小于等于 90 个自然日
    字段长度为 336 字节

    微信公众账号逻辑

    1.朋友圈投放时间小于等于 90 个自然日
    2.广告结束后不允许修改
    3.暂停后重启广告时:
    广告结束时间需大于当前时间+2 小时
    adcreative
    struct[] 创意信息所组成的对象
    数组最小长度 1,最大长度 10
    adcreative_template_id*
    integer 创意形式 id,具体请咨询您的运营接口人,也可通过 [创意规格查询工具] 进行查询
    adcreative_elements
    struct 创意元素,不同 adcreative_template_id 要求的元素不尽相同,其中部分创意形式的文案元素支持换行能力,使用“\n ”表示换行,占 0.5 个等宽字符,建议行数不超过 6 行,具体情况可通过 [创意规格查询工具] 进行查询
    deep_link_url
    string 应用直达页 URL,微信朋友圈卡片广告创意形式需要填写 deeplink_ios_appid 或 deeplink_anroid_appid 以支持双端都能应用直达,应用直达页 URL
    字段长度最小 0 字节,长度最大 2048 字节
    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 地理位置定向,
    针对朋友圈广告地域必填,非朋友圈广告选填
    如使用地域定向"regions"、"business_districts"、"custom_locations" 不能同时为空
    location_types*
    enum[] 地点类型,[枚举详情],选择限制:
  • 对于微信流量,仅能选择"LIVE_IN"(常住);
  • 使用商圈(business_district)以及自定义地理位置(custom_locations)时,仅可选 "VISITED_IN"(去过),"LIVE_IN"(常住);
  • 如:["LIVE_IN", "VISITED_IN"]

    数组最小长度 1,最大长度 4
    枚举列表:{ RECENTLY_IN, VISITED_IN, LIVE_IN, TRAVEL_IN }

    微信公众账号逻辑

    仅能选择"LIVE_IN"(常住)
    regions
    integer[] 省市区县列表,当投放微信流量时,仅支持中国大陆(不包含港澳台)地域 id,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400

    微信公众账号逻辑


    仅支持中国大陆(不包含港澳台)地域 id
    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, 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 }
    network_type
    enum[] 联网方式定向,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ WIFI, NET_2G, NET_3G, NET_4G }
    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
    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 }

    微信公众账号逻辑

    不支持。可使用再营销定向 wechat_ad_behavior
    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 }
    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
    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 行为兴趣意向定向
    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[] 行为兴趣意向定向的行为部分
    数组长度为 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
    air_quality_index
    enum[] 空气质量指数,[枚举详情]
    数组长度为 1
    枚举列表:{ GOOD, MODERATE, LIGHTLY_POLLUTED, MODERATELY_POLLUTED, HEAVILY_POLLUTED, SEVERELY_POLLUTED }

    微信公众账号逻辑

    不支持
    mobile_union_category
    integer[] 移动媒体类型定向,当且仅当投放移动联盟流量时(site_set = SITE_SET_MOBILE_UNION)时可以使用
    数组最小长度 1,最大长度 200

    微信公众账号逻辑

    不支持
    financial_situation
    enum[] 财产状态,[枚举详情]
    数组最小长度 1,最大长度 2
    枚举列表:{ CAR_OWNERS, HOME_OWNERS }

    微信公众账号逻辑

    不支持
    consumption_type
    enum[] 消费类型定向,[枚举详情]
    数组最小长度 1,最大长度 2
    枚举列表:{ PAID_GOODS_VIRTUAL, PAID_GOODS_REAL }

    微信公众账号逻辑

    支持,对应微信公众平台的“付费用户”定向:PAID_GOODS_VIRTUAL-游戏付费,PAID_GOODS_REAL-电商付费
    campaign_spec
    struct 推广计划信息
    campaign_id
    integer 推广计划 id
    campaign_type
    enum 推广计划类型,[枚举详情]
    枚举列表:{ CAMPAIGN_TYPE_NORMAL, CAMPAIGN_TYPE_WECHAT_MOMENTS }
    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 }

    微信公众账号逻辑

    不支持
    mobile_union
    enum[] 优量汇行业定投流量包,当且仅当投放优量汇流量时可以使用(待废弃,请使用优量汇行业精选流量包,但不能和 mobile_union_industry 同时使用时),[枚举详情]
    数组最小长度 1,最大长度 9
    枚举列表:{ MOBILE_UNION_IN_WECHAT, MOBILE_UNION_REWARDED_VIDEO, MOBILE_UNION_REWARDED_MEDIA, MOBILE_UNION_SMB_CUSTOMIZATION, MOBILE_UNION_GAME_ADVERTISER_PECULIAR, MOBILE_UNION_READ_ADVERTISER }

    微信公众账号逻辑

    不支持
    exclude_mobile_union
    enum[] 优量汇行业屏蔽流量包,当且仅当投放优量汇流量时可以使用(待废弃,请使用优量汇行业精选流量包,但不能和 mobile_union_industry 同时使用时),[枚举详情]
    数组最小长度 1,最大长度 8
    枚举列表:{ MOBILE_UNION_IN_WECHAT, MOBILE_UNION_REWARDED_VIDEO, MOBILE_UNION_REWARDED_MEDIA, MOBILE_UNION_GAME_ADVERTISER_EXCLUDE, MOBILE_UNION_LIGHT_GAME_ADVERTISER_EXCLUDE, MOBILE_UNION_READ_ADVERTISER_EXCLUDE }

    微信公众账号逻辑

    不支持
    mobile_union_industry
    enum[] 优量汇行业精选流量包,当且仅当投放优量汇流量时可以使用,[枚举详情]
    数组最小长度 1,最大长度 8
    枚举列表:{ MOBILE_UNION_GAME_ADVERTISER, MOBILE_UNION_LIGHT_GAME_ADVERTISER, MOBILE_UNION_READ_ADVERTISER, MOBILE_UNION_EDUCATION_ADVERTISER, MOBILE_UNION_LONGTAIL_ADVERTISER, MOBILE_UNION_FINANCE_ADVERTISER, MOBILE_UNION_TOURISM_ADVERTISER, MOBILE_UNION_EC_ADVERTISER }

    微信公众账号逻辑

    不支持

    使用说明

    1. 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>&timestamp=<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": [],
        "mobile_union": [],
        "exclude_mobile_union": [],
        "mobile_union_industry": []
    }' 
    					

    应答字段

    名称 类型 描述
    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": []
        }
    }

    可视化调试工具