device_characteristic

Suggest Edits

Version: `v2025-02-18`	Includes use: Yes

Criterion name: Device Characteristics

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.

data "akamai_property_rules_builder" "device_characteristic" {
  rules_v2025_02_18 {
    name     = "Device Characteristics"
    comments = "Matches aspects of the device or browser making the request."
    criterion {
      device_characteristic {
        characteristic = "IS_WIRELESS_DEVICE"
        boolean_value = true
      }
    }
  }
}

"criterion": [
  {
    "name": "deviceCharacteristic",
    "options": {
      "characteristic": "IS_WIRELESS_DEVICE",
      "booleanValue": true
    }
  }
]

Options

Option	Description
`characteristic`	Enum Aspect of the device or browser to match. Value is one of: `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 \| Requires Requires `characteristic` is one of: `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_REFERRED_GEOLOC_API` `XHTML_FILE_UPLOAD` `XHTML_SUPPORTS_IFRAME` `FLASH_LITE_VERSION` Specifies the logic of the operator. Value is one of: `MATCHES_ONE_OF`. Matches against the `string_value` set. `DOES_NOT_MATCH_ONE_OF` Excludes the set of values.
`numeric_match_operator`	Enum \| Requires Requires `characteristic` is one of: `RESOLUTION_WIDTH` `RESOLUTION_HEIGHT` `PHYSICAL_SCREEN_HEIGHT` `PHYSICAL_SCREEN_WIDTH` `XHTML_SUPPORT_LEVEL` `MAX_IMAGE_WIDTH` `MAX_IMAGE_HEIGHT` `VIEWPORT_INITIAL_SCALE` Specifies the logic of the operator. Value is one of: `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 \| Requires Requires `characteristic` is one of: `DEVICE_OS_VERSION` `MOBILE_BROWSER_VERSION` Specifies the logic of the operator. Value is one of: `IS`. The `version_value` equals the matched client. `IS_NOT`. The `version_value` doesn't 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 \| Requires Requires `characteristic` is one of: `IS_WIRELESS_DEVICE` `IS_TABLET` `COOKIE_SUPPORT` `AJAX_SUPPORT_JAVASCRIPT` `FULL_FLASH_SUPPORT` `DUAL_ORIENTATION` `ACCEPT_THIRD_PARTY_COOKIE` `GIF_ANIMATED` `JPG` `PNG` `XHTML_SUPPORTS_TABLE_FOR_LAYOUT` `XHTML_TABLE_SUPPORT` `PDF_SUPPORT` `IS_MOBILE` When the `characteristic` expects a boolean value, this specifies the value.
`string_value`	String array \| Requires Requires `string_match_operator` is one of: `MATCHES_ONE_OF` `DOES_NOT_MATCH_ONE_OF` When the `characteristic` expects a string, this specifies the set of values.
`numeric_value`	Number \| Requires Requires `numeric_match_operator` is one of: `IS` `IS_NOT` `IS_LESS_THAN` `IS_LESS_THAN_OR_EQUAL` `IS_MORE_THAN` `IS_MORE_THAN_OR_EQUAL` When the `characteristic` expects a numeric value, this specifies the number.
`version_value`	String \| Requires Requires `version_match_operator` is one of: `IS` `IS_NOT` `IS_LESS_THAN` `IS_LESS_THAN_OR_EQUAL` `IS_MORE_THAN` `IS_MORE_THAN_OR_EQUAL` When the `characteristic` expects a numeric value, this specifies the number.
`match_case_sensitive`	Boolean \| Requires Requires `string_match_operator` is one of: `MATCHES_ONE_OF` `DOES_NOT_MATCH_ONE_OF` Sets a case-sensitive match for the `string_value` field.
`match_wild_card`	Boolean \| Requires Requires `string_match_operator` is one of: `MATCHES_ONE_OF` `DOES_NOT_MATCH_ONE_OF` Allows wildcards in the `string_value` field, where `?` matches a single character and `*` matches zero or more characters.

Updated 21 days ago