入门与指南专题介绍帐号管理营销资产广告管理数据洞察人群管理数据接入接口清单
授权认证 帐号管理 营销资产 广告管理 数据洞察 辅助工具 用户行为数据 用户人群数据 用户标签数据 用户属性数据
附录

创意规格

本节将为您介绍如何通过 Marketing API 查询可使用的创意规格信息。

Marketing API为您提供微信(包含朋友圈、微信公众号、小程序等)、移动内部站点(包含手机QQ、QQ浏览器、应用宝等)、腾讯新闻、腾讯视频、天天快报、移动联盟等多个站点的流量,由于在腾讯不同流量推广不同推广目标时,可以使用的创意规格会有差异,所以除了为您提供创意规格查询工具外,Marketing API还为您提供的获取创意规格信息接口(V1.1:adcreative_templates/get;V1.0:adcreative_template_info/get)来获取创意规格相关的信息。

通过获取创意规格信息接口,您可以针对您想推广的站点(site_set)和推广目标类型(product_type)查询可投放的创意规格id列表,同时可以获取到创意规格id对应的规格介绍、规格示意图、规格元素信息、规格属性信息、规格出价类型以及底价信息。对应的请求示例如下:


curl -G 'https://api.e.qq.com/v1.1/adcreative_templates/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[{"field":"adcreative_template_id","operator":"EQUALS","values":[69]}]' \
-d 'page=1' \
-d 'page_size=10' 
					

{
    "code": 0,
    "message": "",
    "message_ch": "",
    "data": {
        "list": [
            {
                "promoted_object_type": "PROMOTED_OBJECT_TYPE_LINK",
                "adcreative_template_id": 69,
                "ad_attributes": [
                    {
                        "enum_property": [],
                        "array_property": [],
                        "struct_property": [],
                        "name": "impression_tracking_url",
                        "element_type": "ELEMENT_TYPE_URL",
                        "field_type": "FIELD_TYPE_STRING",
                        "required": false,
                        "description": "请输入曝光监测 URL(可选)",
                        "parent_name": "",
                        "restriction": {
                            "url_restriction": {
                                "url_pattern": "^https?:\\/\\/([a-zA-Z0-9\\-]+\\.)+([a-zA-Z]{2,5})([\\/\\?#][a-zA-Z0-9`~!@#%&_=;\\$\\^\\*\\(\\)\\-\\+\\{\\}\\[\\]\\:\\,\\.\\?\\/\\|]*)?$"
                            }
                        }
                    },
                    {
                        "enum_property": [],
                        "array_property": [],
                        "struct_property": [],
                        "name": "click_tracking_url",
                        "element_type": "ELEMENT_TYPE_URL",
                        "field_type": "FIELD_TYPE_STRING",
                        "required": false,
                        "description": "请输入点击监测 URL(可选)",
                        "parent_name": "",
                        "restriction": {
                            "url_restriction": {
                                "url_pattern": "^https?:\\/\\/([a-zA-Z0-9\\-]+\\.)+([a-zA-Z]{2,5})([\\/\\?#][a-zA-Z0-9`~!@#%&_=;\\$\\^\\*\\(\\)\\-\\+\\{\\}\\[\\]\\:\\,\\.\\?\\/\\|]*)?$"
                            }
                        }
                    }
                ],
                "adcreative_elements": [
                    {
                        "enum_property": [],
                        "array_property": [],
                        "struct_property": [],
                        "name": "image",
                        "element_type": "ELEMENT_TYPE_IMAGE",
                        "field_type": "FIELD_TYPE_STRING",
                        "required": true,
                        "description": "图片",
                        "parent_name": "",
                        "restriction": {
                            "image_restriction": {
                                "width": 72,
                                "height": 72,
                                "file_size": 30,
                                "file_format": [
                                    "IMAGE_TYPE_JPG",
                                    "IMAGE_TYPE_PNG"
                                ]
                            }
                        }
                    },
                    {
                        "enum_property": [],
                        "array_property": [],
                        "struct_property": [],
                        "name": "title",
                        "element_type": "ELEMENT_TYPE_TEXT",
                        "field_type": "FIELD_TYPE_STRING",
                        "required": true,
                        "description": "广告文案",
                        "parent_name": "",
                        "restriction": {
                            "text_restriction": {
                                "min_length": 1,
                                "max_length": 14
                            }
                        }
                    },
                    {
                        "enum_property": [],
                        "array_property": [],
                        "struct_property": [],
                        "name": "description",
                        "element_type": "ELEMENT_TYPE_TEXT",
                        "field_type": "FIELD_TYPE_STRING",
                        "required": true,
                        "description": "广告描述",
                        "parent_name": "",
                        "restriction": {
                            "text_restriction": {
                                "min_length": 1,
                                "max_length": 14
                            }
                        }
                    },
                    {
                        "enum_property": [],
                        "array_property": [],
                        "struct_property": [],
                        "name": "phone",
                        "element_type": "ELEMENT_TYPE_TEXT",
                        "field_type": "FIELD_TYPE_STRING",
                        "required": false,
                        "description": "请输入电话号码(可选)",
                        "parent_name": "",
                        "restriction": []
                    }
                ],
                "adcreative_sample_image_list": [
                    {
                        "name": "移动 Banner 广告位",
                        "image": "http://qzonestyle.gtimg.cn/gdt_ui_proj/dist/gdt/imgbox/lm_bannner_72x72.png"
                    }
                ],
                "adcreative_template_name": "移动 Banner",
                "adcreative_template_description": "Banner 广告位",
                "adcreative_template_size": "72 × 72",
                "adcreative_template_style": "单图(文)",
                "site_set": "SITE_SET_MOBILE_INNER",
                "adcreative_attributes": [
                    {
                        "enum_property": [],
                        "array_property": [],
                        "struct_property": [],
                        "name": "deep_link_url",
                        "element_type": "ELEMENT_TYPE_URL",
                        "field_type": "FIELD_TYPE_STRING",
                        "required": false,
                        "description": "应用直达(可选)",
                        "parent_name": "",
                        "restriction": {
                            "url_restriction": {
                                "url_pattern": "^((?!https?)([a-zA-Z0-9_\\-\\.])+):\\/\\/([a-zA-Z0-9_\\-\\?]+\\.?)+([a-zA-Z0-9`~!@#%&_=;\\$\\^\\*\\(\\)\\-\\+\\{\\}\\[\\]\\:\\,\\.\\?\\/\\|\\u4e00-\\u9fa5]*)?$"
                            }
                        }
                    }
                ],
                "support_billing_spec_list": [
                    {
                        "billing_event": "BILLINGEVENT_CLICK",
                        "min_price": 10,
                        "max_price": 10000
                    }
                ]
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}