{"_id":"56fd44d84388650e00eb4774","parentDoc":null,"version":{"_id":"56c35c56c0c4630d004e864f","project":"56c35c56c0c4630d004e864c","__v":8,"createdAt":"2016-02-16T17:28:54.864Z","releaseDate":"2016-02-16T17:28:54.864Z","categories":["56c35c57c0c4630d004e8650","56c7b9e5379b311700ed8fe3","56c7bab4606ee717003c4766","56c7bb3613e5400d001e8cbd","56cf3f5a5267d70b00494c4b","56cf3f866c5d7a13005ee894","56fd3956caad892200847bce","599da256e7742b002588bb02"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"0.5.0","version":"0.5"},"category":{"_id":"56fd3956caad892200847bce","__v":0,"project":"56c35c56c0c4630d004e864c","version":"56c35c56c0c4630d004e864f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-03-31T14:51:02.977Z","from_sync":false,"order":1,"slug":"buzz-json-objects","title":"Buzz JSON Objects"},"user":"56c39c05bc41330d009f25d7","project":"56c35c56c0c4630d004e864c","__v":1,"githubsync":"","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-31T15:40:08.577Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"Creatives are the most complex objects in Buzz. For a primer, see [Creatives, Creative Assets, Templates, Rules](doc:creatives-creative-assets-templates-rules). Creatives are based on [CreativeTemplates](doc:creativetemplates and the `creative_content` field stores a JSON representation of the parameters to be used within the template.\n\nFor example, suppose you have a Creative Template for a simple image ad:\n```<a href=\"{{CLICK}}\"><img src=\"{{CUSTOM:IMAGE:FILE}}\"></a>```\n\nThe CLICK macro will be automatically expanded by the ad server when delivered. However, the creative expects to have a static value provided for the custom variable named `IMAGE` and this value should be of the type `FILE`, which is the same as any URL.\n\nIn this case, the creative_content field should have a value for the IMAGE parameters such as:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"IMAGE\\\":\\\"http://s3.amazon.com/folder/my_image.jpg\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Global Creative Templates\"\n}\n[/block]\nBuzz is deployed with a number of \"Global\" Creative Templates that are available to all Accounts, and in most cases these template should do what you need. There are two ways to fill in the fields of the template: By setting values in the `creative_content` field of the Creative itself and by passing in Creative Asset IDs into the `creative_assets` field. In some cases, you may need to do both! In addition, the templates can helpfully set certain [Creative Attributes](doc:creative-attributes)  automatically based on the values passed in.\n\nThe chart below summarizes the inputs and outputs for each of the Global templates:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Template ID\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"creative_assets\",\n    \"h-3\": \"creative_content field\",\n    \"h-4\": \"creative_attributes automatically set\",\n    \"0-0\": \"1\",\n    \"1-0\": \"2\",\n    \"2-0\": \"3\",\n    \"3-0\": \"4\",\n    \"4-0\": \"5\",\n    \"5-0\": \"6\",\n    \"6-0\": \"7\",\n    \"0-1\": \"Image template\",\n    \"1-1\": \"Flash template\",\n    \"2-1\": \"VAST 2.0 Template\",\n    \"3-1\": \"JS Tag\",\n    \"4-1\": \"Iframe Tag\",\n    \"5-1\": \"VAST 2.0 Wrapper\",\n    \"6-1\": \"VPAID, No Companion\",\n    \"0-2\": \"A single image asset\",\n    \"0-4\": \"`tag_type, banner_mime`\",\n    \"1-2\": \"A single SWF asset\",\n    \"2-2\": \"A single Video Asset, an optional image asset for the companion\",\n    \"2-3\": \"`TITLE` (If not set the video filename will be used)\\n`DURATION` (Defaults to 30)\\n\\n`HTML_COMPANIONS: COMPANION_WIDTH, COMPANION_HEIGHT, COMPANION_HTML`\",\n    \"3-3\": \"`TAG`\",\n    \"4-3\": \"`TAG`\",\n    \"5-3\": \"`VAST_3PAS_URL`\",\n    \"6-2\": \"A single SWF or html Creative Asset, an optional image asset for the companion\",\n    \"6-3\": \"`TITLE` (If not set the video filename will be used)\\n`DURATION` (Defaults to 30)\\n\\n`HTML_COMPANIONS: COMPANION_WIDTH, COMPANION_HEIGHT, COMPANION_HTML`\",\n    \"6-4\": \"`video_protocol, video_api`\",\n    \"2-4\": \"`video_protocol, video_mime, video_duration, video_bitrate`\",\n    \"3-4\": \"`tag_type`\",\n    \"4-4\": \"`tag_type`\",\n    \"1-4\": \"`tag_type, banner_mime`\"\n  },\n  \"cols\": 5,\n  \"rows\": 7\n}\n[/block]","excerpt":"","slug":"creative-content","type":"basic","title":"Creative Content"}
Creatives are the most complex objects in Buzz. For a primer, see [Creatives, Creative Assets, Templates, Rules](doc:creatives-creative-assets-templates-rules). Creatives are based on [CreativeTemplates](doc:creativetemplates and the `creative_content` field stores a JSON representation of the parameters to be used within the template. For example, suppose you have a Creative Template for a simple image ad: ```<a href="{{CLICK}}"><img src="{{CUSTOM:IMAGE:FILE}}"></a>``` The CLICK macro will be automatically expanded by the ad server when delivered. However, the creative expects to have a static value provided for the custom variable named `IMAGE` and this value should be of the type `FILE`, which is the same as any URL. In this case, the creative_content field should have a value for the IMAGE parameters such as: [block:code] { "codes": [ { "code": "{\n \"IMAGE\":\"http://s3.amazon.com/folder/my_image.jpg\"\n}", "language": "json" } ] } [/block] [block:api-header] { "type": "basic", "title": "Global Creative Templates" } [/block] Buzz is deployed with a number of "Global" Creative Templates that are available to all Accounts, and in most cases these template should do what you need. There are two ways to fill in the fields of the template: By setting values in the `creative_content` field of the Creative itself and by passing in Creative Asset IDs into the `creative_assets` field. In some cases, you may need to do both! In addition, the templates can helpfully set certain [Creative Attributes](doc:creative-attributes) automatically based on the values passed in. The chart below summarizes the inputs and outputs for each of the Global templates: [block:parameters] { "data": { "h-0": "Template ID", "h-1": "Name", "h-2": "creative_assets", "h-3": "creative_content field", "h-4": "creative_attributes automatically set", "0-0": "1", "1-0": "2", "2-0": "3", "3-0": "4", "4-0": "5", "5-0": "6", "6-0": "7", "0-1": "Image template", "1-1": "Flash template", "2-1": "VAST 2.0 Template", "3-1": "JS Tag", "4-1": "Iframe Tag", "5-1": "VAST 2.0 Wrapper", "6-1": "VPAID, No Companion", "0-2": "A single image asset", "0-4": "`tag_type, banner_mime`", "1-2": "A single SWF asset", "2-2": "A single Video Asset, an optional image asset for the companion", "2-3": "`TITLE` (If not set the video filename will be used)\n`DURATION` (Defaults to 30)\n\n`HTML_COMPANIONS: COMPANION_WIDTH, COMPANION_HEIGHT, COMPANION_HTML`", "3-3": "`TAG`", "4-3": "`TAG`", "5-3": "`VAST_3PAS_URL`", "6-2": "A single SWF or html Creative Asset, an optional image asset for the companion", "6-3": "`TITLE` (If not set the video filename will be used)\n`DURATION` (Defaults to 30)\n\n`HTML_COMPANIONS: COMPANION_WIDTH, COMPANION_HEIGHT, COMPANION_HTML`", "6-4": "`video_protocol, video_api`", "2-4": "`video_protocol, video_mime, video_duration, video_bitrate`", "3-4": "`tag_type`", "4-4": "`tag_type`", "1-4": "`tag_type, banner_mime`" }, "cols": 5, "rows": 7 } [/block]