{"_id":"56cb9b5bc675f50b00a4b859","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"},"githubsync":"","parentDoc":null,"__v":3,"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"},"project":"56c35c56c0c4630d004e864c","metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-22T23:35:55.650Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":4,"body":"Tracking Events , also called Conversion Events, are an important part of any ad serving system, as they provide the feedback the system needs to evaluate the effectiveness of various media purchases. Buzz implements [Events](doc:events) at the [Advertiser](doc:advertisers) level and allows events to be associated to the [Campaign](doc:campaigns), or [Line Item](doc:line-items)  levels using the [Event Assignments](doc:event-assignments) object.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"The Event Object\"\n}\n[/block]\nThe first step to tracking a conversion is to create an Event object. The Event has a name, and several default parameters, that require some discussion:\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Parameter\",\n    \"h-1\": \"Usage\",\n    \"h-2\": \"Override?\",\n    \"h-3\": \"Parameter\",\n    \"h-4\": \"Usage\",\n    \"0-0\": \"`click_window`\",\n    \"0-1\": \"Amount of time to \\\"look back\\\" after an event to see which clicks deserve credit for reporting and optimization. This is typically set to 30 days.\",\n    \"0-2\": \"Yes\",\n    \"1-0\": \"`view_window`\",\n    \"1-1\": \"Amount of time to \\\"look back\\\" after an event to see which impressions deserve credit for reporting and optimization. This is typically set to 30 days.\",\n    \"1-2\": \"Yes\",\n    \"2-0\": \"`value`\",\n    \"2-1\": \"Default value for the conversion. If no value is passed to the event tag in real time, this value will be used. For example, you may wish to value a newsletter sign-up at $5 every time, whereas for an ecommerce transaction the actual value of the purchase should override this value\",\n    \"2-2\": \"Yes\",\n    \"3-0\": \"`count_unique`\",\n    \"3-1\": \"Should we count only unique conversions, or should we count every conversion. Typically you will want to count every conversion for instances where you are counting purchases, to get the aggregate amount spent.\",\n    \"3-2\": \"No\",\n    \"4-0\": \"`attribution`\",\n    \"4-1\": \"Based on the value of this field, should a conversion event be attributed to any Line Item for that Advertiser (`ANY`), or should the event only be attributed to specified objects (`WHITELIST`).\",\n    \"4-2\": \"No\"\n  },\n  \"cols\": 3,\n  \"rows\": 5\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Downloading Tags\"\n}\n[/block]\nThe most common workflow for managing Events is to download \"tags\" corresponding to the events and use those tags in your web site, application, or wherever. To get the appropriate tags, you make a GET request to the [event_tag](doc:event-tag) API method. See [Conversion Tags](doc:conversion-tags-1).\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Postback Tags\"\n}\n[/block]\nBuzz supports Postback tags for mobile attribution systems. A postback tag takes the unique `auction_id` of the request as a parameter and gives full credit to whichever line items and campaigns were served on that request.","excerpt":"","slug":"conversion-events","type":"basic","title":"Conversion Events"}
Tracking Events , also called Conversion Events, are an important part of any ad serving system, as they provide the feedback the system needs to evaluate the effectiveness of various media purchases. Buzz implements [Events](doc:events) at the [Advertiser](doc:advertisers) level and allows events to be associated to the [Campaign](doc:campaigns), or [Line Item](doc:line-items) levels using the [Event Assignments](doc:event-assignments) object. [block:api-header] { "type": "basic", "title": "The Event Object" } [/block] The first step to tracking a conversion is to create an Event object. The Event has a name, and several default parameters, that require some discussion: [block:parameters] { "data": { "h-0": "Parameter", "h-1": "Usage", "h-2": "Override?", "h-3": "Parameter", "h-4": "Usage", "0-0": "`click_window`", "0-1": "Amount of time to \"look back\" after an event to see which clicks deserve credit for reporting and optimization. This is typically set to 30 days.", "0-2": "Yes", "1-0": "`view_window`", "1-1": "Amount of time to \"look back\" after an event to see which impressions deserve credit for reporting and optimization. This is typically set to 30 days.", "1-2": "Yes", "2-0": "`value`", "2-1": "Default value for the conversion. If no value is passed to the event tag in real time, this value will be used. For example, you may wish to value a newsletter sign-up at $5 every time, whereas for an ecommerce transaction the actual value of the purchase should override this value", "2-2": "Yes", "3-0": "`count_unique`", "3-1": "Should we count only unique conversions, or should we count every conversion. Typically you will want to count every conversion for instances where you are counting purchases, to get the aggregate amount spent.", "3-2": "No", "4-0": "`attribution`", "4-1": "Based on the value of this field, should a conversion event be attributed to any Line Item for that Advertiser (`ANY`), or should the event only be attributed to specified objects (`WHITELIST`).", "4-2": "No" }, "cols": 3, "rows": 5 } [/block] [block:api-header] { "type": "basic", "title": "Downloading Tags" } [/block] The most common workflow for managing Events is to download "tags" corresponding to the events and use those tags in your web site, application, or wherever. To get the appropriate tags, you make a GET request to the [event_tag](doc:event-tag) API method. See [Conversion Tags](doc:conversion-tags-1). [block:api-header] { "type": "basic", "title": "Postback Tags" } [/block] Buzz supports Postback tags for mobile attribution systems. A postback tag takes the unique `auction_id` of the request as a parameter and gives full credit to whichever line items and campaigns were served on that request.