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

广告组 (Adgroup)

V1.1

loading


本节将为您介绍广告组 (Adgroup) 相关接口。广告组是推广流程中最核心的单元,包含投放时间、具体推广标的物、投放站点、出价等信息。关于广告组更详细的介绍可以参考【广告组】章节。


创建广告组
全部接口
V1.1
loading

所属权限 Ads Management
请求地址 adgroups/add
请求方法 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
campaign_id*
integer 推广计划 id
adgroup_name*
string 广告组名称,同一帐号下的广告组名称不允许重复。字段长度最小 1 个等宽字符,长度最大 60 等宽字符(即字段最大长度为 60 个中文字或全角标点,120 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。)
字段长度最小 1 字节,长度最大 180 字节
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, PROMOTED_OBJECT_TYPE_MINI_GAME_QQ }

微信公众账号逻辑

支持创建的推广目标类型:
PROMOTED_OBJECT_TYPE_APP_ANDROID:Android 应用
PROMOTED_OBJECT_TYPE_APP_IOS:IOS 应用
PROMOTED_OBJECT_TYPE_ECOMMERCE:电商推广
PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT:微信小游戏推广目标
PROMOTED_OBJECT_TYPE_LINK_WECHAT:微信品牌页
PROMOTED_OBJECT_TYPE_LEAD_AD:销售线索
begin_date*
string 开始投放日期,日期格式:YYYY-MM-DD,且日期小于等于 end_date
字段长度为 10 字节
end_date*
string 结束投放日期,日期格式:YYYY-MM-DD,大于等于今天,且大于等于 begin_date ;如果希望长期投放,传空字符串
字段长度最小 0 字节,长度最大 10 字节
billing_event
enum 计费类型,[枚举详情]
枚举列表:{ BILLINGEVENT_CLICK, BILLINGEVENT_APP_DOWNLOAD, BILLINGEVENT_IMPRESSION }
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 元,单位为人民币)
  • optimization_goal
    enum 广告优化目标类型。目前 OPTIMIZATIONGOAL_LEADS_COLLECT、OPTIMIZATIONGOAL_APPLY、OPTIMIZATIONGOAL_PRE_CREDIT、OPTIMIZATIONGOAL_CREDIT、OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS、OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD 等六个目标灰度开放中,[枚举详情]
    枚举列表:{ 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 }

    微信公众账号逻辑

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

    微信公众账号逻辑

    1.朋友圈投放时间小于等于 90 个自然日
    2.广告结束后不允许修改
    3.暂停后重启广告时:
    广告结束时间需大于当前时间+2 小时
    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+SITE_SET_MOBILE_UNION+SITE_SET_MOBILE_INNER+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合,[枚举详情]
    数组最小长度 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_WECHAT, SITE_SET_MINI_GAME_WECHAT
    daily_budget
    integer 广告组日预算,单位为分,设置为 0 表示不设预算(即不限),

    日预算要求介于 5,000 分– 4,000,000,000 分之间(50 元-40,000,000 元,单位为人民币)


    对于微信朋友圈广告(campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS):

  • 下调日预算不能低于该广告组今日已消耗金额的 1.5 倍
  • 每次修改幅度不能低于当前日预算加上 5000 分(50 元,单位为人民币)

  • 对于非微信朋友圈广告(campaign_type!=CAMPAIGN_TYPE_WECHAT_MOMENTS):

  • 修改后的日预算不能低于该广告组今日已消耗金额加上 5,000 分(50 元,单位为人民币)
  • 每次修改幅度不能低于当前日预算加上 5,000 分(50 元,单位为人民币)
  • 微信公众账号逻辑

  • 每次修改幅度不能低于当前日预算加上 50000 分(500 元,单位为人民币)
  • promoted_object_id
    string 推广目标 id,详见 [查询推广目标 id]
    字段长度最小 0 字节,长度最大 128 字节
    app_android_channel_package_id
    string 安卓应用渠道包 id,在投放推广目标类型为 Android 应用的情况下,可以填写腾讯开放平台安卓应用和腾讯广告渠道包的渠道包 id。渠道包 id 可以从推广目标模块的读取接口获取,渠道包 id 字段由"xx;yy" 两部分组成,在写入时 xx 会被置为 0,0 为正常。
    字段长度最小 1 字节,长度最大 128 字节

    微信公众账号逻辑

    1.同一个 campaign 下推广的渠道包信息必须是同一个
    2.渠道包信息不支持修改
    targeting_id
    integer 定向包 id,与 targeting 不能同时填写且不能同时为空,(当 campaign_type=CAMPAIGN_TYPE_NORMAL 时可以使用定向包能力)

    微信公众账号逻辑

    不支持使用定向包
    targeting
    struct 定向详细设置,存放所有定向条件。与 targeting_id 不能同时填写且不能同时为空,(当 campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS 时必填)
    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[] 省市区县列表,可通过 [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 }
    device_brand_model
    struct 设备品牌型号定向
    included_list
    integer[] 设备品牌型号定向,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    最小值 0,最大值 10000000000
    excluded_list
    integer[] 排除设备品牌型号列表,不能与 included_list 同时使用,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    最小值 0,最大值 10000000000
    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
    air_quality_index
    enum[] 空气质量指数,[枚举详情]
    数组长度为 1
    枚举列表:{ GOOD, MODERATE, LIGHTLY_POLLUTED, MODERATELY_POLLUTED, HEAVILY_POLLUTED, SEVERELY_POLLUTED }

    微信公众账号逻辑

    不支持
    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
    consumption_status
    enum[] 消费水平,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ HIGH, LOW }

    微信公众账号逻辑

    不支持
    gamer_consumption_ability
    struct[] 游戏用户消费能力(仅支持单价格段,单位是“元/月”),定向待废弃,请使用新的游戏消费能力定向(game_consumption_level)进行接入,gamer_consumption_ability 和 game_consumption_level 不能同时使用
    数组长度为 1
    min*
    integer 游戏用户消费能力最小值限制,可填写的值为 1,10,20,30,40,50,60,70,80,90,100,200,300,400,500
    最小值 1,最大值 500
    max*
    integer 游戏用户消费能力最大值限制,可填写的值为 10,20,30,40,50,60,70,80,90,100,200,300,400,500,999999999,最大值 999999999 代表 500 以上
    最小值 10,最大值 999999999
    game_consumption_level
    enum[] 游戏消费能力,原 gamer_consumption_ability 定向升级版,gamer_consumption_ability 和 game_consumption_level 不能同时使用,该定向灰度中,[枚举详情]
    数组最小长度 1,最大长度 2
    枚举列表:{ HIGH, NORMAL }
    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
    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-电商付费
    wechat_ad_behavior
    struct 微信再营销,原微信广告行为定向升级为微信再营销,当且仅当投放微信广告时有效
    actions
    enum[] 包含的行为列表,多个行为之间为并集(or)的关系
    数组最小长度 0,最大长度 10
    QQ 账号支持枚举列表:{WECHAT_OFFICIAL_ACCOUNT_AD_LIKE,WECHAT_MOMENTS_AD_LIKE,MINI_GAME_WECHAT_REGISTERED },[枚举详情]

    微信公众账号逻辑

    WECHAT_OFFICIAL_ACCOUNT_FOLLOWED,关注过广告主微信公众号
    APP_INSTALLED,已安装你的应用(推广目标仅支持 ANDROID、IOS)
    WECHAT_COUPON_OBTAINED,领取过广告主微信卡券
    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 },[枚举详情]

    微信公众账号逻辑

    WECHAT_OFFICIAL_ACCOUNT_FOLLOWED,关注过广告主微信公众号
    APP_INSTALLED,已安装你的应用(推广目标仅支持 ANDROID、IOS)
    WECHAT_COUPON_OBTAINED,领取过广告主微信卡券
    WECHAT_OFFICIAL_ACCOUNT_AD_LIKE,对微信公众号广告感兴趣
    WECHAT_MOMENTS_AD_LIKE,对微信朋友圈广告感兴趣
    MINI_GAME_WECHAT_REGISTERED,曾经注册过你的小游戏(仅推广目标为微信小游戏)
    custom_audience
    integer[] 自定义定向用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    数组最小长度 1,最大长度 200
    excluded_custom_audience
    integer[] 自定义排除用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    数组最小长度 1,最大长度 200
    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
    wechat_official_account_category
    integer[] 微信流量类型定向,当且仅当投放微信站点(SITE_SET_WECHAT)且非朋友圈广告(campaign_type != CAMPAIGN_TYPE_WECHAT_MOMENTS)时可以使用,通过[targeting_tags/get]可获取微信流量类型
    数组最小长度 1,最大长度 50
    mobile_union_category
    integer[] 移动媒体类型定向,当且仅当投放移动联盟流量时(site_set = SITE_SET_MOBILE_UNION)时可以使用
    数组最小长度 1,最大长度 200

    微信公众账号逻辑

    不支持
    mini_game_qq_status
    enum[] QQ 小游戏使用定向,[枚举详情],当且仅当投放 QQ 小游戏推广目标(promoted_object_type= PROMOTED_OBJECT_TYPE_MINI_GAME_QQ)时可以使用
    数组长度为 1
    枚举列表:{ NOT_USED, USED }

    微信公众账号逻辑

    不支持
    excluded_converted_audience
    struct 排除已转化用户定向,(该定向灰度开放中)

    微信公众账号逻辑

    不支持微信账号
    excluded_dimension*
    enum 排除已转化用户定向范围
    同应用,仅当推广目标为应用下载时可以使用,没有选择自定义转化行为(excluded_dimension)时,使用该定向出价需要满足是 oCPC、oCPM 广告;
    同商品,仅当 SDPA 商品广告下使用,不支持自定义转化行为默认排除已下单、和已付费用户,不限制出价方式;
    非同应用、非同商品,没有选择自定义转化行为(excluded_dimension)时,使用该定向出价需要满足是 oCPC、oCPM 广告;,[枚举详情]
    枚举列表:{ EXCLUDED_DIMENSION_CAMPAIGN, EXCLUDED_DIMENSION_UID, EXCLUDED_DIMENSION_BUSINESS_MANAGER, EXCLUDED_DIMENSION_COMPANY_ACCOUNT, EXCLUDED_DIMENSION_APP, EXCLUDED_DIMENSION_PRODUCT }
    conversion_behavior_list
    enum[] 自定义转化行为,没有选择自定义转化行为(excluded_dimension)时,使用该定向需要校验是 oCPC、oCPM 广告,默认取出价转化目标值。当选择了自定义转化行为时,不需要校验 oCPC、oCPM 广告。,[枚举详情]
    数组长度为 1
    枚举列表:{ OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_FIRST_PURCHASE }
    scene_spec
    struct 场景定向
    mobile_union
    enum[] 优量汇行业定投流量包,当且仅当投放优量汇流量时可以使用(待废弃,请使用优量汇行业精选流量包,但不能和 mobile_union_industry 同时使用时),[枚举详情]
    数组最小长度 1,最大长度 9
    枚举列表:{ MOBILE_UNION_IN_WECHAT, 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_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 }
    union_position_package
    integer[] 定投优量汇流量包列表,一个广告最多可选择 20 个定投流量包,且该广告所有流量包关联的广告位数量不得超过 500 个
    数组最小长度 1,最大长度 20
    exclude_union_position_package
    integer[] 屏蔽优量汇流量包列表,一个广告最多可选择 20 个屏蔽流量包,且该广告所有流量包关联的广告位数量不得超过 500 个
    数组最小长度 1,最大长度 20
    tencent_news
    enum[] 腾讯新闻流量场景定向,当且仅当投放腾讯新闻流量时可以使用,功能灰度开放,[枚举详情]
    数组最小长度 1,最大长度 3
    枚举列表:{ TENCENT_NEWS_APP, TENCENT_NEWS_WECHAT, TENCENT_NEWS_QQ }
    display_scene
    enum[] 广告展示场景,当且仅当投放优量汇流量时可以使用,[枚举详情]
    数组最小长度 0,最大长度 32
    枚举列表:{ DISPLAY_SCENE_BANNER, DISPLAY_SCENE_INLINE, DISPLAY_SCENE_SPLASH, DISPLAY_SCENE_NATIVE, DISPLAY_SCENE_REWARDED_VIDEO }
    configured_status
    enum 客户设置的状态,[枚举详情]
    枚举列表:{ AD_STATUS_NORMAL, AD_STATUS_SUSPEND }

    微信公众账号逻辑

    1.该字段默认值为 AD_STATUS_NORMAL
    2.当且仅当该 adgroup 下拥有一个审核通过的广告且在线(已达设置的上线时段),才允许暂停
    customized_category
    string 自定义分类,关键词用半角逗号','分隔,如:本地生活,餐饮
    字段长度最小 0 字节,长度最大 200 字节

    微信公众账号逻辑

    不支持上传用户自定义类目
    dynamic_ad_spec
    struct 动态商品广告属性,当广告形态为动态商品广告时,该字段必填

    微信公众账号逻辑

    sdpa 功能在 adgroup 上设置商品库信息
    product_mode 仅支持 single
    product_catalog_id*
    integer 商品库 id
    product_mode*
    enum 动态商品广告类型,目前只支持单商品动态商品广告,多商品动态商品广告敬请期待,[枚举详情]
    枚举列表:{ SINGLE }
    user_action_sets
    struct[] 用户行为数据源,详见 [转化归因功能],当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_ECOMMERCE、PROMOTED_OBJECT_TYPE_LINK 时,允许传入 WEB + iOS + Android 最多 3 个数据源;当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_ANDROID 时,只允许传入 1 个 Android 数据源;当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_IOS 时,只允许传入 1 个 iOS 数据源
    数组最小长度 1,最大长度 3

    微信公众账号逻辑

    不支持设置,设置该信息会报错
    type*
    enum 数据源类型,[枚举详情]
    枚举列表:{ USER_ACTION_SET_TYPE_WEB, USER_ACTION_SET_TYPE_IOS, USER_ACTION_SET_TYPE_ANDROID }

    微信公众账号逻辑

    不支持设置,设置该信息会报错
    id*
    integer 数据源 id,通过 user_action_sets 模块创建和获取,数据源 id 对应的类型要与 user_action_sets 中指定的 type 一致
    additional_user_action_sets
    struct[] 补充的 app 用户行为数据源,灰度开放中。
    当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_ECOMMERCE、PROMOTED_OBJECT_TYPE_LINK、PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM,且行业为网服、电商、金融的广告主,可填写补充的 app 用户行为数据源。数据源需为安卓/ios 数据源,且需确保为同一个 app 的数据源。
    数组最小长度 0,最大长度 100
    type*
    enum 数据源类型,[枚举详情]
    枚举列表:{ USER_ACTION_SET_TYPE_WEB, USER_ACTION_SET_TYPE_IOS, USER_ACTION_SET_TYPE_ANDROID }
    id*
    integer 数据源 id,通过 user_action_sets 模块创建和获取,数据源 id 对应的类型要与 user_action_sets 中指定的 type 一致
    dynamic_creative_id
    integer DC 动态创意 id

    微信公众账号逻辑

    不支持该能力,设置该信息会报错
    is_rewarded_video_ad
    boolean 是否是激励视频广告
    可选值:{ true, false }

    微信公众账号逻辑

    不需要设置,设置会被忽略
    bid_strategy
    enum 出价策略,仅 oCPC/oCPM 广告可设置,且为必填,枚举列表:[枚举详情]
    枚举列表:{ BID_STRATEGY_AVERAGE_COST, BID_STRATEGY_TARGET_COST, BID_STRATEGY_PRIORITY_LOW_COST }
    cold_start_audience
    integer[] 扩量种子人群(原冷启动人群名称升级扩量种子人群)
    1、系统会学习您选择的人群包数据,帮助提升广告投放效果;
    2、当且仅当广告为 oCPC/oCPM 开启自动扩量的广告、且投放的流量不是应用宝时;
    3、仅支持人群类型为 CUSTOMER_FILE(号码文件人群)的可用人群 id、且人群数量大于 100 时;
    数组最大长度 10
    auto_audience
    boolean 是否使用系统优选,限制:
  • 系统优选不支持朋友圈广告使用;
  • 当 auto_audience=true 时系统自动选择匹配行为兴趣定向;
  • 系统优选(auto_audience)和行为兴趣定向(behavior_or_interest)不能同时填写,即行为兴趣和系统优选功能二选一;
  • 系统优选(auto_audience)和自动扩量(expand_enabled)功能、定向包 id(targeting_id)、自定义人群(custom_audience)功能互斥;

  • 可选值:{ true, false }

    微信公众账号逻辑

    不支持
    expand_enabled
    boolean 是否使用自动扩量,当广告为 oCPC/oCPM、CPC 出价时,可将 expand_enabled 设置为 true,微信广告当且仅当出价为 oCPC/oCPM 时,才可将 expand_enabled 设置为 true。,expand_enabled 设置为 true, 开启自动扩量
    可选值:{ true, false }

    微信公众账号逻辑

    当且仅当广告出价类型为 oCPC/oCPM 出价时,可以设置
    expand_targeting
    string[] 扩量不可突破定向,如果使用 oCPC/oCPM,会在 oCPC/oCPM 扩量定向的范围内寻找相似人群,原 targeting 接口传入的定向将失效。当且仅当 expand_enabled 设置为 true 时,expand_targeting 才可填写,且为必填。
    目前仅支持年龄、性别、地域、学历(不可突破学历仅教育行业可使用)定向设置为不可突破(前置需要定向 targeting 层级使用了年龄、性别、地域、学历时 不可突破才可以选择相对应的值)。
    数组最小长度 0,最大长度 4
    可选值:{ age, gender, geo_location, education }

    微信公众账号逻辑

    当且仅当广告出价类型为 oCPC/oCPM 出价时,可以设置,设置内容为不可突破定向范围
    deep_conversion_spec
    struct oCPC/oCPM 深度优化内容,创建时若此字段不传,或传空则视为无限制条件;更新时,若要关闭,则需要传空
    deep_conversion_type
    enum oCPC/oCPM 深度优化价值配置,[枚举详情]
    枚举列表:{ DEEP_CONVERSION_WORTH, DEEP_CONVERSION_BEHAVIOR }
    deep_conversion_behavior_spec
    struct oCPC/oCPM 优化转化行为配置
    goal*
    enum 优化转化行为目标,不可更改,如修改目标价格,需在结构体中传入已设置的优化转化行为目标。,枚举列表:[枚举详情]
    枚举列表:{ OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_LEADS_COLLECT }
    bid_amount*
    integer 深度优化行为的出价,深度优化行为出价,单位为分
    最小值 10,最大值 500000
    deep_conversion_worth_spec
    struct oCPC/oCPM 优化 ROI 配置
    goal*
    enum 优化 ROI 目标,不可更改,如修改深度优化效果值,需在结构体中传入已设置的优化 ROI 目标,枚举列表:[枚举详情]
    枚举列表:{ GOAL_30DAY_ORDER_ROAS, GOAL_1DAY_PURCHASE_ROAS, GOAL_1DAY_MONETIZATION_ROAS }
    expected_roi*
    float 深度优化价值效果值
    最小值 0.01,最大值 1000,最多保留 2 位小数
    deep_optimization_action_type
    enum oCPC/oCPM 深度优化方式配置 当深度优化类型=优化深度转化行为时,此前支持选择“优化方式”;目前深度优化能力升级,两阶段/双目标优化方式已进行合并,因此优化方式字段即将下线,可以不再输入。如调用该字段,系统会默认按两阶段优化方式进行创建,了解更多
    枚举列表:{ DEEP_OPTIMIZATION_ACTION_TYPE_DOUBLE_GOAL_BID, DEEP_OPTIMIZATION_ACTION_TYPE_TWO_STAGE_BID }
    conversion_id
    integer 转化 id,包含优化目标,深度优化目标,数据上报方式,归因方式等信息,仅 ocpc/ocpm 广告可设置,转化 id 设置后不可修改。可通过辅助工具[转化查询接口]查询可使用的转化 id。当传入转化 id 时,可无需再传入 user_action_sets,additional_user_action_sets,optimization_goal,deep_conversion_spec 字段信息。如若同时传入转化 id 和 user_action_sets/additional_user_action_sets,将以转化 id 的信息为第一优先级;如若同时传入转化 id 和 optimization_goal/deep_conversion_spec,仅当转化 id 中包含的优化目标/深度优化目标与传入的优化目标/深度优化目标信息一致时,才允许创建,否则将不允许创建。功能灰度开放中。

    微信公众账号逻辑

    不支持微信账号。
    deep_conversion_behavior_bid
    integer 深度优化行为的出价,使用转化 id 确认优化目标和深度优化目标的广告主,深度优化行为的目标出价无需传 deep_conversion_spec 结构体中字段,可直接使用 deep_conversion_behavior_bid 字段传输深度出价,单位为分。
    最小值 10,最大值 500000

    微信公众账号逻辑

    不支持微信账号
    deep_conversion_worth_rate
    float 深度优化价值的期望 ROI,使用转化 id 确认优化目标和深度优化目标的广告主,深度优化价值的目标出价无需传 deep_conversion_spec 结构体中字段,可直接使用 deep_conversion_worth_rate 字段传输深度出价。
    最小值 0.01,最大值 1000,最多保留 2 位小数

    微信公众账号逻辑

    不支持微信账号
    bid_mode
    enum 出价方式,
    1. bid_mode 为 billing_event 升级字段,不可同时输入,升级后直接写入 bid_mode 字段即可;
    2. 当投放智能出价广告,可写入 BID_MODE_OCPC/BID_MODE_OCPM。此时,optimization_goal 优化目标字段必填;
    3. 当投放非智能出价广告,可写入 BID_MODE_CPC/BID_MODE_CPM/BID_MODE_CPA。此时,optimization_goal 优化目标字段不可填;
    4. 针对非微信流量,BID_MODE_CPC 可编辑修改为 BID_MODE_OCPC,BID_MODE_CPM 可编辑修改为 BID_MODE_OCPM,其他修改不可操作。针对微信流量,bid_mode 字段不可修改,[枚举详情]
    枚举列表:{ BID_MODE_CPC, BID_MODE_CPA, BID_MODE_CPM, BID_MODE_OCPC, BID_MODE_OCPM }

    微信公众账号逻辑

    暂不支持微信账号

    使用说明

    1. targeting 和 targeting_id 不能同时填写且不能同时为空,朋友圈广告只允许使用 targeting。
    2. 朋友圈广告的投放时间需大于等于 6 小时,小于等于 60 个自然日,且每天至少投放 6 小时,且每天投放的时段需保持一致。
    3. 针对朋友圈广告(campaign_type = CAMPAIGN_TYPE_WECHAT_MOMENTS),仅支持以下定向:地域(geo_location)、年龄(age)、性别(gender)、学历(education)、婚恋育儿状态(marital_status)、应用安装(app_install_status)、自定义人群(custom_audience)、排除自定义人群(excluded_custom_audience)、操作系统(user_os)、联网方式(network_type)、移动运营商(network_operator)、设备价格(device_price)、再营销(原微信广告行为定向 wechat_ad_behavior)、行为兴趣意向定向(behavior_or_interest)、设备品牌型号定向(device_brand_model)、游戏付费能力(game_consumption_level)。
    4. 地理位置定向的省市区县以及商圈 id、行为兴趣意向定向、微信公众号类型定向、移动媒体类型定向的可选值列表可通过 targeting_tags/get 接口进行获取。
    5. DPA 广告功能灰度开放,如有接入需求,请联系对接渠道运营同事线下进行申请。
    6. 非微信朋友圈广告的日预算(daily_budget)设置仅灰度开放,如有接入需求,请联系对接渠道运营同事线下进行申请。

    请求示例

    
    curl 'https://api.e.qq.com/v1.1/adgroups/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -d 'account_id=<ACCOUNT_ID>' \
    -d 'campaign_id=<CAMPAIGN_ID>' \
    -d 'adgroup_name=推广广告' \
    -d 'promoted_object_type=PROMOTED_OBJECT_TYPE_LINK' \
    -d 'begin_date=2017-04-25' \
    -d 'end_date=2017-05-01' \
    -d 'billing_event=BILLINGEVENT_CLICK' \
    -d 'bid_amount=200' \
    -d 'optimization_goal=OPTIMIZATIONGOAL_CLICK' \
    -d 'time_series=010100100110100010101010010101010101010100101010101010010101010101001010101010100101010101010111110010101001010110110100110001011001010100101010101010110011001010101010100101100101101110101010101010100110100110010100110101110111101110110110110110110110101101101101110110011101011101101011101101101101001010110111010111011010110110111011' \
    -d 'site_set=["SITE_SET_QZONE"]' \
    -d 'daily_budget=10000' \
    -d 'targeting_id=<TARGETING_ID>' \
    -d 'scene_spec={"mobile_union":["MOBILE_UNION_IN_WECHAT"]}' \
    -d 'configured_status=AD_STATUS_NORMAL' \
    -d 'customized_category=本地生活,餐饮' \
    -d 'user_action_sets=[]' \
    -d 'additional_user_action_sets=[]' \
    -d 'cold_start_audience=[1024]' \
    -d 'expand_enabled=false' \
    -d 'expand_targeting=[]' \
    -d 'deep_conversion_spec={"deep_conversion_type":"DEEP_CONVERSION_BEHAVIOR","deep_conversion_behavior_spec":{"bid_amount":200}}' 
    					

    应答字段

    名称 类型 描述
    adgroup_id
    integer 广告组 id

    应答示例

    {
        "code": 0,
        "message": "",
        "message_cn": "",
        "data": {
            "adgroup_id": "<ADGROUP_ID>"
        }
    }

    可视化调试工具

    相关阅读


    更新广告组
    全部接口
    V1.1
    loading

    所属权限 Ads Management
    请求地址 adgroups/update
    请求方法 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_id*
    integer 广告组 id
    adgroup_name
    string 广告组名称,同一帐号下的广告组名称不允许重复。字段长度最小 1 个等宽字符,长度最大 60 等宽字符(即字段最大长度为 60 个中文字或全角标点,120 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。)
    字段长度最小 1 字节,长度最大 180 字节
    begin_date
    string 开始投放日期,日期格式:YYYY-MM-DD,且日期小于等于 end_date
    字段长度为 10 字节
    end_date
    string 结束投放日期,日期格式:YYYY-MM-DD,大于等于今天,且大于等于 begin_date ;如果希望长期投放,传空字符串
    字段长度最小 0 字节,长度最大 10 字节
    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 元,单位为人民币)
  • conversion_id
    integer 转化 id,包含优化目标,深度优化目标,数据上报方式,归因方式等信息,仅 ocpc/ocpm 广告可设置,转化 id 设置后不可修改。可通过辅助工具[转化查询接口]查询可使用的转化 id。当传入转化 id 时,可无需再传入 user_action_sets,additional_user_action_sets,optimization_goal,deep_conversion_spec 字段信息。如若同时传入转化 id 和 user_action_sets/additional_user_action_sets,将以转化 id 的信息为第一优先级;如若同时传入转化 id 和 optimization_goal/deep_conversion_spec,仅当转化 id 中包含的优化目标/深度优化目标与传入的优化目标/深度优化目标信息一致时,才允许创建,否则将不允许创建。功能灰度开放中。

    微信公众账号逻辑

    不支持微信账号。
    optimization_goal
    enum 广告优化目标类型。目前 OPTIMIZATIONGOAL_LEADS_COLLECT、OPTIMIZATIONGOAL_APPLY、OPTIMIZATIONGOAL_PRE_CREDIT、OPTIMIZATIONGOAL_CREDIT、OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS、OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD 等六个目标灰度开放中,[枚举详情]
    枚举列表:{ 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 }

    微信公众账号逻辑

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

    微信公众账号逻辑

    1.朋友圈投放时间小于等于 90 个自然日
    2.广告结束后不允许修改
    3.暂停后重启广告时:
    广告结束时间需大于当前时间+2 小时
    daily_budget
    integer 广告组日预算,单位为分,设置为 0 表示不设预算(即不限),

    日预算要求介于 5,000 分– 4,000,000,000 分之间(50 元-40,000,000 元,单位为人民币)


    对于微信朋友圈广告(campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS):

  • 下调日预算不能低于该广告组今日已消耗金额的 1.5 倍
  • 每次修改幅度不能低于当前日预算加上 5000 分(50 元,单位为人民币)

  • 对于非微信朋友圈广告(campaign_type!=CAMPAIGN_TYPE_WECHAT_MOMENTS):

  • 修改后的日预算不能低于该广告组今日已消耗金额加上 5,000 分(50 元,单位为人民币)
  • 每次修改幅度不能低于当前日预算加上 5,000 分(50 元,单位为人民币)
  • 微信公众账号逻辑

  • 每次修改幅度不能低于当前日预算加上 50000 分(500 元,单位为人民币)
  • app_android_channel_package_id
    string 安卓应用渠道包 id,在投放推广目标类型为 Android 应用的情况下,可以填写腾讯开放平台安卓应用和腾讯广告渠道包的渠道包 id。渠道包 id 可以从推广目标模块的读取接口获取,渠道包 id 字段由"xx;yy" 两部分组成,在写入时 xx 会被置为 0,0 为正常。
    字段长度最小 0 字节,长度最大 128 字节

    微信公众账号逻辑

    1.同一个 campaign 下推广的渠道包信息必须是同一个
    2.渠道包信息不支持修改
    targeting_id
    integer 定向包 id,与 targeting 不能同时填写且不能同时为空,(当 campaign_type=CAMPAIGN_TYPE_NORMAL 时可以使用定向包能力)

    微信公众账号逻辑

    不支持使用定向包
    targeting
    struct 定向详细设置,存放所有定向条件。与 targeting_id 不能同时填写且不能同时为空,(当 campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS 时必填)
    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[] 省市区县列表,可通过 [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 }
    device_brand_model
    struct 设备品牌型号定向
    included_list
    integer[] 设备品牌型号定向,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    最小值 0,最大值 10000000000
    excluded_list
    integer[] 排除设备品牌型号列表,不能与 included_list 同时使用,可通过 [targeting_tags/get] 接口获取
    数组最小长度 0,最大长度 400
    最小值 0,最大值 10000000000
    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
    air_quality_index
    enum[] 空气质量指数,[枚举详情]
    数组长度为 1
    枚举列表:{ GOOD, MODERATE, LIGHTLY_POLLUTED, MODERATELY_POLLUTED, HEAVILY_POLLUTED, SEVERELY_POLLUTED }

    微信公众账号逻辑

    不支持
    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
    consumption_status
    enum[] 消费水平,[枚举详情]
    数组最小长度 1,最大长度 100
    枚举列表:{ HIGH, LOW }

    微信公众账号逻辑

    不支持
    gamer_consumption_ability
    struct[] 游戏用户消费能力(仅支持单价格段,单位是“元/月”),定向待废弃,请使用新的游戏消费能力定向(game_consumption_level)进行接入,gamer_consumption_ability 和 game_consumption_level 不能同时使用
    数组长度为 1
    min*
    integer 游戏用户消费能力最小值限制,可填写的值为 1,10,20,30,40,50,60,70,80,90,100,200,300,400,500
    最小值 1,最大值 500
    max*
    integer 游戏用户消费能力最大值限制,可填写的值为 10,20,30,40,50,60,70,80,90,100,200,300,400,500,999999999,最大值 999999999 代表 500 以上
    最小值 10,最大值 999999999
    game_consumption_level
    enum[] 游戏消费能力,原 gamer_consumption_ability 定向升级版,gamer_consumption_ability 和 game_consumption_level 不能同时使用,该定向灰度中,[枚举详情]
    数组最小长度 1,最大长度 2
    枚举列表:{ HIGH, NORMAL }
    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
    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-电商付费
    wechat_ad_behavior
    struct 微信再营销,原微信广告行为定向升级为微信再营销,当且仅当投放微信广告时有效
    actions
    enum[] 包含的行为列表,多个行为之间为并集(or)的关系
    数组最小长度 0,最大长度 10
    QQ 账号支持枚举列表:{WECHAT_OFFICIAL_ACCOUNT_AD_LIKE,WECHAT_MOMENTS_AD_LIKE,MINI_GAME_WECHAT_REGISTERED },[枚举详情]

    微信公众账号逻辑

    WECHAT_OFFICIAL_ACCOUNT_FOLLOWED,关注过广告主微信公众号
    APP_INSTALLED,已安装你的应用(推广目标仅支持 ANDROID、IOS)
    WECHAT_COUPON_OBTAINED,领取过广告主微信卡券
    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 },[枚举详情]

    微信公众账号逻辑

    WECHAT_OFFICIAL_ACCOUNT_FOLLOWED,关注过广告主微信公众号
    APP_INSTALLED,已安装你的应用(推广目标仅支持 ANDROID、IOS)
    WECHAT_COUPON_OBTAINED,领取过广告主微信卡券
    WECHAT_OFFICIAL_ACCOUNT_AD_LIKE,对微信公众号广告感兴趣
    WECHAT_MOMENTS_AD_LIKE,对微信朋友圈广告感兴趣
    MINI_GAME_WECHAT_REGISTERED,曾经注册过你的小游戏(仅推广目标为微信小游戏)
    custom_audience
    integer[] 自定义定向用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    数组最小长度 1,最大长度 200
    excluded_custom_audience
    integer[] 自定义排除用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    数组最小长度 1,最大长度 200
    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
    wechat_official_account_category
    integer[] 微信流量类型定向,当且仅当投放微信站点(SITE_SET_WECHAT)且非朋友圈广告(campaign_type != CAMPAIGN_TYPE_WECHAT_MOMENTS)时可以使用,通过[targeting_tags/get]可获取微信流量类型
    数组最小长度 1,最大长度 50
    mobile_union_category
    integer[] 移动媒体类型定向,当且仅当投放移动联盟流量时(site_set = SITE_SET_MOBILE_UNION)时可以使用
    数组最小长度 1,最大长度 200

    微信公众账号逻辑

    不支持
    mini_game_qq_status
    enum[] QQ 小游戏使用定向,[枚举详情],当且仅当投放 QQ 小游戏推广目标(promoted_object_type= PROMOTED_OBJECT_TYPE_MINI_GAME_QQ)时可以使用
    数组长度为 1
    枚举列表:{ NOT_USED, USED }

    微信公众账号逻辑

    不支持
    excluded_converted_audience
    struct 排除已转化用户定向,(该定向灰度开放中)

    微信公众账号逻辑

    不支持微信账号
    excluded_dimension*
    enum 排除已转化用户定向范围
    同应用,仅当推广目标为应用下载时可以使用,没有选择自定义转化行为(excluded_dimension)时,使用该定向出价需要满足是 oCPC、oCPM 广告;
    同商品,仅当 SDPA 商品广告下使用,不支持自定义转化行为默认排除已下单、和已付费用户,不限制出价方式;
    非同应用、非同商品,没有选择自定义转化行为(excluded_dimension)时,使用该定向出价需要满足是 oCPC、oCPM 广告;,[枚举详情]
    枚举列表:{ EXCLUDED_DIMENSION_CAMPAIGN, EXCLUDED_DIMENSION_UID, EXCLUDED_DIMENSION_BUSINESS_MANAGER, EXCLUDED_DIMENSION_COMPANY_ACCOUNT, EXCLUDED_DIMENSION_APP, EXCLUDED_DIMENSION_PRODUCT }
    conversion_behavior_list
    enum[] 自定义转化行为,没有选择自定义转化行为(excluded_dimension)时,使用该定向需要校验是 oCPC、oCPM 广告,默认取出价转化目标值。当选择了自定义转化行为时,不需要校验 oCPC、oCPM 广告。,[枚举详情]
    数组长度为 1
    枚举列表:{ OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_FIRST_PURCHASE }
    scene_spec
    struct 场景定向
    mobile_union
    enum[] 优量汇行业定投流量包,当且仅当投放优量汇流量时可以使用(待废弃,请使用优量汇行业精选流量包,但不能和 mobile_union_industry 同时使用时),[枚举详情]
    数组最小长度 1,最大长度 9
    枚举列表:{ MOBILE_UNION_IN_WECHAT, 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_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 }
    union_position_package
    integer[] 定投优量汇流量包列表,一个广告最多可选择 20 个定投流量包,且该广告所有流量包关联的广告位数量不得超过 500 个
    数组最小长度 1,最大长度 20
    exclude_union_position_package
    integer[] 屏蔽优量汇流量包列表,一个广告最多可选择 20 个屏蔽流量包,且该广告所有流量包关联的广告位数量不得超过 500 个
    数组最小长度 1,最大长度 20
    tencent_news
    enum[] 腾讯新闻流量场景定向,当且仅当投放腾讯新闻流量时可以使用,功能灰度开放,[枚举详情]
    数组最小长度 1,最大长度 3
    枚举列表:{ TENCENT_NEWS_APP, TENCENT_NEWS_WECHAT, TENCENT_NEWS_QQ }
    display_scene
    enum[] 广告展示场景,当且仅当投放优量汇流量时可以使用,[枚举详情]
    数组最小长度 0,最大长度 32
    枚举列表:{ DISPLAY_SCENE_BANNER, DISPLAY_SCENE_INLINE, DISPLAY_SCENE_SPLASH, DISPLAY_SCENE_NATIVE, DISPLAY_SCENE_REWARDED_VIDEO }
    configured_status
    enum 客户设置的状态,[枚举详情]
    枚举列表:{ AD_STATUS_NORMAL, AD_STATUS_SUSPEND }

    微信公众账号逻辑

    1.该字段默认值为 AD_STATUS_NORMAL
    2.当且仅当该 adgroup 下拥有一个审核通过的广告且在线(已达设置的上线时段),才允许暂停
    customized_category
    string 自定义分类,关键词用半角逗号','分隔,如:本地生活,餐饮
    字段长度最小 0 字节,长度最大 200 字节

    微信公众账号逻辑

    不支持上传用户自定义类目
    additional_user_action_sets
    struct[] 补充的 app 用户行为数据源,灰度开放中。
    当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_ECOMMERCE、PROMOTED_OBJECT_TYPE_LINK、PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM,且行业为网服、电商、金融的广告主,可填写补充的 app 用户行为数据源。数据源需为安卓/ios 数据源,且需确保为同一个 app 的数据源。
    数组最小长度 0,最大长度 100
    type*
    enum 数据源类型,[枚举详情]
    枚举列表:{ USER_ACTION_SET_TYPE_WEB, USER_ACTION_SET_TYPE_IOS, USER_ACTION_SET_TYPE_ANDROID }
    id*
    integer 数据源 id,通过 user_action_sets 模块创建和获取,数据源 id 对应的类型要与 user_action_sets 中指定的 type 一致
    bid_strategy
    enum 出价策略,仅 oCPC/oCPM 广告可设置,且为必填,枚举列表:[枚举详情]
    枚举列表:{ BID_STRATEGY_AVERAGE_COST, BID_STRATEGY_TARGET_COST, BID_STRATEGY_PRIORITY_LOW_COST }
    cold_start_audience
    integer[] 扩量种子人群(原冷启动人群名称升级扩量种子人群)
    1、系统会学习您选择的人群包数据,帮助提升广告投放效果;
    2、当且仅当广告为 oCPC/oCPM 开启自动扩量的广告、且投放的流量不是应用宝时;
    3、仅支持人群类型为 CUSTOMER_FILE(号码文件人群)的可用人群 id、且人群数量大于 100 时;
    数组最大长度 10
    auto_audience
    boolean 是否使用系统优选,限制:
  • 系统优选不支持朋友圈广告使用;
  • 当 auto_audience=true 时系统自动选择匹配行为兴趣定向;
  • 系统优选(auto_audience)和行为兴趣定向(behavior_or_interest)不能同时填写,即行为兴趣和系统优选功能二选一;
  • 系统优选(auto_audience)和自动扩量(expand_enabled)功能、定向包 id(targeting_id)、自定义人群(custom_audience)功能互斥;

  • 可选值:{ true, false }

    微信公众账号逻辑

    不支持
    expand_enabled
    boolean 是否使用自动扩量,当广告为 oCPC/oCPM、CPC 出价时,可将 expand_enabled 设置为 true,微信广告当且仅当出价为 oCPC/oCPM 时,才可将 expand_enabled 设置为 true。,expand_enabled 设置为 true, 开启自动扩量
    可选值:{ true, false }

    微信公众账号逻辑

    当且仅当广告出价类型为 oCPC/oCPM 出价时,可以设置
    expand_targeting
    string[] 扩量不可突破定向,如果使用 oCPC/oCPM,会在 oCPC/oCPM 扩量定向的范围内寻找相似人群,原 targeting 接口传入的定向将失效。当且仅当 expand_enabled 设置为 true 时,expand_targeting 才可填写,且为必填。
    目前仅支持年龄、性别、地域、学历(不可突破学历仅教育行业可使用)定向设置为不可突破(前置需要定向 targeting 层级使用了年龄、性别、地域、学历时 不可突破才可以选择相对应的值)。
    数组最小长度 0,最大长度 4
    可选值:{ age, gender, geo_location, education }

    微信公众账号逻辑

    当且仅当广告出价类型为 oCPC/oCPM 出价时,可以设置,设置内容为不可突破定向范围
    deep_conversion_spec
    struct oCPC/oCPM 深度优化内容,创建时若此字段不传,或传空则视为无限制条件;更新时,若要关闭,则需要传空
    deep_conversion_type
    enum oCPC/oCPM 深度优化价值配置,[枚举详情]
    枚举列表:{ DEEP_CONVERSION_WORTH, DEEP_CONVERSION_BEHAVIOR }
    deep_conversion_behavior_spec
    struct oCPC/oCPM 优化转化行为配置
    goal*
    enum 优化转化行为目标,不可更改,如修改目标价格,需在结构体中传入已设置的优化转化行为目标。,枚举列表:[枚举详情]
    枚举列表:{ OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_LEADS_COLLECT }
    bid_amount*
    integer 深度优化行为的出价,深度优化行为出价,单位为分
    最小值 10,最大值 500000
    deep_conversion_worth_spec
    struct oCPC/oCPM 优化 ROI 配置
    goal*
    enum 优化 ROI 目标,不可更改,如修改深度优化效果值,需在结构体中传入已设置的优化 ROI 目标,枚举列表:[枚举详情]
    枚举列表:{ GOAL_30DAY_ORDER_ROAS, GOAL_1DAY_PURCHASE_ROAS, GOAL_1DAY_MONETIZATION_ROAS }
    expected_roi*
    float 深度优化价值效果值
    最小值 0.01,最大值 1000,最多保留 2 位小数
    deep_conversion_behavior_bid
    integer 深度优化行为的出价,使用转化 id 确认优化目标和深度优化目标的广告主,深度优化行为的目标出价无需传 deep_conversion_spec 结构体中字段,可直接使用 deep_conversion_behavior_bid 字段传输深度出价,单位为分。
    最小值 10,最大值 500000

    微信公众账号逻辑

    不支持微信账号
    deep_conversion_worth_rate
    float 深度优化价值的期望 ROI,使用转化 id 确认优化目标和深度优化目标的广告主,深度优化价值的目标出价无需传 deep_conversion_spec 结构体中字段,可直接使用 deep_conversion_worth_rate 字段传输深度出价。
    最小值 0.01,最大值 1000,最多保留 2 位小数

    微信公众账号逻辑

    不支持微信账号
    bid_mode
    enum 出价方式,
    1. bid_mode 为 billing_event 升级字段,不可同时输入,升级后直接写入 bid_mode 字段即可;
    2. 当投放智能出价广告,可写入 BID_MODE_OCPC/BID_MODE_OCPM。此时,optimization_goal 优化目标字段必填;
    3. 当投放非智能出价广告,可写入 BID_MODE_CPC/BID_MODE_CPM/BID_MODE_CPA。此时,optimization_goal 优化目标字段不可填;
    4. 针对非微信流量,BID_MODE_CPC 可编辑修改为 BID_MODE_OCPC,BID_MODE_CPM 可编辑修改为 BID_MODE_OCPM,其他修改不可操作。针对微信流量,bid_mode 字段不可修改,[枚举详情]
    枚举列表:{ BID_MODE_CPC, BID_MODE_CPA, BID_MODE_CPM, BID_MODE_OCPC, BID_MODE_OCPM }

    微信公众账号逻辑

    暂不支持微信账号

    使用说明

    1. 对于朋友圈广告(campaign_type= CAMPAIGN_TYPE_WECHAT_ MOMENTS),一旦广告审核通过且当前时间大于广告投放起始时间,则只允许修改 adgroup 模块的 adgroup_name(广告组名称)、targeting(定向)、bid_amount(出价)、daily_budget(日预算)、configured_status(启用/暂停状态)、end_date(结束投放日期)、time_series(投放时间段)以及 ad 模块的所有属性,广告组其他属性及相关创意模块的所有属性均不允许修改。
    2. targeting 和 targeting_id 不能同时填写,朋友圈广告只允许使用 targeting。
    3. 朋友圈广告的投放时间需大于等于 6 小时,小于等于 30 个自然日,且每天至少投放 6 小时,且每天投放的时段需保持一致。
    4. 针对朋友圈广告(campaign_type = CAMPAIGN_TYPE_WECHAT_MOMENTS),仅支持以下定向:地域(geo_location)、年龄(age)、性别(gender)、学历(education)、婚恋育儿状态(marital_status)、应用安装(app_install_status)、自定义人群(custom_audience)、排除自定义人群(excluded_custom_audience)、操作系统(user_os)、联网方式(network_type)、移动运营商(network_operator)、设备价格(device_price)、再营销(原微信广告行为定向 wechat_ad_behavior)、行为兴趣意向定向(behavior_or_interest)、设备品牌型号定向(device_brand_model)、游戏付费能力(game_consumption_level)。
    5. 地理位置定向的省市区县以及商圈 id、行为兴趣意向定向、微信公众号类型定向、移动媒体类型定向的可选值列表可通过 targeting_tags/get 接口进行获取。
    6. DPA 广告功能灰度开放,如有接入需求,请联系对接渠道运营同事线下进行申请。
    7. 非微信朋友圈广告的日预算(daily_budget)设置仅灰度开放,如有接入需求,请联系对接渠道运营同事线下进行申请。
    8. 非微信朋友圈广告的系统优选(auto_audience)设置仅灰度开放,如有接入需求,请联系对接渠道运营同事线下进行申请。

    请求示例

    
    curl 'https://api.e.qq.com/v1.1/adgroups/update?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -d 'account_id=<ACCOUNT_ID>' \
    -d 'adgroup_id=<ADGROUP_ID>' \
    -d 'adgroup_name=推广广告' \
    -d 'begin_date=2017-04-25' \
    -d 'end_date=2017-05-01' \
    -d 'bid_amount=200' \
    -d 'optimization_goal=OPTIMIZATIONGOAL_CLICK' \
    -d 'time_series=010100100110100010101010010101010101010100101010101010010101010101001010101010100101010101010111110010101001010110110100110001011001010100101010101010110011001010101010100101100101101110101010101010100110100110010100110101110111101110110110110110110110101101101101110110011101011101101011101101101101001010110111010111011010110110111011' \
    -d 'daily_budget=10000' \
    -d 'targeting_id=<TARGETING_ID>' \
    -d 'scene_spec={"mobile_union":["MOBILE_UNION_IN_WECHAT"]}' \
    -d 'configured_status=AD_STATUS_NORMAL' \
    -d 'customized_category=本地生活,餐饮' \
    -d 'additional_user_action_sets=[]' \
    -d 'cold_start_audience=[1024]' \
    -d 'expand_enabled=false' \
    -d 'expand_targeting=[]' \
    -d 'deep_conversion_spec={"deep_conversion_type":"DEEP_CONVERSION_BEHAVIOR","deep_conversion_behavior_spec":{"bid_amount":200}}' 
    					

    应答字段

    名称 类型 描述
    adgroup_id
    integer 广告组 id

    应答示例

    {
        "code": 0,
        "message": "",
        "message_cn": "",
        "data": {
            "adgroup_id": "<ADGROUP_ID>"
        }
    }

    可视化调试工具

    相关阅读


    获取广告组
    全部接口
    V1.1
    loading

    所属权限 Ads Management,Ads Insights
    请求地址 adgroups/get
    请求方法 get

    全局参数

    全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考

    参数名称 参数类型
    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
    filtering
    struct[] 过滤条件,若此字段不传,或传空则视为无限制条件,详见 [过滤条件]
    数组最小长度 1,最大长度 5
    field*
    string 过滤字段
    可选值:{ adgroup_id, configured_status, adgroup_name, campaign_id, promoted_object_type, created_time, last_modified_time }

    微信公众账号逻辑

    不能支持:configured_status,campaign_id,create_time,adgroup_name,
    能支持:adgroup_id,promoted_object_type,last_modified_time
    当使用 last_modified_time 作为过滤条件时,operator 仅支持 GREATER_EQUALS
    operator*
    enum 操作符
    当 field 取值 adgroup_id 时,枚举列表:{ EQUALS, IN }
    当 field 取值 configured_status 时,枚举列表:{ EQUALS }
    当 field 取值 adgroup_name 时,枚举列表:{ EQUALS, CONTAINS }
    当 field 取值 campaign_id 时,枚举列表:{ EQUALS }
    当 field 取值 promoted_object_type 时,枚举列表:{ EQUALS }
    当 field 取值 created_time 时,枚举列表:{ EQUALS, LESS_EQUALS, LESS, GREATER_EQUALS, GREATER }
    当 field 取值 last_modified_time 时,枚举列表:{ EQUALS, LESS_EQUALS, LESS, GREATER_EQUALS, GREATER }
    values*
    string[] 字段取值,values 数组的个数限制与 operator 的取值相关,详见 [过滤条件]

    当 field 取值 configured_status 时,
    枚举列表:{ AD_STATUS_NORMAL, AD_STATUS_SUSPEND }

    当 field 取值 adgroup_name 时,
    字段长度最小 1 字节,长度最大 180 字节

    当 field 取值 promoted_object_type 时,
    枚举列表:{ PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM, PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_QQ_MESSAGE, PROMOTED_OBJECT_TYPE_QZONE_VIDEO_PAGE, PROMOTED_OBJECT_TYPE_LOCAL_ADS, PROMOTED_OBJECT_TYPE_ARTICLE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_TENCENT_KE, PROMOTED_OBJECT_TYPE_EXCHANGE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_QZONE_PAGE_ARTICLE, PROMOTED_OBJECT_TYPE_QZONE_PAGE_IFRAMED, PROMOTED_OBJECT_TYPE_QZONE_PAGE, PROMOTED_OBJECT_TYPE_APP_PC, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_MINI_GAME_QQ }

    当 field 取值 created_time 时,
    字段长度为 10 字节

    当 field 取值 last_modified_time 时,
    字段长度为 10 字节

    微信公众账号逻辑

    当 field 取值 promoted_object_type 时,
    枚举列表:{PROMOTED_OBJECT_TYPE_APP_ANDROID,PROMOTED_OBJECT_TYPE_APP_IOS,PROMOTED_OBJECT_TYPE_ECOMMERCE,PROMOTED_OBJECT_TYPE_LINK_WECHAT,PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT,PROMOTED_OBJECT_TYPE_LEAD_AD}
    page
    integer 搜索页码,默认值:1
    最小值 1,最大值 99999
    page_size
    integer 一页显示的数据条数,默认值:10。最小值 1,最大值 100
    is_deleted
    boolean 是否已删除,true:是,false:否
    可选值:{ true, false }

    使用说明

    1. is_deleted 参数不传时默认为 false,只返回未删除记录。
    2. is_deleted 参数为 true 时,需要同时在 filtering 传参数 last_modified_time。
    3. 当根据广告组 id 进行查询且 is_deleted 参数不传或为 false 时,获取的广告组列表包含已删除的广告组。

    请求示例

    
    curl -G 'https://api.e.qq.com/v1.1/adgroups/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -d 'account_id=<ACCOUNT_ID>' \
    -d 'filtering=[{"field":"adgroup_name","operator":"EQUALS","values":["test"]}]' \
    -d 'page=1' \
    -d 'page_size=10' \
    -d 'is_deleted=false' 
    					

    应答字段

    名称 类型 描述
    list
    struct[] 返回信息列表
    campaign_id
    integer 推广计划 id
    adgroup_id
    integer 广告组 id
    adgroup_name
    string 广告组名称
    site_set
    enum[] 投放站点集合,当前单站点或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_MOBILE_INNER+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合,[枚举详情]

    微信公众账号逻辑

    仅支持 SITE_SET_WECHAT, SITE_SET_MINI_GAME_WECHAT
    automatic_site_enabled
    boolean 是否开启自动版位功能(暂不包含 SITE_SET_WECHAT 和 SITE_SET_MOMENTS),此字段与 site_set 字段至少需要写入一个。此字段目前灰度开放中。
    optimization_goal
    enum 广告优化目标类型,[枚举详情]

    微信公众账号逻辑

    可投组合可通过 Capabilities/get 接口获取,创建后不支持修改
    billing_event
    enum 计费类型,[枚举详情]
    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 元,单位为人民币)
  • daily_budget
    integer 广告组日预算,单位为分,设置为 0 表示不设预算(即不限)
    promoted_object_type
    enum 推广目标类型,[枚举详情]

    微信公众账号逻辑

    支持读取的推广目标类型:
    PROMOTED_OBJECT_TYPE_APP_ANDROID:Android 应用
    PROMOTED_OBJECT_TYPE_APP_IOS:IOS 应用
    PROMOTED_OBJECT_TYPE_ECOMMERCE:电商推广
    PROMOTED_OBJECT_TYPE_LINK_WECHAT:微信品牌页
    PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT:本地广告(微信推广)
    PROMOTED_OBJECT_TYPE_LEAD_AD:销售线索
    promoted_object_id
    string 推广目标 id,详见 [查询推广目标 id]
    app_android_channel_package_id
    string 安卓应用渠道包 id,在投放推广目标类型为 Android 应用的情况下,可以填写腾讯开放平台安卓应用和腾讯广告渠道包的渠道包 id。渠道包 id 可以从推广目标模块的读取接口获取,渠道包 id 字段由"xx;yy" 两部分组成,在写入时 xx 会被置为 0,0 为正常。

    微信公众账号逻辑

    1.同一个 campaign 下推广的渠道包信息必须是同一个
    2.渠道包信息不支持修改
    targeting_id
    integer 定向 id,仅非朋友圈广告有效

    微信公众账号逻辑

    不支持使用定向包
    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 地理位置定向,
    针对朋友圈广告地域必填,非朋友圈广告选填
    如使用地域定向"regions"、"business_districts"、"custom_locations" 不能同时为空
    location_types
    enum[] 地点类型,[枚举详情],选择限制:
  • 对于微信流量,仅能选择"LIVE_IN"(常住);
  • 使用商圈(business_district)以及自定义地理位置(custom_locations)时,仅可选 "VISITED_IN"(去过),"LIVE_IN"(常住);
  • 如:["LIVE_IN", "VISITED_IN"]

    微信公众账号逻辑

    仅能选择"LIVE_IN"(常住)
    regions
    integer[] 省市区县列表,可通过 [targeting_tags/get] 接口获取

    微信公众账号逻辑


    仅支持中国大陆(不包含港澳台)地域 id
    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 操作系统上展示,[枚举详情]

    微信公众账号逻辑

    仅支持{IOS,ANDROID}
    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_IOS、PROMOTED_OBJECT_TYPE_APP_ANDROID、PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP、PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION 时使用,[枚举详情]

    微信公众账号逻辑

    不支持。可使用再营销定向 wechat_ad_behavior
    consumption_status
    enum[] 消费水平,[枚举详情]

    微信公众账号逻辑

    不支持
    gamer_consumption_ability
    struct[] 游戏用户消费能力(仅支持单价格段,单位是“元/月”),定向待废弃,请使用新的游戏消费能力定向(game_consumption_level)进行接入,gamer_consumption_ability 和 game_consumption_level 不能同时使用
    min
    integer 游戏用户消费能力最小值限制,可填写的值为 1,10,20,30,40,50,60,70,80,90,100,200,300,400,500
    max
    integer 游戏用户消费能力最大值限制,可填写的值为 10,20,30,40,50,60,70,80,90,100,200,300,400,500,999999999,最大值 999999999 代表 500 以上
    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[] 消费类型定向,[枚举详情]

    微信公众账号逻辑

    支持,对应微信公众平台的“付费用户”定向:PAID_GOODS_VIRTUAL-游戏付费,PAID_GOODS_REAL-电商付费
    wechat_ad_behavior
    struct 微信再营销,原微信广告行为定向升级为微信再营销,当且仅当投放微信广告时有效
    actions
    enum[] 包含的行为列表,多个行为之间为并集(or)的关系
    数组最小长度 0,最大长度 10
    QQ 账号支持枚举列表:{WECHAT_OFFICIAL_ACCOUNT_AD_LIKE,WECHAT_MOMENTS_AD_LIKE,MINI_GAME_WECHAT_REGISTERED },[枚举详情]

    微信公众账号逻辑

    WECHAT_OFFICIAL_ACCOUNT_FOLLOWED,关注过广告主微信公众号
    APP_INSTALLED,已安装你的应用(推广目标仅支持 ANDROID、IOS)
    WECHAT_COUPON_OBTAINED,领取过广告主微信卡券
    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 },[枚举详情]

    微信公众账号逻辑

    WECHAT_OFFICIAL_ACCOUNT_FOLLOWED,关注过广告主微信公众号
    APP_INSTALLED,已安装你的应用(推广目标仅支持 ANDROID、IOS)
    WECHAT_COUPON_OBTAINED,领取过广告主微信卡券
    WECHAT_OFFICIAL_ACCOUNT_AD_LIKE,对微信公众号广告感兴趣
    WECHAT_MOMENTS_AD_LIKE,对微信朋友圈广告感兴趣
    MINI_GAME_WECHAT_REGISTERED,曾经注册过你的小游戏(仅推广目标为微信小游戏)
    custom_audience
    integer[] 自定义定向用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    excluded_custom_audience
    integer[] 自定义排除用户群,通过 [人群管理模块] 创建的人群 id,custom_audience 和 excluded_custom_audience 个数之和不能超过 200 个,如果有组合人群,则人群包数(组合人群和非组合人群)不能超过 50
    behavior_or_interest
    struct 行为兴趣意向定向
    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
    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)时可以使用

    微信公众账号逻辑

    不支持
    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] 接口获取
    mini_game_qq_status
    enum[] QQ 小游戏使用定向,[枚举详情],当且仅当投放 QQ 小游戏推广目标(promoted_object_type= PROMOTED_OBJECT_TYPE_MINI_GAME_QQ)时可以使用

    微信公众账号逻辑

    不支持
    excluded_converted_audience
    struct 排除已转化用户定向,(该定向灰度开放中)

    微信公众账号逻辑

    不支持微信账号
    excluded_dimension
    enum 排除已转化用户定向范围
    同应用,仅当推广目标为应用下载时可以使用,没有选择自定义转化行为(excluded_dimension)时,使用该定向出价需要满足是 oCPC、oCPM 广告;
    同商品,仅当 SDPA 商品广告下使用,不支持自定义转化行为默认排除已下单、和已付费用户,不限制出价方式;
    非同应用、非同商品,没有选择自定义转化行为(excluded_dimension)时,使用该定向出价需要满足是 oCPC、oCPM 广告;,[枚举详情]
    conversion_behavior_list
    enum[] 自定义转化行为,没有选择自定义转化行为(excluded_dimension)时,使用该定向需要校验是 oCPC、oCPM 广告
    targeting_translation
    string 已选择定向条件的描述
    is_include_unsupported_targeting
    boolean 是否包含不支持定向,true:包含 API 暂不支持读写的定向信息,false:不包含 API 暂不支持读写的定向信息
    scene_spec
    struct 场景定向
    mobile_union
    enum[] 优量汇行业定投流量包,当且仅当投放优量汇流量时可以使用(待废弃,请使用优量汇行业精选流量包,但不能和 mobile_union_industry 同时使用时),[枚举详情]
    exclude_mobile_union
    enum[] 优量汇行业屏蔽流量包,当且仅当投放优量汇流量时可以使用(待废弃,请使用优量汇行业精选流量包,但不能和 mobile_union_industry 同时使用时),[枚举详情]
    mobile_union_industry
    enum[] 优量汇行业精选流量包,当且仅当投放优量汇流量时可以使用,[枚举详情]
    union_position_package
    integer[] 定投优量汇流量包列表,一个广告最多可选择 20 个定投流量包,且该广告所有流量包关联的广告位数量不得超过 500 个
    exclude_union_position_package
    integer[] 屏蔽优量汇流量包列表,一个广告最多可选择 20 个屏蔽流量包,且该广告所有流量包关联的广告位数量不得超过 500 个
    tencent_news
    enum[] 腾讯新闻流量场景定向,当且仅当投放腾讯新闻流量时可以使用,功能灰度开放,[枚举详情]
    display_scene
    enum[] 广告展示场景,当且仅当投放优量汇流量时可以使用,[枚举详情]
    begin_date
    string 开始投放日期,日期格式:YYYY-MM-DD,且日期小于等于 end_date
    end_date
    string 结束投放日期,日期格式:YYYY-MM-DD,大于等于今天,且大于等于 begin_date ;如果希望长期投放,传空字符串
    time_series
    string 投放时间段,格式为 48 * 7 位字符串,且都为 0 和 1,以半个小时为最小粒度,从周一零点开始至周日 24 点结束。0 为不投放,1 为投放,全传 1 视为全时段投放,不允许全部传 0。朋友圈广告的投放时间小于等于 90 个自然日

    微信公众账号逻辑

    1.朋友圈投放时间小于等于 90 个自然日
    2.广告结束后不允许修改
    3.暂停后重启广告时:
    广告结束时间需大于当前时间+2 小时
    configured_status
    enum 客户设置的状态,[枚举详情]

    微信公众账号逻辑

    1.该字段默认值为 AD_STATUS_NORMAL
    2.当且仅当该 adgroup 下拥有一个审核通过的广告且在线(已达设置的上线时段),才允许暂停
    customized_category
    string 自定义分类,关键词用半角逗号','分隔,如:本地生活,餐饮

    微信公众账号逻辑

    不支持上传用户自定义类目
    created_time
    integer 创建时间(时间戳)
    last_modified_time
    integer 最后修改时间(时间戳)
    dynamic_ad_spec
    struct 动态商品广告属性,当广告形态为动态商品广告时,该字段必填

    微信公众账号逻辑

    sdpa 功能在 adgroup 上设置商品库信息
    product_mode 仅支持 single
    product_catalog_id
    integer 商品库 id
    product_mode
    enum 动态商品广告类型,目前只支持单商品动态商品广告,多商品动态商品广告敬请期待,[枚举详情]
    user_action_sets
    struct[] 用户行为数据源,详见 [转化归因功能],当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_ECOMMERCE、PROMOTED_OBJECT_TYPE_LINK 时,允许传入 WEB + iOS + Android 最多 3 个数据源;当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_ANDROID 时,只允许传入 1 个 Android 数据源;当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_IOS 时,只允许传入 1 个 iOS 数据源

    微信公众账号逻辑

    不支持设置,设置该信息会报错
    type
    enum 数据源类型,[枚举详情]

    微信公众账号逻辑

    不支持设置,设置该信息会报错
    id
    integer 数据源 id,通过 user_action_sets 模块创建和获取,数据源 id 对应的类型要与 user_action_sets 中指定的 type 一致
    additional_user_action_sets
    struct[] 补充的 app 用户行为数据源,灰度开放中。
    当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_ECOMMERCE、PROMOTED_OBJECT_TYPE_LINK、PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM,且行业为网服、电商、金融的广告主,可填写补充的 app 用户行为数据源。数据源需为安卓/ios 数据源,且需确保为同一个 app 的数据源。
    type
    enum 数据源类型,[枚举详情]
    id
    integer 数据源 id,通过 user_action_sets 模块创建和获取,数据源 id 对应的类型要与 user_action_sets 中指定的 type 一致
    is_deleted
    boolean 是否已删除,true:是,false:否
    dynamic_creative_id
    integer DC 动态创意 id

    微信公众账号逻辑

    不支持该能力,设置该信息会报错
    is_rewarded_video_ad
    boolean 是否是激励视频广告

    微信公众账号逻辑

    不需要设置,设置会被忽略
    cost_guarantee_message
    string 成本保障状态信息说明,不超过 1024 个字符
    cost_guarantee_status
    enum 成本保障状态,成本保障状态定义,[枚举详情]
    bid_strategy
    enum 出价策略,仅 oCPC/oCPM 广告可设置,枚举列表:[枚举详情]
    cold_start_audience
    integer[] 扩量种子人群(原冷启动人群名称升级扩量种子人群)
    1、系统会学习您选择的人群包数据,帮助提升广告投放效果;
    2、当且仅当广告为 oCPC/oCPM 开启自动扩量的广告、且投放的流量不是应用宝时;
    3、仅支持人群类型为 CUSTOMER_FILE(号码文件人群)的可用人群 id、且人群数量大于 100 时;
    auto_audience
    boolean 是否使用系统优选,限制:
  • 系统优选不支持朋友圈广告使用;
  • 当 auto_audience=true 时系统自动选择匹配行为兴趣定向;
  • 系统优选(auto_audience)和行为兴趣定向(behavior_or_interest)不能同时填写,即行为兴趣和系统优选功能二选一;
  • 系统优选(auto_audience)和自动扩量(expand_enabled)功能、定向包 id(targeting_id)、自定义人群(custom_audience)功能互斥;
  • 微信公众账号逻辑

    不支持
    expand_enabled
    boolean 是否使用自动扩量,当广告为 oCPC/oCPM、CPC 出价时,可将 expand_enabled 设置为 true,微信广告当且仅当出价为 oCPC/oCPM 时,才可将 expand_enabled 设置为 true。,expand_enabled 设置为 true, 开启自动扩量

    微信公众账号逻辑

    当且仅当广告出价类型为 oCPC/oCPM 出价时,可以设置
    expand_targeting
    string[] 扩量不可突破定向,如果使用 oCPC/oCPM,会在 oCPC/oCPM 扩量定向的范围内寻找相似人群,原 targeting 接口传入的定向将失效。当且仅当 expand_enabled 设置为 true 时,expand_targeting 才可填写,且为必填。
    目前仅支持年龄、性别、地域、学历(不可突破学历仅教育行业可使用)定向设置为不可突破(前置需要定向 targeting 层级使用了年龄、性别、地域、学历时 不可突破才可以选择相对应的值)。

    微信公众账号逻辑

    当且仅当广告出价类型为 oCPC/oCPM 出价时,可以设置,设置内容为不可突破定向范围
    deep_conversion_spec
    struct oCPC/oCPM 深度优化内容,创建时若此字段不传,或传空则视为无限制条件;更新时,若要关闭,则需要传空
    deep_conversion_type
    enum oCPC/oCPM 深度优化价值配置,[枚举详情]
    deep_conversion_behavior_spec
    struct oCPC/oCPM 优化转化行为配置
    goal
    enum 优化转化行为目标,不可更改,如修改目标价格,需在结构体中传入已设置的优化转化行为目标。,枚举列表:[枚举详情]
    bid_amount
    integer 深度优化行为的出价,深度优化行为出价,单位为分
    deep_conversion_worth_spec
    struct oCPC/oCPM 优化 ROI 配置
    goal
    enum 优化 ROI 目标,不可更改,如修改深度优化效果值,需在结构体中传入已设置的优化 ROI 目标,枚举列表:[枚举详情]
    expected_roi
    float 深度优化价值效果值
    deep_optimization_action_type
    enum oCPC/oCPM 深度优化方式配置 当深度优化类型=优化深度转化行为时,此前支持选择“优化方式”;目前深度优化能力升级,两阶段/双目标优化方式已进行合并,因此优化方式字段即将下线,可以不再输入。如调用该字段,系统会默认按两阶段优化方式进行创建,了解更多
    conversion_id
    integer 转化 id,包含优化目标,深度优化目标,数据上报方式,归因方式等信息,仅 ocpc/ocpm 广告可设置,转化 id 设置后不可修改。可通过辅助工具[转化查询接口]查询可使用的转化 id。当传入转化 id 时,可无需再传入 user_action_sets,additional_user_action_sets,optimization_goal,deep_conversion_spec 字段信息。如若同时传入转化 id 和 user_action_sets/additional_user_action_sets,将以转化 id 的信息为第一优先级;如若同时传入转化 id 和 optimization_goal/deep_conversion_spec,仅当转化 id 中包含的优化目标/深度优化目标与传入的优化目标/深度优化目标信息一致时,才允许创建,否则将不允许创建。功能灰度开放中。

    微信公众账号逻辑

    不支持微信账号。
    deep_conversion_behavior_bid
    integer 深度优化行为的出价,使用转化 id 确认优化目标和深度优化目标的广告主,深度优化行为的目标出价无需传 deep_conversion_spec 结构体中字段,可直接使用 deep_conversion_behavior_bid 字段传输深度出价,单位为分。

    微信公众账号逻辑

    不支持微信账号
    deep_conversion_worth_rate
    float 深度优化价值的期望 ROI,使用转化 id 确认优化目标和深度优化目标的广告主,深度优化价值的目标出价无需传 deep_conversion_spec 结构体中字段,可直接使用 deep_conversion_worth_rate 字段传输深度出价。

    微信公众账号逻辑

    不支持微信账号
    android_channel_package_audit_message
    string 广告包渠道包审核消息
    system_status
    enum 广告组在系统中的状态,[枚举详情]
    bid_mode
    enum 出价方式,
    1. bid_mode 为 billing_event 升级字段,不可同时输入,升级后直接写入 bid_mode 字段即可;
    2. 当投放智能出价广告,可写入 BID_MODE_OCPC/BID_MODE_OCPM。此时,optimization_goal 优化目标字段必填;
    3. 当投放非智能出价广告,可写入 BID_MODE_CPC/BID_MODE_CPM/BID_MODE_CPA。此时,optimization_goal 优化目标字段不可填;
    4. 针对非微信流量,BID_MODE_CPC 可编辑修改为 BID_MODE_OCPC,BID_MODE_CPM 可编辑修改为 BID_MODE_OCPM,其他修改不可操作。针对微信流量,bid_mode 字段不可修改,[枚举详情]

    微信公众账号逻辑

    暂不支持微信账号
    status
    enum 广告状态,[枚举详情]
    page_info
    struct 分页配置信息
    page
    integer 搜索页码
    page_size
    integer 一页显示的数据条数
    total_number
    integer 总条数
    total_page
    integer 总页数

    应答示例

    {
        "code": 0,
        "message": "",
        "message_cn": "",
        "data": {
            "list": [
                {
                    "campaign_id": "<CAMPAIGN_ID>",
                    "adgroup_id": "<ADGROUP_ID>",
                    "adgroup_name": "推广广告",
                    "site_set": [
                        "SITE_SET_QZONE"
                    ],
                    "optimization_goal": "OPTIMIZATIONGOAL_CLICK",
                    "billing_event": "BILLINGEVENT_CLICK",
                    "bid_amount": 200,
                    "daily_budget": 10000,
                    "promoted_object_type": "PROMOTED_OBJECT_TYPE_LINK",
                    "targeting_id": "<TARGETING_ID>",
                    "scene_spec": {
                        "mobile_union": [
                            "MOBILE_UNION_IN_WECHAT"
                        ]
                    },
                    "begin_date": "2017-04-25",
                    "end_date": "2017-05-01",
                    "time_series": "010100100110100010101010010101010101010100101010101010010101010101001010101010100101010101010111110010101001010110110100110001011001010100101010101010110011001010101010100101100101101110101010101010100110100110010100110101110111101110110110110110110110101101101101110110011101011101101011101101101101001010110111010111011010110110111011",
                    "configured_status": "AD_STATUS_NORMAL",
                    "customized_category": "本地生活,餐饮",
                    "created_time": 1491019858,
                    "last_modified_time": 1491098468,
                    "user_action_sets": [],
                    "additional_user_action_sets": [],
                    "is_deleted": false,
                    "cold_start_audience": [
                        1024
                    ],
                    "expand_enabled": false,
                    "expand_targeting": [],
                    "deep_conversion_spec": {
                        "deep_conversion_type": "DEEP_CONVERSION_BEHAVIOR",
                        "deep_conversion_behavior_spec": {
                            "bid_amount": 200
                        }
                    },
                    "system_status": "AD_STATUS_NORMAL"
                }
            ],
            "page_info": {
                "page": 1,
                "page_size": 10,
                "total_number": 1,
                "total_page": 1
            }
        }
    }

    可视化调试工具

    相关阅读


    删除广告组
    全部接口
    V1.1
    loading

    所属权限 Ads Management
    请求地址 adgroups/delete
    请求方法 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_id*
    integer 广告组 id

    使用说明

    1. 朋友圈类型的推广计划下的广告组不能全部被删除,如果需要全删除,请直接删除对应 campaign。
    2. 微信公众账号所创建的推广计划下的广告组不能全部被删除,如果需要全删除,请直接删除对应 campaign。

    请求示例

    
    curl 'https://api.e.qq.com/v1.1/adgroups/delete?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -d 'account_id=<ACCOUNT_ID>' \
    -d 'adgroup_id=<ADGROUP_ID>' 
    					

    应答字段

    名称 类型 描述
    adgroup_id
    integer 广告组 id

    应答示例

    {
        "code": 0,
        "message": "",
        "message_cn": "",
        "data": {
            "adgroup_id": "<ADGROUP_ID>"
        }
    }

    可视化调试工具

    相关阅读