deviceCharacteristic


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"]}}