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

f

广告组

本节将为您介绍广告组的基本组成。

广告组是推广流程中最核心的单元,包含投放时间、具体推广目标、投放广告版位、出价等信息。一个推广计划下可以有多个广告组。

创建一个广告组,除了广告组名称,您还可能需要设置以下属性:

    • 所属推广计划(campaign_id):每个广告组都需要归属于某个推广计划;
    • 推广目标类型(product_type):当前限制广告组的推广目标类型必须与所属 campaign 的一致;
    • 推广目标id(product_refs_id):声明广告要推广的具体是哪个推广目标id,对于app下载类广告(腾讯开放平台移动应用、苹果应用)、微信朋友圈本地门店广告必填。广告组上的推广目标id要与所属推广计划的推广目标类型匹配,如推广计划上的推广目标类型为iOS应用,则广告组的推广目标id必须是苹果appstore上的iOS应用id,详见【推广目标】章节介绍。对于微信朋友圈本地门店推广,同一个推广计划下的广告组必须使用相同的门店id;
    • 广告版位(site_set):用于指定广告投放在什么流量上,详见【广告版位】章节介绍;
    • 定向条件(targeting):用于指定该广告投放给哪些人,详见【定向】章节介绍;
    • 优化目标(optimization_goal)、计费方式(billing_event)和价格(bid_amount):设置广告的优化目标与出价相关信息,详见【出价】章节介绍;
    • 日预算(daily_budget):设置日预算后,一旦广告组的今日消耗到达设置的值,则广告组下所有广告将被暂停曝光,第二天自动恢复;您也可以通过修改广告组将日预算数值提高,之后广告将恢复正常曝光;
    • 客户自设状态(configured_status):客户可修改状态,可以是正常或暂停两种,用于客户自行控制广告组是否启用投放;
    • 用户行为数据源(user_action_sets):将用户行为数据源绑定至广告组,会对广告组下所有广告生效,在广告开启转化归因开关(conversion_tracking_enabled)的情况下,user_action_sets 将用于该广告的转化归因,详见 【转化归因】专题介绍。

请求示例


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 'priority_site_set=[]' \
-d 'daily_budget=10000' \
-d 'targeting_id=111111111' \
-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}}' \
-d 'poi_list=[]' \
-d 'bid_adjustment={
    "site_set_package": [
        {
            "site_set": [
                "SITE_SET_QZONE"
            ]
        }
    ],
    "region_group_package": [
        {
            "region_list": []
        }
    ]
}' \
-d 'custom_adgroup_tag=[]' \
-d '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": []
        }
    }
}' \
-d 'dynamic_creative_id_set=[]' 
					

关于广告组更详细的接口介绍,可参考 接口清单-adgroups