创建新投放广告

1. 新投放广告概述

新版腾讯广告投放平台，进行了广告投放的重新设计，以更精简高效的投放体验支持完整的营销内容表达。并且进行系统全面升级，以更稳定的系统优化，打破“卷基建”的起量玄学。
新版本功能包括：
● 投放层级精简，由原有的“计划-广告-创意” 3 层结构简化为“广告-创意” 2 层结构
● 贴近行业经营的投放表达，通过营销目的代替推广目标，更精细化刻画行业的生意经营
● 明确投放导向，新建广告环节增加“卷基建”判断，杜绝无序创建，聚合转化数据以提升拿量效果
为适配新投放场景，MKTAPI 升级为新投放版本，支持开发者更容易、更便捷地进行广告创编和资产管理，广告维度做了以下核心升级：

开发文档 | 开发者专区 - 腾讯广告

2. 如何创建广告

在通过 API 创建广告的过程中，需要通过 adgroups/add 接口，请求参数需要完成 5 部分内容（营销内容、广告版位设置、定向、出价与预算、广告设置）设置来获得 adgroup_id 新广告应答字段，完成广告创建；
创建广告接口文档：开发文档 | 开发者专区 - 腾讯广告

2.1 营销内容

营销内容主要包含四部分，分别为营销目的（MARKETING_GOAL）、营销载体（MARKETING_CARRIER_TYPE）、推广内容（MARKETING_ASSET_ID）、优化目标（OPTIMIZATIONGOAL），以下分别介绍如何通过 MKTAPI 创建/获取上述四种营销内容：

营销内容	字段	介绍	投放端截图（以游戏行业为例）
营销目的	MARKETING_GOAL	用于表达广告主实际的投放目的
营销载体	MARKETING_CARRIER_TYPE	营销载体是推广产品的承载方，是落地页类型的聚类，是需要归因数据和触达的中间载体。
推广内容	MARKETING_TARGET_TYPE（推广内容类型） MARKETING_ASSET_ID（推广产品 id）	推广内容类型：是指本次投放推广的标的物类型，如应用、商品、服务、活动等 推广产品 id：是指本次投放推广的标的物具体的 id，入商品 id、应用 id 等
优化目标	OPTIMIZATIONGOAL	优化目标是指本次投放要优化的转化动作，如关注、下单、付费、线索收集等

（1）营销目的（MARKETING_GOAL）
营销目的是用于表达广告主实际的投放目的，不同行业支持选择的营销目的不同，目前支持的营销目的如下：
注：已游戏应用为例，支持的一级营销目的为用户增长（MARKETING_GOAL_USER_GROWTH），支持的二级营销目的为新游预约（MARKETING_SUB_GOAL_NEW_GAME_RESERVE）、新游测试（MARKETING_SUB_GOAL_NEW_GAME_TEST）、新游首发（MARKETING_SUB_GOAL_NEW_GAME_LAUNCH）、平推期投放（MARKETING_SUB_GOAL_PLATEAU_PHASE_LAUNCH），具体行业的选择可根据各行业新投放指引进行选择

一级营销目的	一级营销目的字段	说明	二级营销目的	二级营销目的字段
线索留资	MARKETING_GOAL_LEAD_RETENTION	收集意向客户商机，开发潜在客户	暂无	暂无
加粉互动	MARKETING_GOAL_INCREASE_FANS_INTERACTION	广公众号、视频号等生态帐号，带来更多粉丝与互动
品牌宣传	MARKETING_GOAL_LEAD_RETENTION	扩大品牌影响力，吸引更多用户参与活动
商品销售	MARKETING_GOAL_PRODUCT_SALES	推广商品、服务，带来更多的客户和订单
用户增长	MARKETING_GOAL_USER_GROWTH	推广线上应用、小程序等获取更多用户的激活与长期价值	/	/
			新游预约	MARKETING_SUB_GOAL_NEW_GAME_RESERVE
			新游测试	MARKETING_SUB_GOAL_NEW_GAME_TEST
			新游首发	MARKETING_SUB_GOAL_NEW_GAME_LAUNCH
			平推期投放	MARKETING_SUB_GOAL_PLATEAU_PHASE_LAUNCH
			新客增长	MARKETING_SUB_GOAL_MINI_GAME_NEW_CUSTOMER_GROWTH
			回流触达	MARKETING_SUB_GOAL_MINI_GAME_RETURN_CUSTOMER_ENGAGEMENT
			应用拉新	MARKETING_SUB_GOAL_APP_ACQUISITION
			应用拉活	MARKETING_SUB_GOAL_APP_ACTIVATION

（2）营销载体（MARKETING_CARRIER_TYPE）
营销载体是推广产品的承载方，是落地页类型的聚类，是需要归因数据和触达的中间载体，具体类型如下：

（3）推广内容
推广内容包括推广内容类型（MARKETING_TARGET_TYPE）和推广产品 id（MARKETING_ASSET_ID），定义如下：
➢ 推广内容类型：是指本次投放推广的标的物类型，如应用、商品、服务、活动等
➢ 推广产品 id：是指本次投放推广的标的物具体的 id，入商品 id、应用 id 等
推广内容资产的获取通过下面方式实现：
➢ 创建广告时，可通过获取可投放推广内容资产类型名称（marketing_target_types/get）接口查询可投放的推广内容类型、可通过获取可投放推广内容资产相关信息（marketing_target_assets/get）接口查询可投放的推广产品 id（MARKETING_ASSET_ID）以及所属的产品属性，注意：推广内容资产相关信息（marketing_target_assets/get）接口仅支持查询非通用类资产
➢ 通用类资产（app、小程序、小游戏、视频号、公众号、商品等）通过 adgroup 创建时marketing_asset_outer_spec 表达
注：推广内容类型（MARKETING_TARGET_TYPE）为 电商商品（MARKETING_TARGET_TYPE_CONSUMER_PRODUCT）时，marketing_asset_outer_spec 通过** 获取商品库接口（product_catalogs/get）&获取商品接口（product_items/get）获取对应商品库 id（product_catalog_id）和商品 id（product_outer_id）**

除了上述提到的两个接口外，同时支持对推广内容资产管理，支持在 业务单元维度 进行资产创建/更新/删除：

商品相关接口：

（4）优化目标
在选择优化目标时，不同营销目的、营销载体、版位、出价方式 可选择的优化目标存在差异，可通过 optimization_goal_permissions/get 接口 获取可投放的优化目标组合，当支持的优化目标枚举如下：

2.2 广告版位设置

腾讯广告平台拥有的流量资源包括：微信视频号、微信朋友圈、微信公众号与小程序、腾讯平台与内容媒体、优量汇、微信搜一搜、QQ 浏览器等，关于各流量广告版位（site_set）的完整介绍，可以通过 这里 进行了解。
自动版位（automatic_site_enabled）：自动版位是基于腾讯广告全域流量视角，结合多样化素材适配与智能优化策略，帮助广告主达到更优投放效率与拿量效果的一站式投放产品，详细介绍可见：腾讯广告 | 帮助中心，模式枚举如下：

选择特定版位投放：区别于【自动版位】，【选择特定版位】允许广告主指定主要投放的流量版位，帮助广告主更灵活地满足特定营销场景，详细介绍可见:腾讯广告 | 帮助中心，Marketing API 目前支持投放的广告版位枚举及定义见：

由于每个广告版位上可能有多个位置资源可以投放广告，具体您的广告会出现在指定广告版位上哪一个位置，会由广告创意上的创意形式来决定。详情参见 【业务专题】如何创建创意章节。

2.3 定向

2.4 出价与预算

1. 出价
   通过开发文档 | 开发者专区 - 腾讯广告获取出价方式、策略等枚举值进行投放
   广告的出价由优化目标（optimization_goal）、扣费方式（bid_mode）和 出价金额（bid_amount）共同决定。Marketing API 当前支持多种优化目标，不同的优化目标可选择的出价方式不同，两者的对应关系如下所示：

选择广告的出价方式后，您还需要设置广告的具体出价金额（bid_amount），且您在创建或修改广告的时候出价必须符合限制，否则会报错，具体的出价限制如下：

1. CPC 出价限制：介于 10 分-10,000 分之间（0.1 元-100 元，单位为人民币）

2. CPM 出价限制：介于 150 分-99,900 之间（1.5 元-999 元，单位为人民币）

3. CPA 出价限制：介于 100 分-10,000 分之间（1 元-100 元，单位为人民币）

4. oCPC/oCPM 出价限制：介于 10 分-500,000 分之间（0.1 元-5000 元，单位为人民币）
   注：
   （1）3.0 和 2.0 出价场景的变化如下：

2.0 现存出价场景	3.0 是否支持	交互举例【以双目标（roi 类）产品投放端出价表达举例， 单目标等其他场景类似】
单目标场景	是
单目标场景（助攻类）	是
双目标（常规）	大部分场景支持，小部分场景会予以下线
双目标（次留类）	是
双目标（roi 类）	是
双目标（小游戏两阶段出价）	予以下线
深度辅助优化（广告主出价部分）	原产品需升级到双目标常规类产品
深度辅助优化（广告主不出价部分）	是

（2）3.0 和 2.0 非游戏行业出价类型变化如下：（注：2.0 中出价策略在 3.0 中已经不再支持）

2.0 现存出价类型	3.0 是否支持	交互举例【以双目标（roi 类）产品投放端出价表达举例， 单目标等其他场景类似】
手动出价	是，3.0 名称为稳定拿量	2.0 交互3.0 交互
最大转化量投放	是
控制成本上限	暂不支持

（3）3.0 和 2.0 游戏行业投放场景变化如下：

2.0 现存出价类型	3.0 是否支持	交互举例【以双目标（roi 类）产品投放端出价表达举例， 单目标等其他场景类似】
常规投放-稳定投放	是，3.0 名称为常规投放	2.0 交互3.0 交互
常规投放-放量投放	否
最大转化量投放	是

（4）3.0 中最大转化量支持

2. 预算
   日预算（daily_budget）：设置日预算后，一旦广告组的今日消耗到达设置的值，则广告组下所有广告将被暂停曝光，第二天自动恢复；您也可以通过修改广告组将日预算数值提高，之后广告将恢复正常曝光；

2.5 广告设置

支持设置投放日期（begin_date、end_date）、投放时间（first_day_begin_time、time_series）、广告名称（adgroup_name）

2.6 唯一性约束说明

新投放对广告唯一性有明确的限制，新建广告环节增加“卷基建”判断，杜绝无序创建，聚合转化数据以提升拿量效果，不同行业唯一性限制条件不同，主要通过推广内容和定向进行约束；
（1）唯一性规则
客户创建不同广告时，唯一性字段不能全都一致，否则会创建失败
（2）唯一性字段

具体分行业唯一性规则参考分行业唯一性校验说明(截止到 0330)

2.7 广告状态

客户自设状态（configured_status）：客户可修改状态，可以是正常或暂停两种，用于客户自行控制广告组是否启用投放；

2.8 广告转化

用户行为数据源（user_action_sets）：将用户行为数据源绑定至广告组，会对广告组下所有广告生效，在广告开启转化归因开关（conversion_tracking_enabled）的情况下，user_action_sets 将用于该广告的转化归因，详见 开发文档 | 开发者专区 - 腾讯广告专题介绍。
同时监测服务也更新的 新投放的概念变化，如下：
点击监测：https://datanexus.qq.com/doc/develop/guider/interface/conversion/ad_track_click
曝光监测：https://datanexus.qq.com/doc/develop/guider/interface/conversion/ad_track_impress

3. MKTAPI3.0 创建广告使用流程

1. 获取可投放推广内容资产相关信息
   通过 开发文档 | 开发者专区 - 腾讯广告 接口获取广告主期望投放的行业资产 id(marketing_asset_id)
   

   curl -v -G 'https://api.e.qq.com/v3.0/marketing_target_assets/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \ 
   -d 'account_id=<ACCOUNT_ID>' \ 
   -d 'page=1' \ 
   -d 'page_size=10'
   

2. 广告组创建
   通过 开发文档 | 开发者专区 - 腾讯广告 接口，分别对营销表达，版位、出价、预算与排期、优化目标与定向等多个部分组成进行设置，同时将行业资产 id(marketing_asset_id)传入。
   

   curl 'https://api.e.qq.com/v3.0/adgroups/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \ 
   -H 'Content-Type: application/json' \ 
   -d '{
       "account_id": "<ACCOUNT_ID>",
       "adgroup_name": "推广广告",
       "marketing_carrier_detail": [],
       "begin_date": "2017-04-25",
       "end_date": "2017-05-01",
       "bid_amount": 200,
       "optimization_goal": "OPTIMIZATIONGOAL_CLICK",
       "time_series": "010100100110100010101010010101010101010100101010101010010101010101001010101010100101010101010111110010101001010110110100110001011001010100101010101010110011001010101010100101100101101110101010101010100110100110010100110101110111101110110110110110110110101101101101110110011101011101101011101101101101001010110111010111011010110110111011",
       "site_set": [
           "SITE_SET_QZONE"
       ],
       "daily_budget": 10000,
       "targeting": {
           "geo_location": {
               "location_types": [],
               "regions": [],
               "business_districts": [],
               "custom_locations": []
           },
           "gender": [],
           "age": [],
           "education": [],
           "app_install_status": [],
           "marital_status": [],
           "excluded_converted_audience": {
               "conversion_behavior_list": []
           },
           "custom_audience": [],
           "excluded_custom_audience": [],
           "device_brand_model": {
               "included_list": [],
               "excluded_list": []
           },
           "user_os": [],
           "network_type": [],
           "device_price": [],
           "wechat_ad_behavior": {
               "actions": [],
               "excluded_actions": []
           },
           "game_consumption_level": [],
           "excluded_os": []
       },
       "scene_spec": {
           "mobile_union": [
               "MOBILE_UNION_IN_WECHAT"
           ]
       },
       "user_action_sets": [],
       "deep_conversion_spec": {
           "deep_conversion_type": "DEEP_CONVERSION_BEHAVIOR",
           "deep_conversion_behavior_spec": {
               "bid_amount": 200
           }
       },
       "configured_status": "AD_STATUS_NORMAL",
       "marketing_asset_outer_spec": [],
       "poi_list": [],
       "priority_site_set": [],
       "mpa_spec": {
           "recommend_method": []
       }
   }'
   

   
   

3. 广告组更新
   通过 开发文档 | 开发者专区 - 腾讯广告 接口，分别对出价、预算与排期、定向等多个部分组成进行更新。
   

   
   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": "2017-04-25",
       "end_date": "2017-05-01",
       "bid_amount": 200,
       "optimization_goal": "OPTIMIZATIONGOAL_CLICK",
       "time_series": "010100100110100010101010010101010101010100101010101010010101010101001010101010100101010101010111110010101001010110110100110001011001010100101010101010110011001010101010100101100101101110101010101010100110100110010100110101110111101110110110110110110110101101101101110110011101011101101011101101101101001010110111010111011010110110111011",
       "daily_budget": 10000,
       "targeting": {
           "geo_location": {
               "location_types": [],
               "regions": [],
               "business_districts": [],
               "custom_locations": []
           },
           "gender": [],
           "age": [],
           "education": [],
           "app_install_status": [],
           "marital_status": [],
           "excluded_converted_audience": {
               "conversion_behavior_list": []
           },
           "custom_audience": [],
           "excluded_custom_audience": [],
           "device_brand_model": {
               "included_list": [],
               "excluded_list": []
           },
           "user_os": [],
           "network_type": [],
           "device_price": [],
           "wechat_ad_behavior": {
               "actions": [],
               "excluded_actions": []
           },
           "game_consumption_level": [],
           "excluded_os": []
       },
       "scene_spec": {
           "mobile_union": [
               "MOBILE_UNION_IN_WECHAT"
           ]
       },
       "user_action_sets": [],
       "deep_conversion_spec": {
           "deep_conversion_type": "DEEP_CONVERSION_BEHAVIOR",
           "deep_conversion_behavior_spec": {
               "bid_amount": 200
           }
       },
       "configured_status": "AD_STATUS_NORMAL",
       "poi_list": []
   }'
   

4. 查询广告组
   通过 开发文档 | 开发者专区 - 腾讯广告 接口单点或批量查询广告详情。
   

   curl -v -G 'https://api.e.qq.com/v3.0/adgroups/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \ 
   -d 'account_id=<ACCOUNT_ID>' \ 
   -d 'fields=["adgroup_id","adgroup_name","configured_status","daily_budget","created_time","marketing_scene","last_modified_time","is_deleted"]' \ 
   -d 'filtering=[{"field":"last_modified_time","operator":"GREATER_EQUALS","values":["1708520382"]},{"field":"last_modified_time","operator":"LESS_EQUALS","values":["1708568262"]}]' \ 
   -d 'is_deleted=false' \ 
   -d 'page=1' \ 
   -d 'page_size=10' 
   

5. 删除广告组
   通过 开发文档 | 开发者专区 - 腾讯广告 接口执行对广告的删除。
   

   curl 'https://api.e.qq.com/v3.0/adgroups/delete?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \ 
   -H 'Content-Type: application/json' \ 
   -d '{
       "account_id": "<ACCOUNT_ID>",
       "adgroup_id": "<ADGROUP_ID>"
   }'