GuideReference
TrainingSupportCommunity
Reference

image_​manager_​video

  • Property Manager name: Image and Video Manager (Videos)
  • Behavior version: The v2023-01-05 rule format supports the image_​manager_​video behavior v2.0.
  • Rule format status: GA, stable
  • Access: Read/Write
  • Allowed in includes: Yes

Optimizes videos managed by Image and Video Manager for the requesting device. You can also use this behavior to generate API tokens to apply your own policies to matching videos using the Image and Video Manager API. To apply this behavior, you need to match on a file​_extension.

OptionTypeDescriptionRequires
enabledboolean

Applies Image and Video Manager's video optimization to the current content.

{"displayType":"boolean","tag":"input","type":"checkbox"}
resizeboolean

When enabled, scales down video for smaller mobile screens, based on the device's User-Agent header.

{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enabled","op":"eq","value":true}}
apply_​best_​file_​typeboolean

When enabled, automatically converts videos to the best file type for the requesting device. This produces the smallest file size that retains image quality, based on the user agent and the initial image file.

{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enabled","op":"eq","value":true}}
super_​cache_​regionenum

To optimize caching, assign a region close to your site's heaviest traffic.

use_​existing_​policy_​set is not true
{"displayType":"enum","options":["US","ASIA","AUSTRALIA","EMEA","JAPAN","CHINA"],"tag":"select"}
{"if":{"attribute":"useExistingPolicySet","op":"neq","value":true}}
US

United States.

ASIA

Asia.

AUSTRALIA

Australia.

EMEA

Europe, Middle East, and Africa.

JAPAN

Japan.

CHINA

China.

cp_​code_​originalobject

Select the CP code for which to track Image and Video Manager video traffic. Use this along with cp_​code_​transformed to track traffic to derivative video content.

{"displayType":"object","tag":"input","todo":true}
cp_​code_​original.descriptionstring

Additional description for the CP code.

cp_​code_​original.idinteger

Unique identifier for each CP code.

cp_​code_​original.namestring

The name of the CP code.

cp_​code_​original.productsarray

The set of products the CP code is assigned to.

cp_​code_​transformedobject

Select the CP code to identify derivative transformed video content.

{"displayType":"object","tag":"input","todo":true}
cp_​code_​transformed.descriptionstring

Additional description for the CP code.

cp_​code_​transformed.idinteger

Unique identifier for each CP code.

cp_​code_​transformed.namestring

The name of the CP code.

cp_​code_​transformed.productsarray

The set of products the CP code is assigned to.

use_​existing_​policy_​setboolean

Whether to use a previously created policy set that may be referenced in other properties, or create a new policy set to use with this property. A policy set can be shared across multiple properties belonging to the same contract. The behavior populates any changes to the policy set across all properties that reference that set.

{"displayType":"boolean","tag":"input","type":"checkbox"}
policy_​setobject

Identifies the existing policy set configured with Image and Video Manager API.

use_​existing_​policy_​set is true
{"displayType":"object","tag":"input","todo":true}
{"if":{"attribute":"useExistingPolicySet","op":"eq","value":true}}
advancedboolean

When disabled, applies a single standard policy based on your property name. Allows you to reference a rule-specific policy_​token for videos with different match criteria.

use_​existing_​policy_​set is false
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"useExistingPolicySet","op":"eq","value":false}}
policy_​tokenstring

Specifies a custom policy defined in the Image and Video Manager Policy Manager or the Image and Video Manager API. The policy name can include up to 64 alphanumeric, dash, or underscore characters.

advanced is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"advanced","op":"eq","value":true}}
policy_​token​Defaultstring

Specify the default policy identifier, which is registered with the Image and Video Manager API once you activate this property.

advanced is false
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"advanced","op":"eq","value":false}}