{"_id":"56cbb060d5c6241d00ef5ebb","user":"56c39c05bc41330d009f25d7","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":"56c7bab4606ee717003c4766","project":"56c35c56c0c4630d004e864c","__v":18,"pages":["56c7c193f9aa3b0d00c8458f","56cb80a4c675f50b00a4b826","56cb83859f4ae20b00644f1f","56cb853a245b841300806f82","56cb863c32011d2500681925","56cb88a4245b841300806f8b","56cb9915245b841300806fa7","56cb9a079f4ae20b00644f48","56cb9b5bc675f50b00a4b859","56cba5929f4ae20b00644f5d","56cba5c5d5c6241d00ef5e93","56cbab9c9f4ae20b00644f76","56cbad69c675f50b00a4b881","56cbb060d5c6241d00ef5ebb","56cf3c4d6c5d7a13005ee88c","56cf3d0e287eb20b009f9ec7","56cf3d7c5267d70b00494c42","56cf3ee0287eb20b009f9ecd"],"version":"56c35c56c0c4630d004e864f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-02-20T01:00:36.607Z","from_sync":false,"order":0,"slug":"buzz-concepts","title":"Buzz Concepts"},"project":"56c35c56c0c4630d004e864c","__v":9,"githubsync":"","updates":["5b1921a9b9011a000309d5fa","5b2965e8f11cd000039cb4de"],"next":{"pages":[],"description":""},"createdAt":"2016-02-23T01:05:36.015Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":11,"body":"The following Macros are supported by Buzz. These macros may be included in [Creative Templates](doc:creativetemplates), the content of the [Creatives](doc:creatives) or the `click_url` field of the Creative. Macros are case-sensitive and should be surrounded by double curly brackets on both sides to be properly recognized. For example, the macro `FOO` should be represented in the creative as `{{FOO}}`, not `{{Foo}}`.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Basic Macros\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Macro\",\n    \"h-1\": \"Expansion\",\n    \"0-0\": \"AUCTION_ID\",\n    \"0-1\": \"Unique id for every bid request. It is a joining key for all the events associated with the bid request such as impression, clicks, and activities.\",\n    \"1-0\": \"AGE\",\n    \"1-1\": \"The age of the user as reported by the exchange\",\n    \"2-0\": \"GENDER\",\n    \"2-1\": \"The gender of the user as reported by the exchange\",\n    \"3-0\": \"USER_ID\",\n    \"3-1\": \"Device ID for mobile, cookie for desktop. This will populate with either a cookie on a desktop OR an iOS/Android ID for mobile (will be pseudo-anonymized when subject to GDPR without explicit consent).\",\n    \"5-0\": \"IOS_ID\",\n    \"5-1\": \"iOS Device ID\",\n    \"6-0\": \"ANDROID_ID\",\n    \"6-1\": \"Android Device ID\",\n    \"7-0\": \"CACHEBUSTER\",\n    \"7-1\": \"Random number\",\n    \"9-0\": \"HEIGHT\",\n    \"9-1\": \"Height of the Creative\",\n    \"10-0\": \"WIDTH\",\n    \"10-1\": \"Width of the Creative\",\n    \"11-0\": \"MEDIA_HOST\",\n    \"11-1\": \"Host the Creative will be served from\",\n    \"12-0\": \"PROTOCOL\",\n    \"12-1\": \"http:// or https:// depending on whether the Creative will be served into a secure environment\",\n    \"13-0\": \"IMPRESSION_URL\",\n    \"13-1\": \"URL to count an impression. This macro must be present in all creative templates.\",\n    \"20-0\": \"LINE_ITEM_ID\",\n    \"20-1\": \"Line Item ID for the impression\",\n    \"22-0\": \"USER_AGENT\",\n    \"22-1\": \"Full user agent of the device, base 64 encoded (will be blank when subject to GDPR without explicit consent).\",\n    \"24-0\": \"IP_ADDRESS\",\n    \"24-1\": \"IP address of the device, base 64 encoded (will be pseudo-anonymized when subject to GDPR without explicit consent).\",\n    \"14-0\": \"ADVERTISER_ID\",\n    \"14-1\": \"Advertiser ID for the impression\",\n    \"15-0\": \"ADVERTISER_ID_ALT\",\n    \"15-1\": \"Alternative advertiser ID for the impression\",\n    \"16-0\": \"CAMPAIGN_ID\",\n    \"16-1\": \"Campaign ID for the impression\",\n    \"17-0\": \"CAMPAIGN_ID_ALT\",\n    \"17-1\": \"Alternative campaign ID for the impression\",\n    \"18-0\": \"CREATIVE_ID\",\n    \"18-1\": \"Creative ID for the impression\",\n    \"19-0\": \"CREATIVE_ID_ALT\",\n    \"19-1\": \"Alternative creative ID for the impression\",\n    \"21-0\": \"LINE_ITEM_ID_ALT\",\n    \"21-1\": \"Alternative line item ID for the impression\",\n    \"25-0\": \"IP_ADDRESS_ESC\",\n    \"25-1\": \"IP address of the device, URL-escaped (will be pseudo-anonymized when subject to GDPR without explicit consent).\",\n    \"23-0\": \"USER_AGENT_ESC\",\n    \"23-1\": \"Full user agent of the device, URL-escaped (will be blank when subject to GDPR without explicit consent).\",\n    \"26-0\": \"IP_ADDRESS_IPV6\",\n    \"26-1\": \"IP address of the device when IPV6 is present, always URL-escaped (will be pseudo-anonymized when subject to GDPR without explicit consent).\",\n    \"27-0\": \"IS_GDPR\",\n    \"27-1\": \"Whether the auction is subject to GDPR.\",\n    \"4-0\": \"USER_ID_SHA1\",\n    \"4-1\": \"Device ID for mobile, hashed using the SHA1 algorithm for use with postback providers\",\n    \"8-0\": \"DNT\",\n    \"8-1\": \"Whether the user has Do Not Track or Limit Ad Tracking set\"\n  },\n  \"cols\": 2,\n  \"rows\": 28\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Inventory/Content Macros\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Macro\",\n    \"h-1\": \"Expansion\",\n    \"0-0\": \"PAGE\",\n    \"0-1\": \"The full URL of the page the ad was served on\",\n    \"1-0\": \"DOMAIN\",\n    \"1-1\": \"Domain the impression was served on\",\n    \"2-0\": \"REFERRER\",\n    \"2-1\": \"Domain the user came from before landing on domain the impression was served on\",\n    \"3-0\": \"SITE_ID\",\n    \"3-1\": \"Site ID that the impression was served on\",\n    \"4-0\": \"SITE_NAME\",\n    \"4-1\": \"Site Name that the impression was served on\",\n    \"5-0\": \"APP_BUNDLE\",\n    \"5-1\": \"Mobile application bundle the impression was served on\",\n    \"7-0\": \"APP_NAME\",\n    \"7-1\": \"Mobile application name the impression was served on\",\n    \"8-0\": \"APP_STORE_URL\",\n    \"8-1\": \"URL the mobile application on the app store\",\n    \"9-0\": \"PLACEMENT_ID\",\n    \"9-1\": \"Placement the ad was served on\",\n    \"6-0\": \"APP_ID\",\n    \"6-1\": \"Unique ID of the app within the exchange\",\n    \"10-0\": \"INVENTORY_SOURCE\",\n    \"10-1\": \"Exchange inventory source (i.e. Rubicon, Mopub etc)\",\n    \"11-1\": \"The exchange abbreviation for each inventory source (i.e. \\\"rp\\\" for Rubicon). Exchange handles are used in conjunction with exchange specific IDs in targeting  (i.e. rp/12345 for a Rubicon specific site ID)\",\n    \"11-0\": \"EXCHANGE_HANDLE\",\n    \"12-0\": \"REWARDED\",\n    \"12-1\": \"Whether the auction was for rewarded video\"\n  },\n  \"cols\": 2,\n  \"rows\": 13\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Location Macros\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Macro\",\n    \"h-1\": \"Expansion\",\n    \"0-0\": \"LAT\",\n    \"0-1\": \"The latitude of the device/user (will be truncated to three decimal places when subject to GDPR without explicit consent).\",\n    \"1-0\": \"LONG\",\n    \"1-1\": \"The longitude of the device/user (will be truncated to three decimal places when subject to GDPR without explicit consent).\",\n    \"2-0\": \"ZIP_CODE\",\n    \"2-1\": \"The zip code of the device/user.\",\n    \"3-0\": \"METRO_CODE\",\n    \"3-1\": \"The metro code of the device/user. Metro code is the OpenRTB equivalent of DMA.\",\n    \"4-0\": \"COUNTRY_CODE\",\n    \"4-1\": \"Two-character country code of the device/user.\"\n  },\n  \"cols\": 2,\n  \"rows\": 5\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Mobile/Device Macros\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Macro\",\n    \"h-1\": \"Expansion\",\n    \"0-0\": \"DEVICE_MAKE\",\n    \"0-1\": \"The device make that the ad was served on (i.e. Apple, Samsung)\",\n    \"1-0\": \"DEVICE_MODEL\",\n    \"1-1\": \"The device model that the ad was served on (i.e. iPhone 6s, Galaxy S6)\",\n    \"2-0\": \"PLATFORM_OS\",\n    \"2-1\": \"Operating system of the device the ad was served on (i.e. iOS, Android)\",\n    \"3-0\": \"PLATFORM_CARRIER\",\n    \"3-1\": \"Mobile carrier of the device the ad was served on (i.e. Verizon, AT&T)\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Video Macros\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Macro\",\n    \"h-1\": \"Expansion\",\n    \"0-0\": \"EVENT_START_URL\",\n    \"0-1\": \"URL for tracking video starts\",\n    \"1-0\": \"EVENT_Q1_URL\",\n    \"1-1\": \"URL for tracking first quartile video plays\",\n    \"2-0\": \"EVENT_MID_URL\",\n    \"2-1\": \"URL for tracking video midpoints\",\n    \"3-0\": \"EVENT_Q3_URL\",\n    \"3-1\": \"URL for tracking third quartile video plays\",\n    \"4-0\": \"EVENT_COMPLETE_URL\",\n    \"4-1\": \"URL for tracking video completes\",\n    \"5-0\": \"EVENT_SKIP_URL\",\n    \"5-1\": \"URL for tracking video skips\",\n    \"6-0\": \"EVENT_MUTE_URL\",\n    \"6-1\": \"URL for tracking video mutes\",\n    \"7-0\": \"EVENT_UNMUTE_URL\",\n    \"7-1\": \"URL for tracking video unmutes\",\n    \"8-0\": \"EVENT_PAUSE_URL\",\n    \"8-1\": \"URL for tracking video pauses\",\n    \"9-0\": \"EVENT_RESUME_URL\",\n    \"9-1\": \"URL for tracking video resumes\",\n    \"10-0\": \"EVENT_FULLSCREEN_URL\",\n    \"10-1\": \"URL for tracking video fullscreen events\",\n    \"11-0\": \"EVENT_CLOSE_URL\",\n    \"11-1\": \"URL for tracking close events\",\n    \"12-0\": \"PLAYER_HEIGHT\",\n    \"12-1\": \"Video content player height\",\n    \"13-0\": \"PLAYER_WIDTH\",\n    \"13-1\": \"Video content player width\"\n  },\n  \"cols\": 2,\n  \"rows\": 14\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"URL Macros\"\n}\n[/block]\nNOTE: These macros cannot be included in the `click_url` field of the Creative. They may only be included in the `creative_content` or inside a Creative Template. \n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Macro\",\n    \"h-1\": \"Expansion\",\n    \"0-0\": \"CLICK_URL\",\n    \"0-1\": \"Click-through URL, including both the CLICK_DESTINATION and CLICK_TRACKING components\",\n    \"1-0\": \"CLICK_DESTINATION\",\n    \"1-1\": \"Resolves to the destination click URL, can include other macros when expanded\",\n    \"2-0\": \"CLICK_TRACKING_URL\",\n    \"2-1\": \"Tracking-only URL, will not redirect to destination page\",\n    \"3-0\": \"CLICK_URL_ESC\",\n    \"3-1\": \"Escaped version of the CLICK_URL macro, for use when being redirected by another ad server\",\n    \"4-0\": \"NUM_DEST_URL_ESCAPES\",\n    \"5-0\": \"NUM_DEST_URL_ESC_ESCAPES\",\n    \"4-1\": \"Number of escapes to be used by your ad server when escaping the final destination URL. Required by some 3rd party ad servers to correctly handle destination URL redirection. \\n\\nUse this macro in conjunction with the CLICK_URL macro\",\n    \"5-1\": \"Number of escapes to be used by your ad server when escaping the final destination URL. Required by some 3rd party ad servers to correctly handle destination URL redirection.\\n\\nUse this macro in conjunction with the CLICK_URL_ESC macro\"\n  },\n  \"cols\": 2,\n  \"rows\": 6\n}\n[/block]","excerpt":"","slug":"macros","type":"basic","title":"Macros"}
The following Macros are supported by Buzz. These macros may be included in [Creative Templates](doc:creativetemplates), the content of the [Creatives](doc:creatives) or the `click_url` field of the Creative. Macros are case-sensitive and should be surrounded by double curly brackets on both sides to be properly recognized. For example, the macro `FOO` should be represented in the creative as `{{FOO}}`, not `{{Foo}}`. [block:api-header] { "type": "basic", "title": "Basic Macros" } [/block] [block:parameters] { "data": { "h-0": "Macro", "h-1": "Expansion", "0-0": "AUCTION_ID", "0-1": "Unique id for every bid request. It is a joining key for all the events associated with the bid request such as impression, clicks, and activities.", "1-0": "AGE", "1-1": "The age of the user as reported by the exchange", "2-0": "GENDER", "2-1": "The gender of the user as reported by the exchange", "3-0": "USER_ID", "3-1": "Device ID for mobile, cookie for desktop. This will populate with either a cookie on a desktop OR an iOS/Android ID for mobile (will be pseudo-anonymized when subject to GDPR without explicit consent).", "5-0": "IOS_ID", "5-1": "iOS Device ID", "6-0": "ANDROID_ID", "6-1": "Android Device ID", "7-0": "CACHEBUSTER", "7-1": "Random number", "9-0": "HEIGHT", "9-1": "Height of the Creative", "10-0": "WIDTH", "10-1": "Width of the Creative", "11-0": "MEDIA_HOST", "11-1": "Host the Creative will be served from", "12-0": "PROTOCOL", "12-1": "http:// or https:// depending on whether the Creative will be served into a secure environment", "13-0": "IMPRESSION_URL", "13-1": "URL to count an impression. This macro must be present in all creative templates.", "20-0": "LINE_ITEM_ID", "20-1": "Line Item ID for the impression", "22-0": "USER_AGENT", "22-1": "Full user agent of the device, base 64 encoded (will be blank when subject to GDPR without explicit consent).", "24-0": "IP_ADDRESS", "24-1": "IP address of the device, base 64 encoded (will be pseudo-anonymized when subject to GDPR without explicit consent).", "14-0": "ADVERTISER_ID", "14-1": "Advertiser ID for the impression", "15-0": "ADVERTISER_ID_ALT", "15-1": "Alternative advertiser ID for the impression", "16-0": "CAMPAIGN_ID", "16-1": "Campaign ID for the impression", "17-0": "CAMPAIGN_ID_ALT", "17-1": "Alternative campaign ID for the impression", "18-0": "CREATIVE_ID", "18-1": "Creative ID for the impression", "19-0": "CREATIVE_ID_ALT", "19-1": "Alternative creative ID for the impression", "21-0": "LINE_ITEM_ID_ALT", "21-1": "Alternative line item ID for the impression", "25-0": "IP_ADDRESS_ESC", "25-1": "IP address of the device, URL-escaped (will be pseudo-anonymized when subject to GDPR without explicit consent).", "23-0": "USER_AGENT_ESC", "23-1": "Full user agent of the device, URL-escaped (will be blank when subject to GDPR without explicit consent).", "26-0": "IP_ADDRESS_IPV6", "26-1": "IP address of the device when IPV6 is present, always URL-escaped (will be pseudo-anonymized when subject to GDPR without explicit consent).", "27-0": "IS_GDPR", "27-1": "Whether the auction is subject to GDPR.", "4-0": "USER_ID_SHA1", "4-1": "Device ID for mobile, hashed using the SHA1 algorithm for use with postback providers", "8-0": "DNT", "8-1": "Whether the user has Do Not Track or Limit Ad Tracking set" }, "cols": 2, "rows": 28 } [/block] [block:api-header] { "type": "basic", "title": "Inventory/Content Macros" } [/block] [block:parameters] { "data": { "h-0": "Macro", "h-1": "Expansion", "0-0": "PAGE", "0-1": "The full URL of the page the ad was served on", "1-0": "DOMAIN", "1-1": "Domain the impression was served on", "2-0": "REFERRER", "2-1": "Domain the user came from before landing on domain the impression was served on", "3-0": "SITE_ID", "3-1": "Site ID that the impression was served on", "4-0": "SITE_NAME", "4-1": "Site Name that the impression was served on", "5-0": "APP_BUNDLE", "5-1": "Mobile application bundle the impression was served on", "7-0": "APP_NAME", "7-1": "Mobile application name the impression was served on", "8-0": "APP_STORE_URL", "8-1": "URL the mobile application on the app store", "9-0": "PLACEMENT_ID", "9-1": "Placement the ad was served on", "6-0": "APP_ID", "6-1": "Unique ID of the app within the exchange", "10-0": "INVENTORY_SOURCE", "10-1": "Exchange inventory source (i.e. Rubicon, Mopub etc)", "11-1": "The exchange abbreviation for each inventory source (i.e. \"rp\" for Rubicon). Exchange handles are used in conjunction with exchange specific IDs in targeting (i.e. rp/12345 for a Rubicon specific site ID)", "11-0": "EXCHANGE_HANDLE", "12-0": "REWARDED", "12-1": "Whether the auction was for rewarded video" }, "cols": 2, "rows": 13 } [/block] [block:api-header] { "type": "basic", "title": "Location Macros" } [/block] [block:parameters] { "data": { "h-0": "Macro", "h-1": "Expansion", "0-0": "LAT", "0-1": "The latitude of the device/user (will be truncated to three decimal places when subject to GDPR without explicit consent).", "1-0": "LONG", "1-1": "The longitude of the device/user (will be truncated to three decimal places when subject to GDPR without explicit consent).", "2-0": "ZIP_CODE", "2-1": "The zip code of the device/user.", "3-0": "METRO_CODE", "3-1": "The metro code of the device/user. Metro code is the OpenRTB equivalent of DMA.", "4-0": "COUNTRY_CODE", "4-1": "Two-character country code of the device/user." }, "cols": 2, "rows": 5 } [/block] [block:api-header] { "type": "basic", "title": "Mobile/Device Macros" } [/block] [block:parameters] { "data": { "h-0": "Macro", "h-1": "Expansion", "0-0": "DEVICE_MAKE", "0-1": "The device make that the ad was served on (i.e. Apple, Samsung)", "1-0": "DEVICE_MODEL", "1-1": "The device model that the ad was served on (i.e. iPhone 6s, Galaxy S6)", "2-0": "PLATFORM_OS", "2-1": "Operating system of the device the ad was served on (i.e. iOS, Android)", "3-0": "PLATFORM_CARRIER", "3-1": "Mobile carrier of the device the ad was served on (i.e. Verizon, AT&T)" }, "cols": 2, "rows": 4 } [/block] [block:api-header] { "type": "basic", "title": "Video Macros" } [/block] [block:parameters] { "data": { "h-0": "Macro", "h-1": "Expansion", "0-0": "EVENT_START_URL", "0-1": "URL for tracking video starts", "1-0": "EVENT_Q1_URL", "1-1": "URL for tracking first quartile video plays", "2-0": "EVENT_MID_URL", "2-1": "URL for tracking video midpoints", "3-0": "EVENT_Q3_URL", "3-1": "URL for tracking third quartile video plays", "4-0": "EVENT_COMPLETE_URL", "4-1": "URL for tracking video completes", "5-0": "EVENT_SKIP_URL", "5-1": "URL for tracking video skips", "6-0": "EVENT_MUTE_URL", "6-1": "URL for tracking video mutes", "7-0": "EVENT_UNMUTE_URL", "7-1": "URL for tracking video unmutes", "8-0": "EVENT_PAUSE_URL", "8-1": "URL for tracking video pauses", "9-0": "EVENT_RESUME_URL", "9-1": "URL for tracking video resumes", "10-0": "EVENT_FULLSCREEN_URL", "10-1": "URL for tracking video fullscreen events", "11-0": "EVENT_CLOSE_URL", "11-1": "URL for tracking close events", "12-0": "PLAYER_HEIGHT", "12-1": "Video content player height", "13-0": "PLAYER_WIDTH", "13-1": "Video content player width" }, "cols": 2, "rows": 14 } [/block] [block:api-header] { "type": "basic", "title": "URL Macros" } [/block] NOTE: These macros cannot be included in the `click_url` field of the Creative. They may only be included in the `creative_content` or inside a Creative Template. [block:parameters] { "data": { "h-0": "Macro", "h-1": "Expansion", "0-0": "CLICK_URL", "0-1": "Click-through URL, including both the CLICK_DESTINATION and CLICK_TRACKING components", "1-0": "CLICK_DESTINATION", "1-1": "Resolves to the destination click URL, can include other macros when expanded", "2-0": "CLICK_TRACKING_URL", "2-1": "Tracking-only URL, will not redirect to destination page", "3-0": "CLICK_URL_ESC", "3-1": "Escaped version of the CLICK_URL macro, for use when being redirected by another ad server", "4-0": "NUM_DEST_URL_ESCAPES", "5-0": "NUM_DEST_URL_ESC_ESCAPES", "4-1": "Number of escapes to be used by your ad server when escaping the final destination URL. Required by some 3rd party ad servers to correctly handle destination URL redirection. \n\nUse this macro in conjunction with the CLICK_URL macro", "5-1": "Number of escapes to be used by your ad server when escaping the final destination URL. Required by some 3rd party ad servers to correctly handle destination URL redirection.\n\nUse this macro in conjunction with the CLICK_URL_ESC macro" }, "cols": 2, "rows": 6 } [/block]