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

广告创意

本节将为您介绍广告创意。

广告创意由创意形式、创意元素、广告版位等多个属性组成,创意形式定义了每一个创意包含什么元素,并与广告版位属性一起,决定了当前创意会在具体哪些位置进行展示。Marketing API 目前支持的创意形式包括文字链创意、图片创意、图文创意、视频创意等多种形式。由于在腾讯不同流量推广不同推广目标时,可以使用的创意形式会有差异,您可以针对您想推广的广告版位(site_set)和推广目标类型(product_type)属性,通过 创意形式查询工具 或者创意形式查询接口(adcreative_templates/get)查询可投放的创意形式。

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

    • 所属推广计划(campaign_id):每个广告创意都需要归属于某个推广计划;
    • 推广目标类型(product_type):当前限制广告创意的推广目标类型必须与所属 campaign 的一致;
    • 推广目标id(product_refs_id):声明广告创意要推广的具体是哪个推广目标id,对于app下载类广告(腾讯开放平台移动应用、苹果应用)、微信朋友圈本地门店广告必填。广告创意上的推广目标id要与所属推广计划的推广目标类型匹配,如推广计划上的推广目标类型为iOS应用,则广告创意上的推广目标id必须是苹果appstore上的iOS应用id,详见【推广目标】章节介绍。对于微信朋友圈本地门店推广,同一个推广计划下的广告创意必须使用相同的门店id;
    • 广告版位(site_set):用于指定广告创意投放在什么流量上,详见【广告版位】章节介绍;
    • 创意形式id(adcreative_template_id):每个广告创意都需要指定一个创意形式,创意形式必须符合广告创意上设置的广告版位(site_set)和推广目标类型(product_type)属性;
    • 创意元素(adcreative_elements):创意元素包含创意最终展示给用户的信息,如图片、文案等,不同的创意形式所需的创意元素不同,需根据广告创意指定的创意形式id进行设置;
    • 应用直达地址(deep_link):用于指定点击广告后“直接到达”客户“应用”内的落地页地址,详见【应用直达】章节介绍;
    不同广告版位以及商品类型下,可投放的创意形式id和对应的创意元素结构可通过 创意形式查询工具 或者创意形式查询接口(adcreative_templates/get)进行查询。

请求示例


curl 'https://api.e.qq.com/v1.1/adcreatives/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'campaign_id=<CAMPAIGN_ID>' \
-d 'adcreative_name=广告创意' \
-d 'adcreative_template_id=<ADCREATIVE_TEMPLATE_ID>' \
-d 'adcreative_elements={"image":"123456"}' \
-d 'promoted_object_type=PROMOTED_OBJECT_TYPE_LINK_WECHAT' \
-d 'page_type=PAGE_TYPE_DEFAULT' \
-d 'site_set=["SITE_SET_WECHAT"]' \
-d 'page_spec={"page_url":"https://www.example.com"}' \
-d 'link_page_spec={
    "mini_program_spec": {
        "mini_program_paths": []
    },
    "mini_game_spec": [],
    "channels_shop_product_spec": []
}' \
-d 'share_content_spec=[]' \
-d 'video_end_page=[]' \
-d 'floating_zone={
    "floating_zone_jump_info": [
        {
            "page_spec": {
                "page_url": "https://www.example.com"
            },
            "page_type": "PAGE_TYPE_DEFAULT",
            "landing_page_info": [],
            "media_query": []
        }
    ]
}' \
-d 'head_click_spec=[]' \
-d 'barrage_list=[]' \
-d 'app_gift_pack_code={
    "code": 0
}' \
-d 'union_market_spec=[]' \
-d 'android_quick_app_spec=[]' \
-d 'wechat_channels_tracking_spec={
    "promoted_object_type": "PROMOTED_OBJECT_TYPE_LINK_WECHAT"
}' 
					

关于广告创意更详细的接口介绍,可参考 接口清单-adcreatives