{"_id":"56cf3ee0287eb20b009f9ecd","project":"56c35c56c0c4630d004e864c","parentDoc":null,"__v":4,"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"},"user":"56c39c05bc41330d009f25d7","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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-25T17:50:24.184Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":14,"body":"Buzz allows you to calculate Revenue, Gross and Net Margins for your Campaigns and Line Items. This is a common need for users who are both buying ads using Buzz and selling those ads either directly to advertisers or through another system.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Revenue\"\n}\n[/block]\nRevenue can be set at the [Campaign](doc:campaigns) and [Line Item](doc:line-items) level and can be expressed as one of the following types using the `revenue_type` field:\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"`CPM`\",\n    \"0-1\": \"Cost per 1,000 impressions\",\n    \"1-0\": \"`CPC`\",\n    \"1-1\": \"Cost per click\",\n    \"2-0\": \"`CPI`\",\n    \"2-1\": \"Cost per Installation (same as CPA)\",\n    \"3-0\": \"`CPA`\",\n    \"3-1\": \"Cost per Action\",\n    \"4-0\": \"`CPCV`\",\n    \"4-1\": \"Cost per Completed Video View\",\n    \"h-0\": \"Revenue Type\",\n    \"h-1\": \"Definition\"\n  },\n  \"cols\": 2,\n  \"rows\": 5\n}\n[/block]\nIf revenue is set at the Line Item level, this will take precedence over the setting at the Campaign level.\n\nIn the example below a Campaign has revenue set at $5 CPM, but one of its two Line Items is set with a different value, $3 CPM. Revenue is calculated based on the more granular setting at the Line Item level for Line Item 2, while the Campaign-level setting applies for Line Item 1 where revenue was not specified.\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-2\": \"CPM\",\n    \"h-3\": \"Impressions\",\n    \"h-4\": \"Revenue Calculated\",\n    \"0-0\": \"Campaign\",\n    \"0-2\": \"$5.00\",\n    \"0-4\": \"$8,000\",\n    \"1-1\": \"Line Item 1\",\n    \"1-2\": \"NULL\",\n    \"1-3\": \"1,000,000\",\n    \"1-4\": \"$5,000\",\n    \"2-4\": \"$3,000\",\n    \"2-3\": \"1,000,000\",\n    \"2-2\": \"$3.00\",\n    \"2-1\": \"Line Item 2\",\n    \"h-0\": \"-\",\n    \"h-1\": \"-\"\n  },\n  \"cols\": 5,\n  \"rows\": 3\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Vendors and Vendor Fees\"\n}\n[/block]\nWhen calculating margin you may wish to subtract fees charged by other vendors such as rich media providers, data exchanges, verification vendors, etc. To accomplish this easily Buzz has the concept of [Vendors](doc:vendors) and [Vendor Fees](doc:vendor-fees). One or more Vendor Fees may be applied at the Campaign and Line Item level. These fees can be calculated as either a flat CPM fee or as a percentage of the clearing price. Like revenue calculations (described above), Line Item fees will overwrite Campaign-level fees. \n\nThe Vendor object defines the vendors you will be working with across all Campaigns and Advertisers and can optionally set the contractual default fees. For example, if you regularly pay a verification vendor $0.10 CPM you would add that vendor with the default fee, then whenever they were added to a Campaign as a VendorFee object those default values would be used. If you then had a special price in place with the Vendor for a single Campaign, you could override the price at the VendorFee level for that Campaign.\n\nThere is a limit of 5 Vendor Fees per Campaign or Line Item.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Gross Margin and Net Margin in Reporting\"\n}\n[/block]\nThe Performance Report includes the following metrics relating to revenue and margin:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Field\",\n    \"h-1\": \"Calculation\",\n    \"0-0\": \"`Revenue`\",\n    \"0-1\": \"Total revenue calculated on either a CPM or CPC basis depending on the settings at the Campaign or Line Item levels\",\n    \"1-0\": \"`Spend`\",\n    \"1-1\": \"Total spend on media after bid reduction\",\n    \"2-0\": \"`Gross Margin`\",\n    \"2-1\": \"Revenue - Spend\",\n    \"3-0\": \"`Gross Margin Percentage`\",\n    \"3-1\": \"(Revenue - Gross Margin) / Revenue\",\n    \"4-0\": \"`Vendor Fees`\",\n    \"4-1\": \"Sum of all Vendor Fees associated at the Campaign or Line Item levels\",\n    \"5-0\": \"`Net Margin`\",\n    \"5-1\": \"Gross Margin - Vendor Fees\",\n    \"6-0\": \"`Net Margin Percentage`\",\n    \"6-1\": \"(Revenue - Net Margin) / Revenue\"\n  },\n  \"cols\": 2,\n  \"rows\": 7\n}\n[/block]","excerpt":"","slug":"revenue-and-margins","type":"basic","title":"Revenue and Margins"}

Revenue and Margins


Buzz allows you to calculate Revenue, Gross and Net Margins for your Campaigns and Line Items. This is a common need for users who are both buying ads using Buzz and selling those ads either directly to advertisers or through another system. [block:api-header] { "type": "basic", "title": "Revenue" } [/block] Revenue can be set at the [Campaign](doc:campaigns) and [Line Item](doc:line-items) level and can be expressed as one of the following types using the `revenue_type` field: [block:parameters] { "data": { "0-0": "`CPM`", "0-1": "Cost per 1,000 impressions", "1-0": "`CPC`", "1-1": "Cost per click", "2-0": "`CPI`", "2-1": "Cost per Installation (same as CPA)", "3-0": "`CPA`", "3-1": "Cost per Action", "4-0": "`CPCV`", "4-1": "Cost per Completed Video View", "h-0": "Revenue Type", "h-1": "Definition" }, "cols": 2, "rows": 5 } [/block] If revenue is set at the Line Item level, this will take precedence over the setting at the Campaign level. In the example below a Campaign has revenue set at $5 CPM, but one of its two Line Items is set with a different value, $3 CPM. Revenue is calculated based on the more granular setting at the Line Item level for Line Item 2, while the Campaign-level setting applies for Line Item 1 where revenue was not specified. [block:parameters] { "data": { "h-2": "CPM", "h-3": "Impressions", "h-4": "Revenue Calculated", "0-0": "Campaign", "0-2": "$5.00", "0-4": "$8,000", "1-1": "Line Item 1", "1-2": "NULL", "1-3": "1,000,000", "1-4": "$5,000", "2-4": "$3,000", "2-3": "1,000,000", "2-2": "$3.00", "2-1": "Line Item 2", "h-0": "-", "h-1": "-" }, "cols": 5, "rows": 3 } [/block] [block:api-header] { "type": "basic", "title": "Vendors and Vendor Fees" } [/block] When calculating margin you may wish to subtract fees charged by other vendors such as rich media providers, data exchanges, verification vendors, etc. To accomplish this easily Buzz has the concept of [Vendors](doc:vendors) and [Vendor Fees](doc:vendor-fees). One or more Vendor Fees may be applied at the Campaign and Line Item level. These fees can be calculated as either a flat CPM fee or as a percentage of the clearing price. Like revenue calculations (described above), Line Item fees will overwrite Campaign-level fees. The Vendor object defines the vendors you will be working with across all Campaigns and Advertisers and can optionally set the contractual default fees. For example, if you regularly pay a verification vendor $0.10 CPM you would add that vendor with the default fee, then whenever they were added to a Campaign as a VendorFee object those default values would be used. If you then had a special price in place with the Vendor for a single Campaign, you could override the price at the VendorFee level for that Campaign. There is a limit of 5 Vendor Fees per Campaign or Line Item. [block:api-header] { "type": "basic", "title": "Gross Margin and Net Margin in Reporting" } [/block] The Performance Report includes the following metrics relating to revenue and margin: [block:parameters] { "data": { "h-0": "Field", "h-1": "Calculation", "0-0": "`Revenue`", "0-1": "Total revenue calculated on either a CPM or CPC basis depending on the settings at the Campaign or Line Item levels", "1-0": "`Spend`", "1-1": "Total spend on media after bid reduction", "2-0": "`Gross Margin`", "2-1": "Revenue - Spend", "3-0": "`Gross Margin Percentage`", "3-1": "(Revenue - Gross Margin) / Revenue", "4-0": "`Vendor Fees`", "4-1": "Sum of all Vendor Fees associated at the Campaign or Line Item levels", "5-0": "`Net Margin`", "5-1": "Gross Margin - Vendor Fees", "6-0": "`Net Margin Percentage`", "6-1": "(Revenue - Net Margin) / Revenue" }, "cols": 2, "rows": 7 } [/block]