{"_id":"56fd5200aa7b710e007d3741","githubsync":"","project":"56c35c56c0c4630d004e864c","user":"56c39c05bc41330d009f25d7","__v":8,"parentDoc":null,"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"},"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":["57d7003d4340330e00953d3d"],"next":{"pages":[],"description":""},"createdAt":"2016-03-31T16:36:16.162Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":11,"body":"This document summarizes the existing targeting modules and keys.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Module\",\n    \"h-1\": \"Verb\",\n    \"h-2\": \"Keys\",\n    \"h-3\": \"Example\",\n    \"h-4\": \"Notes\",\n    \"0-0\": \"ad_size\",\n    \"2-2\": \"content_rating\",\n    \"3-2\": \"coppa\",\n    \"4-2\": \"language\",\n    \"5-0\": \"domain\",\n    \"6-0\": \"geo\",\n    \"7-2\": \"city\",\n    \"8-2\": \"lat_long_present\",\n    \"9-2\": \"region\",\n    \"10-2\": \"metro\",\n    \"11-2\": \"zip\",\n    \"14-2\": \"deal_id\",\n    \"16-2\": \"environment_type\",\n    \"17-2\": \"inventory_source\",\n    \"18-2\": \"interstitial\",\n    \"19-2\": \"site\",\n    \"21-2\": \"placement\",\n    \"25-0\": \"ip_address\",\n    \"26-1\": \"IR, ER\",\n    \"27-0\": \"mobile_app\",\n    \"28-2\": \"app_id_list\",\n    \"29-2\": \"app_name\",\n    \"30-0\": \"platform\",\n    \"31-2\": \"browser\",\n    \"32-2\": \"browser_version\",\n    \"33-2\": \"carrier\",\n    \"34-2\": \"js_support\",\n    \"35-2\": \"device_type\",\n    \"36-2\": \"device_make\",\n    \"37-2\": \"device_model\",\n    \"38-2\": \"device_screen_size\",\n    \"39-2\": \"os\",\n    \"40-2\": \"os_version\",\n    \"41-0\": \"segment\",\n    \"42-2\": \"user_id\",\n    \"43-0\": \"time\",\n    \"44-2\": \"line_item_start_end\",\n    \"45-0\": \"video\",\n    \"46-2\": \"playback_method\",\n    \"47-2\": \"player_size\",\n    \"48-2\": \"start_delay\",\n    \"49-2\": \"video_placement_type\",\n    \"0-1\": \"None, see note\",\n    \"0-2\": \"ad_size\",\n    \"0-3\": \"`\\\"ad_size\\\":[\\\"160x600\\\",\\\"600x160\\\"]`\",\n    \"0-4\": \"ad_size is not available as a targeting criteria, but may be used in a bid_modifier expression. Sizes should be passed as `<width>x<height>`\",\n    \"2-3\": \"`\\\"content_rating\\\":[1,2]`\",\n    \"2-4\": \"Content rating types according to OpenRTB 6.18\",\n    \"3-4\": \"Whether the request falls under the COPPA regulations, passed as a boolean\",\n    \"3-3\": \"`\\\"coppa\\\":[true]`\",\n    \"4-3\": \"`“language”:[”am”,”ar”]`\",\n    \"4-4\": \"Language of site on which ad is shown. Lookup based on ISO 639-1.\",\n    \"5-1\": \"I,E\",\n    \"5-2\": \"domain_list\",\n    \"5-3\": \"`\\\"domain_list\\\":[1,2]`\",\n    \"5-4\": \"Domain lists defined using custom_list object. Targeting domain_list[-1] matches any request with a blank or no domain\",\n    \"6-1\": \"I,E\",\n    \"6-2\": \"country\",\n    \"6-3\": \"`\\\"country\\\":[\\\"USA\\\",\\\"GBR\\\"]`\",\n    \"6-4\": \"Validated against ISO 3166-1 alpha-3\",\n    \"7-3\": \"`\\\"city\\\":[\\\"12345\\\",\\\"12346\\\"]`\",\n    \"7-4\": \"IDs based on MaxMind database which is based on Geonames. The IDs can be found in the Cities view.\",\n    \"8-3\": \"`\\\"lat_long_present\\\":[true]`\",\n    \"8-4\": \"Whether the user's latitude and longitude are present on the request. Note, this does not actually target the user's location, just filters impressions where the data is present.\",\n    \"9-3\": \"`\\\"region\\\":[\\\"USA/NJ\\\",\\\"USA/NM\\\",\\\"GBR/DEV\\\"]`\",\n    \"9-4\": \"Region in format `<country_code>/<region_code>` where country_code is ISO 3166-1 alpha-3 and regions are based on ISO_3166-2.\",\n    \"10-3\": \"`\\\"metro\\\":[\\\"500\\\",\\\"501\\\"]`\",\n    \"10-4\": \"Validated against DMA table, based on Google's metro codes, which are similar to Nielsen DMAs\",\n    \"11-3\": \"`\\\"zip\\\":[\\\"12345\\\",\\\"23456\\\"]`\",\n    \"11-4\": \"5 or more characters\",\n    \"14-3\": \"`\\\"deal_id\\\":[\\\"adx/foo_bar\\\"]`\",\n    \"14-4\": \"Deal ID in the format `<inventory_source>/<deal_id>` for example if the deal_id is `foo_bar` and it is from `inventory_source` `adx`, the deal_id is `adx/foo_bar`. Note, there is no validation currently that this is a valid deal.\",\n    \"16-3\": \"`\\\"environment_type\\\":[1]`\",\n    \"16-4\": \"0=web, 1=in-app\",\n    \"17-3\": \"`“inventory_source”:[1,2]`\",\n    \"17-4\": \"List of sources, eg. 1=”Rubicon”\",\n    \"18-3\": \"`“interstitial”:[true]`\",\n    \"18-4\": \"Whether the impression is an interstitial, passed as a boolean\",\n    \"19-3\": \"`“site”:[“adx/1”,”lr/2”]`\",\n    \"19-4\": \"Site names in form `<inventory_source>/<site_id>`. IDs can be found in post-campaign reporting.\",\n    \"21-3\": \"`“placement”:[”rb/1”,”adx/2”]`\",\n    \"21-4\": \"ID in the form `<inventory_source>/<placement_name>`. Placement name is not validated but can be found in post-campaign reporting. Buzz includes an incomplete list of Placements in the \\\"placements\\\" view.\",\n    \"25-1\": \"I,E\",\n    \"25-2\": \"ip_address_list\",\n    \"25-3\": \"`\\\"ip_address_list\\\":[\\\"3”]`\",\n    \"25-4\": \"Ip_address_list defined using [Custom List](doc:custom-lists) object.\",\n    \"26-3\": \"`\\\"ip_address\\\":[[\\\"1.1.1.1\\\",”2.2.2.2”],[\\\"3.3.3.3\\\",”4.4.4.4”]]`\",\n    \"26-4\": \"Validates a range of IP addresses\",\n    \"26-2\": \"ip_address\",\n    \"27-1\": \"I,E\",\n    \"27-2\": \"app_bundle_list\",\n    \"27-3\": \"`\\\"app_bundle_list\\\":[1,2]`\",\n    \"27-4\": \"AppBundle lists defined using [Custom Lists](doc:custom-lists) object. Targeting app_list `[-1]` matches any request with a blank or no app bundle\",\n    \"28-3\": \"`\\\"app_id_list\\\":[1,2]`\",\n    \"28-4\": \"AppID lists defined using [Custom Lists](doc:custom-lists)  object. Targeting app_list `[-1]` matches any request with a blank or no app ID\",\n    \"29-3\": \"`“app_name”:[”facebook”]`\",\n    \"29-4\": \"Strings, no validation\",\n    \"30-1\": \"I,E\",\n    \"30-2\": \"bandwidth\",\n    \"30-3\": \"`\\\"bandwidth\\\":[1,2]`\",\n    \"30-4\": \"Validates against `connectiontype` field defined in OpenRTB 5.18. Note, \\\"WIFI\\\" is a valid value.\",\n    \"31-3\": \"`“browser”:[”Firefox”,\\\"IE\\\"]`\",\n    \"31-4\": \"Browser name as a string.\",\n    \"32-3\": \"`“browser_version”:[\\\"Firefox/1”,\\\"Firefox/2\\\"]`\",\n    \"32-4\": \"Browser version to target, most typically to exclude. Most commonly, you will want to include a browser and exclude one or more browser_versions. If you exclude a browser, but include browser_versions, nothing will serve.\",\n    \"33-3\": \"`\\\"carrier\\\":[\\\"Verizon\\\",\\\"AT&T\\\"]`\",\n    \"33-4\": \"List of mobile carriers by name.\",\n    \"34-3\": \"`\\\"js_support\\\":[true]`\",\n    \"34-4\": \"Whether the device supports JavaScript, passed as a boolean.\",\n    \"35-3\": \"`“device_type”:[1,2]`\",\n    \"35-4\": \"Device type id as described in OpenRTB section 6.16.\",\n    \"36-3\": \"`\\\"device_make\\\":[\\\"Apple\\\",\\\"Samsung\\\"]`\",\n    \"36-4\": \"Device make as a string.\",\n    \"37-3\": \"`\\\"device_model\\\":[\\\"iPhone/6s\\\",\\\"iPhone/6c\\\"]`\",\n    \"37-4\": \"Device model as a string, including version number. Note OpenRTB keeps the model and the version as separate fields.\",\n    \"38-3\": \"`\\\"device_screen_size\\\":[\\\"S\\\",\\\"M\\\"]`\",\n    \"38-4\": \"Device screen size. Valid values are \\\"S\\\", \\\"M\\\", \\\"L\\\", \\\"XL\\\", and \\\"NA\\\"\",\n    \"39-3\": \"`“os”:[\\\"Windows\\\", \\\"OSX\\\"]`\",\n    \"39-4\": \"Specific OS versions identified by strings such as `Windows`\",\n    \"40-3\": \"`\\\"os_version\\\":[\\\"Windows/7\\\",\\\"Windows/Vista\\\"]`\",\n    \"40-4\": \"Specific version of OSes such as `Windows 7` or `OSX 10.8` in the format `<OS>/<Version>`\",\n    \"41-1\": \"I,E,\",\n    \"41-2\": \"segment\",\n    \"41-3\": \"`\\\"segment\\\":[\\\"FOO-1\\\", \\\"FOO-2\\\"]`\",\n    \"41-4\": \"Segments keys defined using segment object.\",\n    \"42-3\": \"`\\\"user_id\\\":[true]`\",\n    \"43-1\": \"IR, ER\",\n    \"43-2\": \"time_of_week\",\n    \"43-3\": \"`\\\"time_of_week\\\"=[[\\\"0\\\",\\\"5000”],[”5600\\\",\\\"1000”]]`\",\n    \"43-4\": \"Count in minutes from Sunday at midnight (0) to Saturday at 11:59 (10079) in range format `[<start>,<end>]`. Calculation is against EST.\",\n    \"44-1\": \"IR\",\n    \"44-3\": \"`\\\"line_item_start_end\\\"=[[\\n1436891253, 1439510400]]`\",\n    \"44-4\": \"This targeting key is set internally by system. The line item start and end times are converted into seconds since epoch and stored in the range format `[<start>, <end>]`.\",\n    \"45-1\": \"I,E\",\n    \"45-2\": \"companion_required\",\n    \"45-3\": \"`\\\"companion_required\\\":[true]`\",\n    \"46-3\": \"`“playback_method”:[1,2]\\t`\",\n    \"46-4\": \"Codes from 1-4 based on OpenRTB 6.6. Example 1= Auto-play with sound on.\",\n    \"47-3\": \"`“player_size”:[“S”,\\\"M\\\",”L”]`\",\n    \"47-4\": \"Small, medium, or large.\",\n    \"48-3\": \"`“start_delay”:[0,-1]`\",\n    \"48-4\": \"Codes from -2 to 0 based on OpenRTB 6.9. Buzz does not support an exact offset in seconds.\",\n    \"49-3\": \"`\\\"video_placement_type\\\":[1]`\",\n    \"49-4\": \"Whether the video is in-stream (1) or in-banner (0).\",\n    \"12-2\": \"zip_code_list\",\n    \"12-3\": \"`\\\"zip_code_list\\\":[115,116]`\",\n    \"12-4\": \"List of zip codes to include or exclude\",\n    \"20-2\": \"site_list\",\n    \"20-3\": \"`“site_list”:[123,124]`\",\n    \"20-4\": \"List of sites to include or exclude\",\n    \"22-2\": \"placement_list\",\n    \"22-3\": \"`“placement_list”:[123,124]`\",\n    \"22-4\": \"List of placements to include or exclude\",\n    \"1-0\": \"content\",\n    \"1-1\": \"I,E\",\n    \"1-2\": \"content_category\",\n    \"1-3\": \"`\\\"content_category\\\":[\\\"IAB1\\\",\\\"IAB2\\\"]`\",\n    \"1-4\": \"IAB categories from OpenRTB\",\n    \"13-1\": \"I,E\",\n    \"13-2\": \"auction_type\",\n    \"13-3\": \"`“auction_type”:[1]`\",\n    \"13-4\": \"The type of auction as declared by the inventory source:\\n`-1` - Unknown\\n`1` - First Price\\n`2` - Second Price\",\n    \"23-2\": \"publisher_id\",\n    \"24-2\": \"publisher_id_list\",\n    \"24-3\": \"`“publisher_id_list”:[123]`\",\n    \"24-4\": \"List of publisher IDs to include or exclude\",\n    \"23-3\": \"`“publisher_id”:[”rb/1”,”adx/2”]`\",\n    \"23-4\": \"ID in the form `<inventory_source>/<publisher_id>`. Publisher ID  is not validated but can be found in post-campaign reporting.\",\n    \"15-2\": \"deal_id_list\",\n    \"15-3\": \"`\\\"deal_id_list\\\":[123]`\",\n    \"15-4\": \"List of deal IDs to include or exclude\",\n    \"13-0\": \"inventory\"\n  },\n  \"cols\": 5,\n  \"rows\": 50\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Verbs\"\n}\n[/block]\nDifferent targeting modules can support different \"verbs\" in targeting. The table below describes the verbs:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Abbreviation\",\n    \"h-1\": \"Verb\",\n    \"h-2\": \"Usage\",\n    \"h-3\": \"Example\",\n    \"1-0\": \"E\",\n    \"0-0\": \"I\",\n    \"0-1\": \"include\",\n    \"0-2\": \"`\\\"include\\\":[{<key>:[<value>,<value>]}}`\",\n    \"0-3\": \"`{\\\"ip_address\\\":[{\\\"include\\\":{\\\"ip_address\\\":[\\\"0.0.0.0\\\"]}}]}`\",\n    \"1-1\": \"exclude\",\n    \"1-2\": \"`\\\"exclude\\\":[{<key>:[<value>,<value>]}}\\t`\",\n    \"2-0\": \"IR\",\n    \"2-1\": \"include_range\",\n    \"2-2\": \"`\\\"include_range\\\":[{<key>:[[<start>,<end>],[<start>,<end>]]}}`\",\n    \"2-3\": \"`{\\\"ip_address\\\":[{\\\"include_range\\\":{\\\"ip_address\\\":[[\\\"1.1.1.1\\\",\\\"2.2.2.2\\\"],[\\\"1.1.1.1\\\",\\\"2.2.2.2\\\"]]}}]}`\",\n    \"3-0\": \"ER\",\n    \"1-3\": \"`{\\\"ip_address\\\":[{\\\"exclude\\\":{\\\"ip_address\\\":[\\\"0.0.0.0\\\"]}}]}`\",\n    \"3-1\": \"exclude_range\",\n    \"3-2\": \"`\\\"exclude_range\\\":[{<key>:[[<start>,<end>],[<start>,<end>]]}}`\",\n    \"3-3\": \"`{\\\"ip_address\\\":[{\\\"exclude_range\\\":{\\\"ip_address\\\":[[\\\"1.1.1.1\\\",\\\"2.2.2.2\\\"],[\\\"1.1.1.1\\\",\\\"2.2.2.2\\\"]]}}]}`\",\n    \"4-0\": \"R\",\n    \"4-1\": \"require\",\n    \"4-2\": \"`\\\"require\\\":[{<key>:[<value>,<value>]}}\\t`\",\n    \"4-3\": \"`{\\\"segment\\\":[{\\\"require\\\":{\\\"segment\\\":[\\\"foo-1\\\"]}}]}`\"\n  },\n  \"cols\": 4,\n  \"rows\": 5\n}\n[/block]\nThe `Segment` module also allows two special verbs. First, `boolean` verb with the syntax:\n\n`{\"segment\":[{\"boolean\":\"segment=FOO-1 OR (segment=FOO-2 AND segment=FOO-3)\"}]}`\n\nAnd second, the `require` verb, which essentially acts like an AND and should be used in conjunction with an `include` verb. For example, if you wish to target a set of segments in an OR relationship you would use an `include` verb. But if you also wanted to assure that you matched a quality scoring segment, you would `require` that segment.","excerpt":"","slug":"list-of-targeting-modules-and-keys","type":"basic","title":"List of Targeting Modules and Keys"}

List of Targeting Modules and Keys


This document summarizes the existing targeting modules and keys. [block:parameters] { "data": { "h-0": "Module", "h-1": "Verb", "h-2": "Keys", "h-3": "Example", "h-4": "Notes", "0-0": "ad_size", "2-2": "content_rating", "3-2": "coppa", "4-2": "language", "5-0": "domain", "6-0": "geo", "7-2": "city", "8-2": "lat_long_present", "9-2": "region", "10-2": "metro", "11-2": "zip", "14-2": "deal_id", "16-2": "environment_type", "17-2": "inventory_source", "18-2": "interstitial", "19-2": "site", "21-2": "placement", "25-0": "ip_address", "26-1": "IR, ER", "27-0": "mobile_app", "28-2": "app_id_list", "29-2": "app_name", "30-0": "platform", "31-2": "browser", "32-2": "browser_version", "33-2": "carrier", "34-2": "js_support", "35-2": "device_type", "36-2": "device_make", "37-2": "device_model", "38-2": "device_screen_size", "39-2": "os", "40-2": "os_version", "41-0": "segment", "42-2": "user_id", "43-0": "time", "44-2": "line_item_start_end", "45-0": "video", "46-2": "playback_method", "47-2": "player_size", "48-2": "start_delay", "49-2": "video_placement_type", "0-1": "None, see note", "0-2": "ad_size", "0-3": "`\"ad_size\":[\"160x600\",\"600x160\"]`", "0-4": "ad_size is not available as a targeting criteria, but may be used in a bid_modifier expression. Sizes should be passed as `<width>x<height>`", "2-3": "`\"content_rating\":[1,2]`", "2-4": "Content rating types according to OpenRTB 6.18", "3-4": "Whether the request falls under the COPPA regulations, passed as a boolean", "3-3": "`\"coppa\":[true]`", "4-3": "`“language”:[”am”,”ar”]`", "4-4": "Language of site on which ad is shown. Lookup based on ISO 639-1.", "5-1": "I,E", "5-2": "domain_list", "5-3": "`\"domain_list\":[1,2]`", "5-4": "Domain lists defined using custom_list object. Targeting domain_list[-1] matches any request with a blank or no domain", "6-1": "I,E", "6-2": "country", "6-3": "`\"country\":[\"USA\",\"GBR\"]`", "6-4": "Validated against ISO 3166-1 alpha-3", "7-3": "`\"city\":[\"12345\",\"12346\"]`", "7-4": "IDs based on MaxMind database which is based on Geonames. The IDs can be found in the Cities view.", "8-3": "`\"lat_long_present\":[true]`", "8-4": "Whether the user's latitude and longitude are present on the request. Note, this does not actually target the user's location, just filters impressions where the data is present.", "9-3": "`\"region\":[\"USA/NJ\",\"USA/NM\",\"GBR/DEV\"]`", "9-4": "Region in format `<country_code>/<region_code>` where country_code is ISO 3166-1 alpha-3 and regions are based on ISO_3166-2.", "10-3": "`\"metro\":[\"500\",\"501\"]`", "10-4": "Validated against DMA table, based on Google's metro codes, which are similar to Nielsen DMAs", "11-3": "`\"zip\":[\"12345\",\"23456\"]`", "11-4": "5 or more characters", "14-3": "`\"deal_id\":[\"adx/foo_bar\"]`", "14-4": "Deal ID in the format `<inventory_source>/<deal_id>` for example if the deal_id is `foo_bar` and it is from `inventory_source` `adx`, the deal_id is `adx/foo_bar`. Note, there is no validation currently that this is a valid deal.", "16-3": "`\"environment_type\":[1]`", "16-4": "0=web, 1=in-app", "17-3": "`“inventory_source”:[1,2]`", "17-4": "List of sources, eg. 1=”Rubicon”", "18-3": "`“interstitial”:[true]`", "18-4": "Whether the impression is an interstitial, passed as a boolean", "19-3": "`“site”:[“adx/1”,”lr/2”]`", "19-4": "Site names in form `<inventory_source>/<site_id>`. IDs can be found in post-campaign reporting.", "21-3": "`“placement”:[”rb/1”,”adx/2”]`", "21-4": "ID in the form `<inventory_source>/<placement_name>`. Placement name is not validated but can be found in post-campaign reporting. Buzz includes an incomplete list of Placements in the \"placements\" view.", "25-1": "I,E", "25-2": "ip_address_list", "25-3": "`\"ip_address_list\":[\"3”]`", "25-4": "Ip_address_list defined using [Custom List](doc:custom-lists) object.", "26-3": "`\"ip_address\":[[\"1.1.1.1\",”2.2.2.2”],[\"3.3.3.3\",”4.4.4.4”]]`", "26-4": "Validates a range of IP addresses", "26-2": "ip_address", "27-1": "I,E", "27-2": "app_bundle_list", "27-3": "`\"app_bundle_list\":[1,2]`", "27-4": "AppBundle lists defined using [Custom Lists](doc:custom-lists) object. Targeting app_list `[-1]` matches any request with a blank or no app bundle", "28-3": "`\"app_id_list\":[1,2]`", "28-4": "AppID lists defined using [Custom Lists](doc:custom-lists) object. Targeting app_list `[-1]` matches any request with a blank or no app ID", "29-3": "`“app_name”:[”facebook”]`", "29-4": "Strings, no validation", "30-1": "I,E", "30-2": "bandwidth", "30-3": "`\"bandwidth\":[1,2]`", "30-4": "Validates against `connectiontype` field defined in OpenRTB 5.18. Note, \"WIFI\" is a valid value.", "31-3": "`“browser”:[”Firefox”,\"IE\"]`", "31-4": "Browser name as a string.", "32-3": "`“browser_version”:[\"Firefox/1”,\"Firefox/2\"]`", "32-4": "Browser version to target, most typically to exclude. Most commonly, you will want to include a browser and exclude one or more browser_versions. If you exclude a browser, but include browser_versions, nothing will serve.", "33-3": "`\"carrier\":[\"Verizon\",\"AT&T\"]`", "33-4": "List of mobile carriers by name.", "34-3": "`\"js_support\":[true]`", "34-4": "Whether the device supports JavaScript, passed as a boolean.", "35-3": "`“device_type”:[1,2]`", "35-4": "Device type id as described in OpenRTB section 6.16.", "36-3": "`\"device_make\":[\"Apple\",\"Samsung\"]`", "36-4": "Device make as a string.", "37-3": "`\"device_model\":[\"iPhone/6s\",\"iPhone/6c\"]`", "37-4": "Device model as a string, including version number. Note OpenRTB keeps the model and the version as separate fields.", "38-3": "`\"device_screen_size\":[\"S\",\"M\"]`", "38-4": "Device screen size. Valid values are \"S\", \"M\", \"L\", \"XL\", and \"NA\"", "39-3": "`“os”:[\"Windows\", \"OSX\"]`", "39-4": "Specific OS versions identified by strings such as `Windows`", "40-3": "`\"os_version\":[\"Windows/7\",\"Windows/Vista\"]`", "40-4": "Specific version of OSes such as `Windows 7` or `OSX 10.8` in the format `<OS>/<Version>`", "41-1": "I,E,", "41-2": "segment", "41-3": "`\"segment\":[\"FOO-1\", \"FOO-2\"]`", "41-4": "Segments keys defined using segment object.", "42-3": "`\"user_id\":[true]`", "43-1": "IR, ER", "43-2": "time_of_week", "43-3": "`\"time_of_week\"=[[\"0\",\"5000”],[”5600\",\"1000”]]`", "43-4": "Count in minutes from Sunday at midnight (0) to Saturday at 11:59 (10079) in range format `[<start>,<end>]`. Calculation is against EST.", "44-1": "IR", "44-3": "`\"line_item_start_end\"=[[\n1436891253, 1439510400]]`", "44-4": "This targeting key is set internally by system. The line item start and end times are converted into seconds since epoch and stored in the range format `[<start>, <end>]`.", "45-1": "I,E", "45-2": "companion_required", "45-3": "`\"companion_required\":[true]`", "46-3": "`“playback_method”:[1,2]\t`", "46-4": "Codes from 1-4 based on OpenRTB 6.6. Example 1= Auto-play with sound on.", "47-3": "`“player_size”:[“S”,\"M\",”L”]`", "47-4": "Small, medium, or large.", "48-3": "`“start_delay”:[0,-1]`", "48-4": "Codes from -2 to 0 based on OpenRTB 6.9. Buzz does not support an exact offset in seconds.", "49-3": "`\"video_placement_type\":[1]`", "49-4": "Whether the video is in-stream (1) or in-banner (0).", "12-2": "zip_code_list", "12-3": "`\"zip_code_list\":[115,116]`", "12-4": "List of zip codes to include or exclude", "20-2": "site_list", "20-3": "`“site_list”:[123,124]`", "20-4": "List of sites to include or exclude", "22-2": "placement_list", "22-3": "`“placement_list”:[123,124]`", "22-4": "List of placements to include or exclude", "1-0": "content", "1-1": "I,E", "1-2": "content_category", "1-3": "`\"content_category\":[\"IAB1\",\"IAB2\"]`", "1-4": "IAB categories from OpenRTB", "13-1": "I,E", "13-2": "auction_type", "13-3": "`“auction_type”:[1]`", "13-4": "The type of auction as declared by the inventory source:\n`-1` - Unknown\n`1` - First Price\n`2` - Second Price", "23-2": "publisher_id", "24-2": "publisher_id_list", "24-3": "`“publisher_id_list”:[123]`", "24-4": "List of publisher IDs to include or exclude", "23-3": "`“publisher_id”:[”rb/1”,”adx/2”]`", "23-4": "ID in the form `<inventory_source>/<publisher_id>`. Publisher ID is not validated but can be found in post-campaign reporting.", "15-2": "deal_id_list", "15-3": "`\"deal_id_list\":[123]`", "15-4": "List of deal IDs to include or exclude", "13-0": "inventory" }, "cols": 5, "rows": 50 } [/block] [block:api-header] { "type": "basic", "title": "Verbs" } [/block] Different targeting modules can support different "verbs" in targeting. The table below describes the verbs: [block:parameters] { "data": { "h-0": "Abbreviation", "h-1": "Verb", "h-2": "Usage", "h-3": "Example", "1-0": "E", "0-0": "I", "0-1": "include", "0-2": "`\"include\":[{<key>:[<value>,<value>]}}`", "0-3": "`{\"ip_address\":[{\"include\":{\"ip_address\":[\"0.0.0.0\"]}}]}`", "1-1": "exclude", "1-2": "`\"exclude\":[{<key>:[<value>,<value>]}}\t`", "2-0": "IR", "2-1": "include_range", "2-2": "`\"include_range\":[{<key>:[[<start>,<end>],[<start>,<end>]]}}`", "2-3": "`{\"ip_address\":[{\"include_range\":{\"ip_address\":[[\"1.1.1.1\",\"2.2.2.2\"],[\"1.1.1.1\",\"2.2.2.2\"]]}}]}`", "3-0": "ER", "1-3": "`{\"ip_address\":[{\"exclude\":{\"ip_address\":[\"0.0.0.0\"]}}]}`", "3-1": "exclude_range", "3-2": "`\"exclude_range\":[{<key>:[[<start>,<end>],[<start>,<end>]]}}`", "3-3": "`{\"ip_address\":[{\"exclude_range\":{\"ip_address\":[[\"1.1.1.1\",\"2.2.2.2\"],[\"1.1.1.1\",\"2.2.2.2\"]]}}]}`", "4-0": "R", "4-1": "require", "4-2": "`\"require\":[{<key>:[<value>,<value>]}}\t`", "4-3": "`{\"segment\":[{\"require\":{\"segment\":[\"foo-1\"]}}]}`" }, "cols": 4, "rows": 5 } [/block] The `Segment` module also allows two special verbs. First, `boolean` verb with the syntax: `{"segment":[{"boolean":"segment=FOO-1 OR (segment=FOO-2 AND segment=FOO-3)"}]}` And second, the `require` verb, which essentially acts like an AND and should be used in conjunction with an `include` verb. For example, if you wish to target a set of segments in an OR relationship you would use an `include` verb. But if you also wanted to assure that you matched a quality scoring segment, you would `require` that segment.