更新广告组
全部接口

所属权限 ads_management
请求地址 adgroups/update
请求方法 POST
Content-Type application/json

全局参数

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

参数名称 参数类型
access_token 授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节
timestamp

当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。

MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳

MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce 随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性

请求参数

标有*的参数为必填项

名称 类型 描述
account_id*
 integer 广告主帐号 id，有操作权限的帐号 id，不支持代理商 id
adgroup_id*
 int64 广告组 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 字节
first_day_begin_time
 string 首日开始投放时间，首日开始投放时间：HH:ii:ss
字段长度最小 0 字节，长度最大 8 字节
bid_amount
 integer 广告出价，单位为分，详见 [出价规则]
optimization_goal
 enum 广告优化目标类型，[枚举详情]
可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, 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_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS }
time_series
 string 投放时间段，格式为 48 * 7 位字符串，且都为 0 和 1，以半个小时为最小粒度，从周一零点开始至周日 24 点结束。0 为不投放，1 为投放，全传 1 视为全时段投放，不允许全部传 0。朋友圈广告的投放时间需大于等于 6 小时，小于等于 30 个自然日，且每天至少投放 6 小时，且每天投放的时段需保持一致
字段长度为 336 字节
daily_budget
 integer 日限额，单位为分，

对于微信朋友圈广告（campaign_type = CAMPAIGN_TYPE_WECHAT_MOMENTS）：

  • 朋友圈广告日预算必填
  • 日预算要求介于 100,000 – 1,000,000,000 分之间（1,000 元-10,000,000 元，单位为人民币）；
  • 修改后的日预算不能低于该广告组今日已消耗金额的 1.5 倍；
  • 每次修改幅度不能低于 5,000 分（50 元，单位为人民币）。

    • 对于非微信朋友圈广告（campaign_type ！= CAMPAIGN_TYPE_WECHAT_MOMENTS）：

  • 日预算需介于 5,000 分-400,000,000 分之间（50 元-4,000,000 元，单位为人民币）；
  • 每次修改幅度不能低于该 adgroup 今日已消耗金额加上 5,000 分（50 元，单位为人民币）；
  • 每次修改幅度不能低于 5,000 分（50 元，单位为人民币）；
  • 每天每广告组最多修改 1,000 次。
    		•
    targeting
    		 struct 定向详细设置，存放所有定向条件
    geo_location
    		 struct 地理位置定向，"regions"、"business_districts"、"custom_locations" 不能同时为空。微信朋友圈广告必填，且所选地理位置需在同一城市级别，城市级别可通过 targeting_tags/get 接口获取
    location_types*
    		 enum[] 地点类型，[枚举详情]，选择限制：
  • 对于微信流量，仅能选择"LIVE_IN"（常住）；
  • 使用商圈（business_district）以及自定义地理位置（custom_locations）时，仅可选 "VISITED_IN"（去过），"LIVE_IN"（常住）；
    • 如：["LIVE_IN", "VISITED_IN"]

    数组最小长度 1，最大长度 5
    可选值：{ RECENTLY_IN, VISITED_IN, LIVE_IN, TRAVEL_IN, CAA_RECENTLY_IN, LIVE_AND_RECENTLY, INTELLIGENCE }
    regions
    		 integer[] 省市区县列表，可通过 [targeting_tags/get] 接口获取
    数组最小长度 0，最大长度 1000
    business_districts
    		 integer[] 商圈 id 列表，可通过 [targeting_tags/get] 接口获取
    数组最小长度 0，最大长度 400
    custom_locations
    		 struct[] 自定义地理位置列表，使用火星系坐标，当广告类型为朋友圈广告时（campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS），custom_locations 的数组长度限制为最小长度 1，最大长度 100。
    数组最小长度 1，最大长度 400
    longitude*
    		 float64 经度，单位度
    最小值-180，最大值 180，最多保留 6 位小数
    latitude*
    		 float64 纬度，单位度
    最小值-90，最大值 90，最多保留 6 位小数
    radius*
    		 integer 半径，单位米
    最小值 200，最大值 25000
    geo_location_auto_audience
    		 boolean 是否使用地域优选
    可选值：{ true, false }
    gender
    		 enum[] 性别定向，仅单选，[枚举详情]
    数组长度为 1
    可选值：{ MALE, FEMALE }
    age
    		 struct[] 年龄定向，仅支持单年龄段，范围为 14~66，66 代表的是 66 岁及 66 岁以上，如 18~66 代表大于等于 18 岁
    数组最小长度 1，最大长度 5
    min*
    		 integer 年龄限制
    最小值 14，最大值 66
    max*
    		 integer 年龄限制
    最小值 14，最大值 66
    education
    		 enum[] 用户学历，[枚举详情]
    数组最小长度 1，最大长度 100
    可选值：{ DOCTOR, MASTER, BACHELOR, SENIOR, JUNIOR, PRIMARY, JUNIOR_COLLEGE }
    app_install_status
    		 enum[] 应用用户，[枚举详情]
    数组长度为 1
    可选值：{ NOT_INSTALLED, INSTALLED }
    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 }
    excluded_converted_audience
    		 struct 排除已转化人群行为定向
    excluded_dimension*
    		 enum 排除已转化人群的数据维度，排除已转化人群的数据维度枚举，[枚举详情]
    可选值：{ EXCLUDED_DIMENSION_UID, EXCLUDED_DIMENSION_BUSINESS_MANAGER, EXCLUDED_DIMENSION_COMPANY_ACCOUNT, EXCLUDED_DIMENSION_APP, EXCLUDED_DIMENSION_PRODUCT }
    conversion_behavior_list
    		 enum[] 转化行为，ENUM 值同广告优化目标类型，[枚举详情]
    数组最小长度 1，最大长度 2
    可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, 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_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS }
    custom_audience
    		 integer[] 定向用户群，通过 [创建人群接口] 创建的人群 id，custom_audience 和 excluded_custom_audience 个数之和不能超过 50 个
    数组最小长度 1，最大长度 200
    excluded_custom_audience
    		 integer[] 排除用户群，通过 [创建人群接口] 创建的人群 id，custom_audience 和 excluded_custom_audience 个数之和不能超过 50 个
    数组最小长度 1，最大长度 200
    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
    user_os
    		 enum[] 操作系统定向，当 marketing_carrier_type=MARKETING_CARRIER_TYPE_APP_ANDROID 时，广告只会在 Android 操作系统上展示；当 marketing_carrier_type=MARKETING_CARRIER_TYPE_APP_IOS 时，广告只会在 iOS 操作系统上展示，[枚举详情]
    数组最小长度 1，最大长度 100
    可选值：{ IOS, IOS_VERSION_4, IOS_VERSION_5, IOS_VERSION_6, IOS_VERSION_7, IOS_VERSION_8, IOS_VERSION_9, IOS_VERSION_10, IOS_VERSION_11, IOS_VERSION_12, IOS_VERSION_13, IOS_VERSION_14, IOS_VERSION_15, IOS_VERSION_16, IOS_VERSION_17, ANDROID, ANDROID_VERSION_1, ANDROID_VERSION_2, ANDROID_VERSION_3, ANDROID_VERSION_4, ANDROID_VERSION_5, ANDROID_VERSION_6, ANDROID_VERSION_7, ANDROID_VERSION_8, ANDROID_VERSION_9, ANDROID_VERSION_10, ANDROID_VERSION_11, ANDROID_VERSION_12, ANDROID_VERSION_13, ANDROID_VERSION_14, WINDOWS, SYMBIAN, JAVA }
    network_type
    		 enum[] 联网方式定向，[枚举详情]
    数组最小长度 1，最大长度 100
    可选值：{ WIFI, NET_2G, NET_3G, NET_4G, NET_5G }
    device_price
    		 enum[] 设备价格定向，仅对微信流量广告有效，[枚举详情]，[枚举详情]
    数组最小长度 1，最大长度 100
    可选值：{ PRICE_1500_LESS, PRICE_1500_2500, PRICE_2500_3500, PRICE_3500_4500, PRICE_4500_MORE }
    wechat_ad_behavior
    		 struct 微信广告行为定向，当且仅当投放微信广告时有效
    actions
    		 enum[] 微信再营销类型，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[] 微信再营销类型，WECHAT_OFFICIAL_ACCOUNT_FOLLOWED，关注过广告主微信公众号
    APP_INSTALLED，已安装你的应用（推广目标仅支持 ANDROID、IOS）
    WECHAT_COUPON_OBTAINED，领取过广告主微信卡券
    WECHAT_OFFICIAL_ACCOUNT_AD_LIKE，对微信公众号广告感兴趣
    WECHAT_MOMENTS_AD_LIKE，对微信朋友圈广告感兴趣
    MINI_GAME_WECHAT_REGISTERED，曾经注册过你的小游戏（仅推广目标为微信小游戏），[枚举详情]
    game_consumption_level
    		 enum[] 游戏消费能力，QQ 账号不支持使用，原 gamer_consumption_ability 定向升级版，gamer_consumption_ability 和 game_consumption_level 不能同时使用，[枚举详情]
    数组最小长度 1，最大长度 2
    可选值：{ HIGH, NORMAL }
    excluded_os
    		 enum[] 排除操作系统定向，目前 ANDROID_PURE_MODE 枚举仅支持 MARKETING_CARRIER_TYPE_APP_ANDROID 载体类型，[枚举详情]
    数组最小长度 1，最大长度 100
    可选值：{ ANDROID_PURE_MODE, IOS, IOS_VERSION_4, IOS_VERSION_5, IOS_VERSION_6, IOS_VERSION_7, IOS_VERSION_8, IOS_VERSION_9, IOS_VERSION_10, IOS_VERSION_11, IOS_VERSION_12, IOS_VERSION_13, IOS_VERSION_14, IOS_VERSION_15, IOS_VERSION_16, IOS_VERSION_17, ANDROID, ANDROID_VERSION_1, ANDROID_VERSION_2, ANDROID_VERSION_3, ANDROID_VERSION_4, ANDROID_VERSION_5, ANDROID_VERSION_6, ANDROID_VERSION_7, ANDROID_VERSION_8, ANDROID_VERSION_9, ANDROID_VERSION_10, ANDROID_VERSION_11, ANDROID_VERSION_12, ANDROID_VERSION_13, ANDROID_VERSION_14, WINDOWS, SYMBIAN, JAVA }
    scene_spec
    		 struct 场景定向
    mobile_union
    		 enum[] 移动联盟场景定向，当且仅当投放移动联盟流量时可以使用，[枚举详情]
    数组最小长度 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[] 移动联盟场景屏蔽定向，当且仅当投放移动联盟流量时可以使用，[枚举详情]
    数组最小长度 1，最大长度 8
    可选值：{ MOBILE_UNION_IN_WECHAT, MOBILE_UNION_REWARDED_VIDEO, MOBILE_UNION_REWARDED_MEDIA, MOBILE_UNION_GAME_ADVERTISER_EXCLUDE, MOBILE_UNION_READ_ADVERTISER_EXCLUDE, MOBILE_UNION_LIGHT_GAME_ADVERTISER_EXCLUDE }
    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 }
    wechat_scene
    		 struct 微信场景定向
    official_account_media_category
    		 integer[] 公众号媒体类型
    数组最小长度 0，最大长度 100
    mini_program_and_mini_game
    		 integer[] 小程序小游戏流量类型
    数组最小长度 0，最大长度 100
    pay_scene
    		 integer[] 订单详情页消费场景
    数组最小长度 0，最大长度 100
    wechat_position
    		 integer[] 微信公众号与小程序定投
    数组最小长度 0，最大长度 100
    mobile_union_category
    		 integer[] 优量汇媒体类型场景定向，当且仅当投放优量汇流量时（site_set = SITE_SET_MOBILE_UNION）时可以使用
    数组最小长度 1，最大长度 200
    qbsearch_scene
    		 enum[] QQ 浏览器、应用宝流量场景，当且仅当投放 SITE_SET_QBSEARCH 版位时可以使用，[枚举详情]
    数组最小长度 0，最大长度 32
    可选值：{ QBSEARCH_SCENE_MOBILE, QBSEARCH_SCENE_PC }
    wechat_channels_scene
    		 integer[] 微信视频号定投
    数组最小长度 0，最大长度 100
    user_action_sets
    		 struct[] 用户行为数据源，详见 [转化归因功能]
    数组最小长度 1，最大长度 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 一致
    data_source_id
    		 integer DN 数据源 id，新的 DN 数据源 id，与知数数据源 id 一一对应
    bid_strategy
    		 enum 出价策略，仅 ocpa 广告可设置，枚举列表：[枚举详情]
    可选值：{ BID_STRATEGY_AVERAGE_COST, BID_STRATEGY_TARGET_COST, BID_STRATEGY_PRIORITY_LOW_COST, BID_STRATEGY_PRIORITY_CAP_COST }
    deep_conversion_spec
    		 struct oCPA 深度优化内容，若此字段不传，或传空则视为无限制条件
    deep_conversion_type
    		 enum oCPA 深度优化价值配置，[枚举详情]
    可选值：{ DEEP_CONVERSION_WORTH, DEEP_CONVERSION_BEHAVIOR, DEEP_CONVERSION_WORTH_ADVANCED, DEEP_CONVERSION_BEHAVIOR_ADVANCED }
    deep_conversion_behavior_spec
    		 struct oCPA 优化转化行为配置
    goal*
    		 enum 优化转化行为目标，枚举列表：[枚举详情]
    可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, 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_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS }
    bid_amount*
    		 integer 深度优化行为的出价，深度优化行为出价，单位为分
    最小值 0，最大值 1000000
    deep_conversion_worth_spec
    		 struct oCPA 优化 ROI 配置
    goal*
    		 enum 优化 ROI 目标，枚举列表：[枚举详情]
    可选值：{ GOAL_7DAY_PURCHASE_ROAS, GOAL_30DAY_ORDER_ROAS, GOAL_1DAY_PURCHASE_ROAS, GOAL_1DAY_MONETIZATION_ROAS, GOAL_7DAY_MONETIZATION_ROAS, GOAL_7DAY_RETENTION_TIMES, GOAL_7DAY_LONGTERM_PURCHASE_ROAS, GOAL_14DAY_LONGTERM_PURCHASE_ROAS, GOAL_30DAY_LONGTERM_PURCHASE_ROAS, GOAL_QYT_7DAY_LIVE_STREAM_DEAL_ROAS }
    expected_roi
    		 float 深度优化价值效果值
    最小值 0，最大值 1000，最多保留 3 位小数
    deep_conversion_worth_advanced_spec
    		 struct oCPC/oCPM 优化 ROI 配置
    goal*
    		 enum 优化 ROI 目标，枚举列表：[枚举详情]
    可选值：{ GOAL_7DAY_PURCHASE_ROAS, GOAL_30DAY_ORDER_ROAS, GOAL_1DAY_PURCHASE_ROAS, GOAL_1DAY_MONETIZATION_ROAS, GOAL_7DAY_MONETIZATION_ROAS, GOAL_7DAY_RETENTION_TIMES, GOAL_7DAY_LONGTERM_PURCHASE_ROAS, GOAL_14DAY_LONGTERM_PURCHASE_ROAS, GOAL_30DAY_LONGTERM_PURCHASE_ROAS, GOAL_QYT_7DAY_LIVE_STREAM_DEAL_ROAS }
    expected_roi*
    		 float 深度优化价值效果值
    最小值 0，最大值 1000，最多保留 3 位小数
    deep_conversion_behavior_advanced_spec
    		 struct oCPX 深度辅助配置
    goal*
    		 enum 深度辅助优化 OG 目标，枚举列表：[枚举详情]
    可选值：{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, 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_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER, OPTIMIZATIONGOAL_CLICK_LEADS_COMPONENT, OPTIMIZATIONGOAL_REGULAR_PRICE_COURSE, OPTIMIZATIONGOAL_VISIT_STROE, OPTIMIZATIONGOAL_EFFECTIVE_ENTRY, OPTIMIZATIONGOAL_CREDIT_RATIO, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_DEAL, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_PRODUCT_CLICK, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_AUDIENCE, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_COMMENT, OPTIMIZATIONGOAL_QYT_LIVE_STREAM_FANS }
    bid_amount*
    		 integer 深度辅助优化 OG 出价，深度辅助优化 OG 出价，单位为分
    最小值 0，最大值 1000000
    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 字段传输深度出价。单位为分。
    最小值 0，最大值 1000000
    deep_conversion_worth_rate
    		 float 深度优化价值的出价，使用转化 id 确认优化目标和深度优化目标的广告主，深度优化价值的目标出价无需传 deep_conversion_spec 结构体中字段，可直接使用 deep_conversion_worth_rate 字段传输深度出价。比值，没有单位
    最小值 0.001，最大值 1000，最多保留 3 位小数
    deep_conversion_worth_advanced_rate
    		 float 强化优化价值的期望 ROI，使用转化 id 确认优化目标和强化优化目标的广告主，强化优化价值的目标出价无需传 deep_conversion_spec 结构体中字段，可直接使用 deep_conversion_worth_advanced_rate 字段传输深度出价。该功能灰度开放中。
    最小值 0.001，最大值 1000，最多保留 3 位小数
    deep_conversion_behavior_advanced_bid
    		 integer 深度辅助优化 OG 出价，使用转化 id 确认优化目标和深度辅助优化 OG 的广告主，深度辅助优化 OG 出价无需传 deep_conversion_spec 结构体中字段，可直接使用 deep_conversion_behavior_advanced_bid 字段传输深度出价。单位为分。
    最小值 0，最大值 1000000
    bid_mode
    		 enum 出价方式，[枚举详情]
    可选值：{ BID_MODE_CPC, BID_MODE_CPA, BID_MODE_CPM, BID_MODE_OCPC, BID_MODE_OCPM }
    auto_acquisition_enabled
    		 boolean 一键起量开关，一键起量开关定义
    可选值：{ true, false }
    auto_acquisition_budget
    		 integer 一键起量预算，单位为分，一键起量预算定义
    最小值 20000，最大值 10000000
    auto_derived_landing_page_switch
    		 boolean 是否开启自动衍生落地页开关
    可选值：{ true, false }
    auto_derived_creative_enabled
    		 boolean 是否开启自动衍生视频创意，该功能灰度开放中。

    开启后，根据广告主的投放数据以及上传的素材, 通过策略选择效果最佳的视频模板、音乐, 并复制已有创意元素, 程序化生成视频创意。


    可选值：{ true, false }
    configured_status
    		 enum 客户设置的状态，[枚举详情]
    可选值：{ AD_STATUS_NORMAL, AD_STATUS_SUSPEND }
    flow_optimization_enabled
    		 boolean 是否使用自动流量优选，仅支持优量汇版位使用，且不能和优量汇行业精选流量包(mobile_union_industry)或优量汇媒体类型场景定向（mobile_union_category）同时使用，flow_optimization_enabled 设置为 true, 开启自动流量优选
    可选值：{ true, false }
    poi_list
    		 string[] 门店 id 列表
    数组最大长度 500
    字段长度最小 0 字节，长度最大 1024 字节
    ecom_pkam_switch
    		 enum 一方人群跑量加强开关状态，[枚举详情]
    可选值：{ ECOM_PKAM_SWITCH_CLOSE, ECOM_PKAM_SWITCH_OPEN }
    cost_constraint_scene
    		 enum 成本控制场景，[枚举详情]
    可选值：{ COST_CONSTRAINT_SCENE_OPEN }
    custom_cost_cap
    		 integer 用户输入的成本上限，上限值范围为 0-20000 元
    最小值 0，最大值 2000000

    请求示例

    
curl 'https://api.e.qq.com/v3.0/adgroups/update?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
    "account_id": "<ACCOUNT_ID>",
    "adgroup_id": "<ADGROUP_ID>",
    "adgroup_name": "推广广告",
    "begin_date": "2024-03-27",
    "end_date": "2025-03-27",
    "first_day_begin_time": "06:00:00",
    "optimization_goal": "OPTIMIZATIONGOAL_ECOMMERCE_ORDER",
    "time_series": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
    "daily_budget": 6000,
    "targeting": {
        "user_os": [
            "ANDROID"
        ],
        "geo_location": {
            "regions": [
                156,
                110000,
                120000,
                130000,
                140000,
                150000,
                210000,
                220000,
                230000,
                310000,
                320000,
                330000,
                340000,
                350000,
                360000,
                370000,
                410000,
                420000,
                430000,
                440000,
                450000,
                460000,
                500000,
                510000,
                520000,
                530000,
                540000,
                610000,
                620000,
                630000,
                640000,
                650000
            ],
            "location_types": [
                "LIVE_IN"
            ]
        },
        "age": [
            {
                "min": 14,
                "max": 18
            }
        ],
        "gender": [
            "MALE"
        ],
        "education": [
            "DOCTOR"
        ],
        "marital_status": [
            "SINGLE"
        ],
        "excluded_converted_audience": {
            "excluded_dimension": "EXCLUDED_DIMENSION_CAMPAIGN",
            "conversion_behavior_list": [
                "OPTIMIZATIONGOAL_BRAND_CONVERSION",
                "OPTIMIZATIONGOAL_FOLLOW"
            ]
        },
        "device_brand_model": {
            "included_list": [
                1
            ],
            "excluded_list": [
                2
            ]
        },
        "network_type": [
            "NET_5G"
        ],
        "device_price": [
            "PRICE_4500_MORE"
        ],
        "wechat_ad_behavior": {
            "actions": [
                "WECHAT_OFFICIAL_ACCOUNT_AD_LIKE"
            ]
        }
    },
    "scene_spec": {
        "wechat_scene": {
            "official_account_media_category": [
                1
            ],
            "mini_program_and_mini_game": [
                1001000
            ],
            "pay_scene": [
                3000000
            ]
        },
        "wechat_position": [
            1024789
        ],
        "wechat_channels_scene": [
            2100283,
            2100284,
            2100488
        ]
    },
    "bid_strategy": "BID_STRATEGY_UNSUPPORTED",
    "bid_mode": "BID_MODE_OCPM",
    "auto_derived_creative_enabled": false,
    "auto_derived_landing_page_switch": false,
    "flow_optimization_enabled": false,
    "ecom_pkam_switch": "ECOM_PKAM_SWITCH_CLOSE",
    "cost_constraint_scene": "COST_CONSTRAINT_SCENE_OPEN",
    "custom_cost_cap": 2000000
}'

    应答字段

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

    应答示例

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

    可视化调试工具

    相关阅读

    广告组定向微信朋友圈广告投放指引oCPA 智能出价广告投放指引动态商品广告投放指引

    广告资源

    广告技术

    开发文档

    辅助工具

    帮助支持

    手机浏览开发者官网

    Copyright © 1998 - Tencent Inc. All Rights Reserved.