device_characteristic

Property Manager name: Device Characteristics
Criteria version: The v2024-10-21 rule format supports the device_characteristic criteria v1.3.
Rule format status: GA, stable
Access: Read/Write
Allowed in includes: Yes

Match various aspects of the device or browser making the request. Based on the value of the characteristic option, the expected value is either a boolean, a number, or a string, possibly representing a version number. Each type of value requires a different field.

Option	Type	Description	Requires
`characteristic`	enum	Aspect of the device or browser to match.		{"displayType":"enum","options":["BRAND_NAME","MODEL_NAME","MARKETING_NAME","IS_WIRELESS_DEVICE","IS_TABLET","DEVICE_OS","DEVICE_OS_VERSION","MOBILE_BROWSER","MOBILE_BROWSER_VERSION","RESOLUTION_WIDTH","RESOLUTION_HEIGHT","PHYSICAL_SCREEN_HEIGHT","PHYSICAL_SCREEN_WIDTH","COOKIE_SUPPORT","AJAX_SUPPORT_JAVASCRIPT","FULL_FLASH_SUPPORT","ACCEPT_THIRD_PARTY_COOKIE","XHTML_SUPPORT_LEVEL","IS_MOBILE"],"tag":"select"}
	`BRAND_NAME`	String value such as `Samsung` or `Apple`.
	`MODEL_NAME`	String value such as `SCH-I110`.
	`MARKETING_NAME`	String value such as `Samsung Illusion`.
	`IS_WIRELESS_DEVICE`	Boolean value.
	`IS_TABLET`	Boolean value, subset of `IS_MOBILE`.
	`DEVICE_OS`	String value.
	`DEVICE_OS_VERSION`	Version string value.
	`MOBILE_BROWSER`	String value.
	`MOBILE_BROWSER_VERSION`	Version string value.
	`RESOLUTION_WIDTH`	Number of pixels wide.
	`RESOLUTION_HEIGHT`	Number of pixels high.
	`PHYSICAL_SCREEN_HEIGHT`	Number of millimeters high.
	`PHYSICAL_SCREEN_WIDTH`	Number of millimeters wide.
	`COOKIE_SUPPORT`	Boolean value.
	`AJAX_SUPPORT_JAVASCRIPT`	Boolean value.
	`FULL_FLASH_SUPPORT`	Boolean value.
	`ACCEPT_THIRD_PARTY_COOKIE`	Boolean value.
	`XHTML_SUPPORT_LEVEL`	Numeric value.
	`IS_MOBILE`	Boolean value.
`string_match_operator`	enum	When the `characteristic` expects a string value, set this to `MATCHES_ONE_OF` to match against the `string_value` set, otherwise set to `DOES_NOT_MATCH_ONE_OF` to exclude that set of values.	`characteristic` is either: `BRAND_NAME`, `MODEL_NAME`, `MARKETING_NAME`, `DEVICE_OS`, `MOBILE_BROWSER`, `PREFERRED_MARKUP`, `HTML_PREFERRED_DTD`, `XHTML_PREFERRED_CHARSET`, `VIEWPORT_WIDTH`, `XHTMLMP_PREFERRED_MIME_TYPE`, `AJAX_PREFERRED_GEOLOC_API`, `XHTML_FILE_UPLOAD`, `XHTML_SUPPORTS_IFRAME`, `FLASH_LITE_VERSION`	{"displayType":"enum","options":["MATCHES_ONE_OF","DOES_NOT_MATCH_ONE_OF"],"tag":"select"} {"if":{"attribute":"characteristic","op":"in","value":["BRAND_NAME","MODEL_NAME","MARKETING_NAME","DEVICE_OS","MOBILE_BROWSER","PREFERRED_MARKUP","HTML_PREFERRED_DTD","XHTML_PREFERRED_CHARSET","VIEWPORT_WIDTH","XHTMLMP_PREFERRED_MIME_TYPE","AJAX_PREFERRED_GEOLOC_API","XHTML_FILE_UPLOAD","XHTML_SUPPORTS_IFRAME","FLASH_LITE_VERSION"]}}
	`MATCHES_ONE_OF`	The value is included as a `string_value`.
	`DOES_NOT_MATCH_ONE_OF`	The value is not included as a `string_value`.
`numeric_match_operator`	enum	When the `characteristic` expects a numeric value, compares the specified `numeric_value` against the matched client.	`characteristic` is either: `RESOLUTION_WIDTH`, `RESOLUTION_HEIGHT`, `PHYSICAL_SCREEN_HEIGHT`, `PHYSICAL_SCREEN_WIDTH`, `XHTML_SUPPORT_LEVEL`, `MAX_IMAGE_WIDTH`, `MAX_IMAGE_HEIGHT`, `VIEWPORT_INITIAL_SCALE`	{"displayType":"enum","options":["IS","IS_NOT","IS_LESS_THAN","IS_LESS_THAN_OR_EQUAL","IS_MORE_THAN","IS_MORE_THAN_OR_EQUAL"],"tag":"select"} {"if":{"attribute":"characteristic","op":"in","value":["RESOLUTION_WIDTH","RESOLUTION_HEIGHT","PHYSICAL_SCREEN_HEIGHT","PHYSICAL_SCREEN_WIDTH","XHTML_SUPPORT_LEVEL","MAX_IMAGE_WIDTH","MAX_IMAGE_HEIGHT","VIEWPORT_INITIAL_SCALE"]}}
	`IS`	Values are equal.
	`IS_NOT`	Values are not equal.
	`IS_LESS_THAN`	The `numeric_value` is less than the matched client.
	`IS_LESS_THAN_OR_EQUAL`	The `numeric_value` is less than or equal to the matched client.
	`IS_MORE_THAN`	The `numeric_value` is more than the matched client.
	`IS_MORE_THAN_OR_EQUAL`	The `numeric_value` is more than or equal to the matched client.
`version_match_operator`	enum	When the `characteristic` expects a version string value, compares the specified `version_value` against the matched client, using the following operators: `IS`, `IS_MORE_THAN_OR_EQUAL`, `IS_MORE_THAN`, `IS_LESS_THAN_OR_EQUAL`, `IS_LESS_THAN`, `IS_NOT`.	`characteristic` is either: `DEVICE_OS_VERSION`, `MOBILE_BROWSER_VERSION`	{"displayType":"enum","options":["IS","IS_NOT","IS_LESS_THAN","IS_LESS_THAN_OR_EQUAL","IS_MORE_THAN","IS_MORE_THAN_OR_EQUAL"],"tag":"select"} {"if":{"attribute":"characteristic","op":"in","value":["DEVICE_OS_VERSION","MOBILE_BROWSER_VERSION"]}}
	`IS`	The `version_value` equals the matched client.
	`IS_NOT`	The `version_value` does not equal the matched client.
	`IS_LESS_THAN`	The `version_value` is less than the matched client.
	`IS_LESS_THAN_OR_EQUAL`	The `version_value` is less than or equal to the matched client.
	`IS_MORE_THAN`	The `version_value` is more than the matched client.
	`IS_MORE_THAN_OR_EQUAL`	The `version_value` is more than or equal to the matched client.
`boolean_value`	boolean	When the `characteristic` expects a boolean value, this specifies the value.	`characteristic` is either: `IS_WIRELESS_DEVICE`, `IS_TABLET`, `COOKIE_SUPPORT`, `AJAX_SUPPORT_JAVASCRIPT`, `FULL_FLASH_SUPPRT`, `DUAL_ORIENTATION`, `ACCEPT_THIRD_PARTY_COOKIE`, `GIF_ANIMATED`, `JPG`, `PNG`, `XHTML_SUPPORTS_TABLE_FOR_LAYOUT`, `XHTML_TABLE_SUPPORT`, `PDF_SUPPORT`, `IS_MOBILE`	{"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"characteristic","op":"in","value":["IS_WIRELESS_DEVICE","IS_TABLET","COOKIE_SUPPORT","AJAX_SUPPORT_JAVASCRIPT","FULL_FLASH_SUPPRT","DUAL_ORIENTATION","ACCEPT_THIRD_PARTY_COOKIE","GIF_ANIMATED","JPG","PNG","XHTML_SUPPORTS_TABLE_FOR_LAYOUT","XHTML_TABLE_SUPPORT","PDF_SUPPORT","IS_MOBILE"]}}
`string_value`	string array	When the `characteristic` expects a string, this specifies the set of values.	`string_match_operator` is either: `MATCHES_ONE_OF`, `DOES_NOT_MATCH_ONE_OF`	{"displayType":"string array","tag":"input","todo":true} {"if":{"attribute":"stringMatchOperator","op":"in","value":["MATCHES_ONE_OF","DOES_NOT_MATCH_ONE_OF"]}}
`numeric_value`	number	When the `characteristic` expects a numeric value, this specifies the number.	`numeric_match_operator` is either: `IS`, `IS_NOT`, `IS_LESS_THAN`, `IS_LESS_THAN_OR_EQUAL`, `IS_MORE_THAN`, `IS_MORE_THAN_OR_EQUAL`	{"displayType":"number","tag":"input","type":"number"} {"if":{"attribute":"numericMatchOperator","op":"in","value":["IS","IS_NOT","IS_LESS_THAN","IS_LESS_THAN_OR_EQUAL","IS_MORE_THAN","IS_MORE_THAN_OR_EQUAL"]}}
`version_value`	string	When the `characteristic` expects a version number, this specifies it as a string.	`version_match_operator` is either: `IS`, `IS_NOT`, `IS_LESS_THAN`, `IS_LESS_THAN_OR_EQUAL`, `IS_MORE_THAN`, `IS_MORE_THAN_OR_EQUAL`	{"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"versionMatchOperator","op":"in","value":["IS","IS_NOT","IS_LESS_THAN","IS_LESS_THAN_OR_EQUAL","IS_MORE_THAN","IS_MORE_THAN_OR_EQUAL"]}}
`match_case_sensitive`	boolean	Sets a case-sensitive match for the `string_value` field.	`string_match_operator` is either: `MATCHES_ONE_OF`, `DOES_NOT_MATCH_ONE_OF`	{"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"stringMatchOperator","op":"in","value":["MATCHES_ONE_OF","DOES_NOT_MATCH_ONE_OF"]}}
`match_wildcard`	boolean	Allows wildcards in the `string_value` field, where `?` matches a single character and `*` matches zero or more characters.	`string_match_operator` is either: `MATCHES_ONE_OF`, `DOES_NOT_MATCH_ONE_OF`	{"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"stringMatchOperator","op":"in","value":["MATCHES_ONE_OF","DOES_NOT_MATCH_ONE_OF"]}}