GuideReference
TrainingSupportCommunity

device_​characteristic


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.

OptionTypeDescriptionRequires
characteristicenum

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_​operatorenum

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_​operatorenum

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_​operatorenum

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_​valueboolean

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_​valuestring 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_​valuenumber

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_​valuestring

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_​sensitiveboolean

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_​wildcardboolean

Allows * and ? wildcard matches in 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"]}}