创意形式
本节将为您介绍如何通过 Marketing API 查询可使用的创意形式信息。
Marketing API为您提供微信（包含朋友圈、微信公众号、小程序等）、移动内部广告版位（包含手机QQ、QQ浏览器、应用宝等）、腾讯新闻、腾讯视频、天天快报、移动联盟等多个广告版位的流量，由于在腾讯不同流量推广不同推广目标时，可以使用的创意形式会有差异，所以除了为您提供创意形式查询工具外，Marketing API还为您提供的获取创意形式信息接口（adcreative_templates/get）来获取创意形式相关的信息。
通过获取创意形式信息接口，您可以针对您想推广的广告版位（site_set）和推广目标类型（product_type）查询可投放的创意形式id列表，同时可以获取到创意形式id对应的创意形式介绍、创意形式示意图、创意形式元素信息、创意形式属性信息、创意形式出价类型以及底价信息。对应的请求示例如下：
请求示例
curl -G 'https://api.e.qq.com/v1.1/adcreative_templates/get?access_token=<ACCESS_TOKEN>×tamp=<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_cn": "",
"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
}
}
}