{"_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":2,"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","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. In the future we expect to allow Events to be assigned at the Advertiser, Campaign, or Line Item levels.\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  },\n  \"cols\": 3,\n  \"rows\": 4\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. In the future we expect to allow Events to be assigned at the Advertiser, Campaign, or Line Item levels. [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" }, "cols": 3, "rows": 4 } [/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.