创建广告组
开发环境
开发环境
POST
/v1.3/adgroups/add
场景组合示例
{
"account_id": 10000001,
"adgroup_name": "腾讯广告投放2021",
"app_android_channel_package_id": "0;000116083930371111111111",
"begin_date": "2021-01-01",
"bid_amount": 5000,
"bid_strategy": "BID_STRATEGY_AVERAGE_COST",
"billing_event": "BILLINGEVENT_IMPRESSION",
"campaign_id": 2000001,
"cold_start_audience": [],
"configured_status": "AD_STATUS_NORMAL",
"daily_budget": 0,
"deep_conversion_spec": {
"deep_conversion_behavior_spec": {
"bid_amount": 5000,
"goal": "OPTIMIZATIONGOAL_ONE_DAY_RETENTION"
},
"deep_conversion_type": "DEEP_CONVERSION_BEHAVIOR"
},
"end_date": "2021-12-31",
"expand_enabled": "true",
"expand_targeting": [],
"optimization_goal": "OPTIMIZATIONGOAL_APP_ACTIVATE",
"promoted_object_id": "1010101",
"promoted_object_type": "PROMOTED_OBJECT_TYPE_APP_ANDROID",
"site_set": [
"SITE_SET_WECHAT"
],
"targeting_id": 10001,
"time_series": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111"
}
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1.3/adgroups/add' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'campaign_id=<CAMPAIGN_ID>' \
--data-urlencode 'adgroup_name=推广广告' \
--data-urlencode 'promoted_object_type=PROMOTED_OBJECT_TYPE_LINK' \
--data-urlencode 'begin_date=2017-04-25' \
--data-urlencode 'end_date=2017-05-01' \
--data-urlencode 'billing_event=BILLINGEVENT_CLICK' \
--data-urlencode 'bid_amount=200' \
--data-urlencode 'optimization_goal=OPTIMIZATIONGOAL_CLICK' \
--data-urlencode 'time_series=010100100110100010101010010101010101010100101010101010010101010101001010101010100101010101010111110010101001010110110100110001011001010100101010101010110011001010101010100101100101101110101010101010100110100110010100110101110111101110110110110110110110101101101101110110011101011101101011101101101101001010110111010111011010110110111011' \
--data-urlencode 'site_set=["SITE_SET_QZONE"]' \
--data-urlencode 'daily_budget=10000' \
--data-urlencode 'targeting_id=111111111' \
--data-urlencode 'scene_spec={"mobile_union":["MOBILE_UNION_IN_WECHAT"]}' \
--data-urlencode 'configured_status=AD_STATUS_NORMAL' \
--data-urlencode 'customized_category=本地生活,餐饮' \
--data-urlencode 'user_action_sets=[]' \
--data-urlencode 'additional_user_action_sets=[]' \
--data-urlencode 'cold_start_audience=[1024]' \
--data-urlencode 'expand_enabled=false' \
--data-urlencode 'expand_targeting=[]' \
--data-urlencode 'deep_conversion_spec={"deep_conversion_type":"DEEP_CONVERSION_BEHAVIOR","deep_conversion_behavior_spec":{"bid_amount":200}}' \
--data-urlencode 'poi_list=[]' \
--data-urlencode 'bid_adjustment={
"site_set_package": [
{
"site_set": [
"SITE_SET_QZONE"
]
}
],
"region_group_package": [
{
"region_list": []
}
]
}' \
--data-urlencode 'custom_adgroup_tag=[]' \
--data-urlencode 'smart_targeting={
"start_audience": [],
"unbreakable_targeting": {
"age": [],
"gender": [],
"geo_location": {
"location_types": [],
"regions": [],
"business_districts": [],
"custom_locations": []
},
"user_os": [],
"app_install_status": [],
"excluded_converted_audience": {
"conversion_behavior_list": []
}
}
}' \
--data-urlencode 'dynamic_creative_id_set=[]'
响应示例响应示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"adgroup_id": "<ADGROUP_ID>"
}
}
请求参数
Header 参数
access_token
string
必需
默认值:
<ACCESS_TOKEN>
timestamp
string
必需
MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8,例如当时间戳为1494840119时,表示 2018-05-15 17:21:59
默认值:
<TIMESTAMP>
nonce
string
必需
默认值:
<NONCE>
Body 参数application/x-www-form-urlencoded
account_id
integer
必需
示例值:
<ACCOUNT_ID>
campaign_id
integer
推广计划 id
示例值:
<CAMPAIGN_ID>
adgroup_name
string
必需
字段长度最小 1 字节,长度最大 180 字节
示例值:
推广广告
promoted_object_type
string
必需
枚举列表:{ PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_QUICK_APP, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_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_WECHAT_OFFICIAL_ACCOUNT }
示例值:
PROMOTED_OBJECT_TYPE_LINK
begin_date
string
必需
字段长度为 10 字节
示例值:
2017-04-25
end_date
string
必需
字段长度最小 0 字节,长度最大 10 字节
示例值:
2017-05-01
billing_event
string
可选
枚举列表:{ BILLINGEVENT_CLICK, BILLINGEVENT_APP_DOWNLOAD, BILLINGEVENT_IMPRESSION }
示例值:
BILLINGEVENT_CLICK
bid_amount
string
可选
CPC 出价限制:介于 10 分-10,000 分之间(0.1 元-100 元,单位为人民币)
CPM 出价限制:介于 150 分-99,900 分之间(1.5 元-999 元,单位为人民币,当 SITE_SET 仅为 SITE_SET_PCQQ 时,介于 50 分-99,900 分之间)
CPA 出价限制:介于 100 分-50,000 分之间(1 元-500 元,单位为人民币)
oCPC/oCPM 出价限制:介于 1 分-500,000 分之间(0.01 元-5000 元,单位为人民币)
示例值:
200
optimization_goal
string
可选
可投放的优化目标组合可通过 optimization_goal_permissions/get 接口查询;
微信流量不允许更改优化目标,非微信流量仅允许在 CPC 切换 oCPC,CPM 切换 oCPM 时更改优化目标,[枚举详情]
枚举列表:{ OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_PHONE_CALL, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZATIONGOAL_LOW_PRICE_COURSE, OPTIMIZATIONGOAL_CONSULT_INTENTION, OPTIMIZATIONGOAL_EVERY_DAY_RETENTION, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE_UV, OPTIMIZATIONGOAL_LIVE_STREAM_DURATION_1MIN, OPTIMIZATIONGOAL_LIVE_STREAM_INTERACTION, OPTIMIZATIONGOAL_ECOMMERCE_CANCEL_ORDER }
示例值:
OPTIMIZATIONGOAL_CLICK
time_series
string
必需
字段长度为 336 字节
示例值:
010100100110100010101010010101010101010100101010101010010101010101001010101010100101010101010111110010101001010110110100110001011001010100101010101010110011001010101010100101100101101110101010101010100110100110010100110101110111101110110110110110110110101101101101110110011101011101101011101101101101001010110111010111011010110110111011
site_set
string
可选
数组最小长度 1,最大长度 32
枚举列表:{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_MYAPP, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_KUAISHOU, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_MOBILE_YYB, SITE_SET_QQSHOPPING, SITE_SET_CHANNELS, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN, SITE_SET_FREETRADE, SITE_SET_QBSEARCH, SITE_SET_FREETRADE_FINDER, SITE_SET_BROWSER_MOBILE, SITE_SET_SEARCH_SCENE, SITE_SET_BROWSER_PC, SITE_SET_CHANNELS_CONTENT_PROMOTION, SITE_SET_FREETRADE_WEAPP }
示例值:
["SITE_SET_QZONE"]
daily_budget
integer
可选
日预算要求介于 5,000 分– 4,000,000,000 分之间(50 元-40,000,000 元,单位为人民币)
每次修改幅度不能低于当前日预算加上 5000 分(50 元,单位为人民币)
每次修改幅度不能低于当前日预算加上 5,000 分(50 元,单位为人民币)
示例值:
10000
targeting_id
integer
可选
示例值:
111111111
scene_spec
string
场景定向
示例值:
{"mobile_union":["MOBILE_UNION_IN_WECHAT"]}
configured_status
string
可选
枚举列表:{ AD_STATUS_NORMAL, AD_STATUS_SUSPEND }
默认值:该字段默认值 AD_STATUS_NORMAL
示例值:
AD_STATUS_NORMAL
customized_category
string
可选
字段长度最小 0 字节,长度最大 200 字节
示例值:
本地生活,餐饮
user_action_sets
string
可选
数组最小长度 1,最大长度 100
示例值:
[]
additional_user_action_sets
string
可选
当 promoted_object_type 为 PROMOTED_OBJECT_TYPE_ECOMMERCE、PROMOTED_OBJECT_TYPE_LINK、PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM,且行业为网服、电商、金融的广告主,可填写补充的 app 用户行为数据源。数据源需为安卓/ios 数据源,且需确保为同一个 app 的数据源。
数组最小长度 0,最大长度 100
示例值:
[]
cold_start_audience
integer
可选
1、系统会学习您选择的人群包数据,帮助提升广告投放效果;
2、当且仅当广告为 oCPC/oCPM 开启自动扩量的广告、且投放的流量不是应用宝时;
3、仅支持人群类型为 CUSTOMER_FILE(号码文件人群)的可用人群 id、且人群数量大于 100 时;
数组最大长度 10
示例值:
[1024]
expand_enabled
string
可选
可选值:{ true, false }
示例值:
false
expand_targeting
string
可选
目前仅支持年龄、性别、地域、学历(不可突破学历仅教育行业可使用)定向设置为不可突破(前置需要定向 targeting 层级使用了年龄、性别、地域、学历时 不可突破才可以选择相对应的值)。
数组最小长度 0,最大长度 4
可选值:{ age, gender, geo_location, education }
示例值:
[]
deep_conversion_spec
string
可选
深度优化不可取消,也不支持在编辑环节从未使用深度优化切换为使用深度优化。
示例值:
{"deep_conversion_type":"DEEP_CONVERSION_BEHAVIOR","deep_conversion_behavior_spec":{"bid_amount":200}}
poi_list
string
可选
1.
2.
3.
数组最小长度 0,最大长度 500
字段长度最小 0 字节,长度最大 64 字节
示例值:
[]
bid_adjustment
string
可选
示例值:
{
"site_set_package": [
{
"site_set": [
"SITE_SET_QZONE"
]
}
],
"region_group_package": [
{
"region_list": []
}
]
}
custom_adgroup_tag
string
可选
数组最小长度 0,最大长度 10
字段长度最小 0 字节,长度最大 1024 字节
示例值:
[]
smart_targeting
string
可选
智能定向功能与自动扩量/系统优选相关字段不可同时设置。2022 年 6 月 30 日起,智能定向无法与行为兴趣意向、“二方人群”人群包同时使用
示例值:
{
"start_audience": [],
"unbreakable_targeting": {
"age": [],
"gender": [],
"geo_location": {
"location_types": [],
"regions": [],
"business_districts": [],
"custom_locations": []
},
"user_os": [],
"app_install_status": [],
"excluded_converted_audience": {
"conversion_behavior_list": []
}
}
}
dynamic_creative_id_set
integer
可选
数组最小长度 1,最大长度 20
示例值:
[]
返回响应
修改于 2023-11-06 02:26:27