Quick Start: Videos

The following step-by-step workflow description is designed to help you get up and running quickly with adaptive video sets in Dynamic Media. After each step are cross-references to topic headings where you can find more information.

註解：

Before you work with video in Dynamic Media, make sure that your AEM admininistrator has already enabled and configured Dynamic Media Cloud Services.

Upload your master videos to the folders. You can upload video files that are up to 20 GB each. When you add videos to the folder, they are encoded according to the video processing profile that you assigned to the folder.

Working with video in Dynamic Media

Video in Dynamic Media is an end-to-end solution that makes it easy to publish high-quality Adaptive Video for streaming across multiple screens, including desktop, iOS, Android, Blackberry, and Windows mobile devices. An Adaptive Video Set groups versions of the same video that are encoded at different bit rates and formats such as 400 kbps, 800 kbps, and 1000 kbps. The desktop computer or mobile device detects the available bandwidth.

For example, on an iOS mobile device, it detects a bandwidth such as 3G, 4G, or Wi-Fi. Then, it automatically selects the right encoded video from among the various video bit rates within the Adaptive Video Set. The video is streamed to desktops, mobile devices, or tablets.

In addition, video quality is dynamically switched automatically if network conditions change on the desktop or on the mobile device. Also, if a customer enters full-screen mode on a desktop, the Adaptive Video Set responds by using a better resolution, thereby improving the customer’s viewing experience. Using Adaptive Video Sets provides you with the best possible playback for customers playing Dynamic Media video on multiple screens and devices.

The logic that a video player uses to determine which encoded video to play or to select during playback is based on the following algorithm:

Video player loads the initial video fragment based on the bit rate that is closest to the value that is set for "initial bitrate" in the player itself.

Video player switches based on changes to the bandwidth speed using the following criteria:

Player picks the highest bandwidth stream below or equal to the estimated bandwidth.

Player considers only 80% of the available bandwidth. However, if it is switching up, it is more conservative at only 70% to avoid overestimating and immediately switching back.

For managing single video and Adaptive Video Sets, the following is supported:

Uploading video from numerous supported video formats and audio formats and encoding video to MP4 H.264 format for playback across multiple screens. You can use predefined adaptive video presets, single video encoding presets, or customize your own encoding to control the quality and size of the video.

When an adaptive video set is generated, it includes MP4 videos.

Note: Master/source videos are not added to an Adaptive Video Set.

Video captioning in all HTML5 video viewers.

Organize, browse, and search video with full metadata support for efficient management of video assets.

Deliver Adaptive Video Sets to the web as well as to desktops, and mobile devices, including the iPhone, iPad, Android, Blackberry, and Windows phone.

Best practice: Using the HTML5 video viewer

The Dynamic Media HTML5 Video viewer presets are robust video players. You can use them to avoid many common issues that are associated with HTML5 video playback and issues associated with mobile devices such as lack of adaptive streaming delivery and limited desktop browser reach.

On the design side of the player, you can design all of the video player’s functionality using standard web development tools. For example, you can design the buttons, controls, and custom poster image background using HTML5 and CSS to help you reach your customers with a customized appearance.

On the playback side of the viewer, it automatically detects the browser’s video capability. It then serves the video using HLS streaming (adaptive video streaming). Or, if those delivery methods are not present then HTML5 progressive is used instead.

By combining into a single player the ability to design the playback components using HTML5 and CSS, have embedded playback, and use adaptive and progressive streaming depending on the browser’s capability, you extend the reach of your rich media content to both desktop and mobile users and ensure a streamlined video experience.

Playback of video on desktop computers and mobile devices using the HTML5 video viewer

For desktop and mobile adaptive video streaming, the videos used for bit rate switching are based on all MP4 videos in the Adaptive Video Set.

Video playback occurs using either HLS (HTTP Live Streaming) video streaming or progressive video download. In prior versions of AEM, such as 6.0, 6.1, and 6.2, videos were streamed over HTTP.

However, in AEM 6.3 and on, videos are now streamed over HTTPS (that is, HLS video streaming) because the DM gateway service URL always uses HTTPS as well. Note that there is no customer impact in this default behavior. That is, video streaming will always occur over HTTPS unless it is not supported by the browser. (see the following table). Therefore,

If you have an HTTPS website with HTTPS video streaming, streaming is fine.

If you have an HTTP website with HTTPS video streaming, streaming is fine and there are no mixed content issues from the web browser.

HLS (HTTP Live Streaming) is an Apple standard for adaptive video streaming that automatically adjusts playback based on network bandwidth capacity. It also lets the customer “seek” to any point in the video without the need to wait for the rest of the video to download (see also HTTP Live Streaming).

Progressive video is delivered by downloading and storing the video locally to a user’s desktop screen or mobile device.

The following table describes the device, browser, and playback method of videos on desktop computers and mobile devices using the Scene7 Video Viewer.

Device

Browser

Video playback mode

Desktop

Internate Explorer 9 and 10

Progressive download.

Desktop

Internate Explorer 11+

On Windows 8 and Windows 10 - Force use of HTTPS whenever HLS is requested. Known limitation: HTTP on HLS does not work in this browser/operating system combination

Architecture of Dynamic Media video solution

The following graphic shows the overall authoring workflow of videos that are uploaded and encoded by way of DMGateway and made available for public consumption.

Hybrid publishing architecture for videos

Best practices for encoding videos

The Dynamic Media Encode Video workflow encodes video if you have enabled dynamic media and set up video cloud services. This workflow captures workflow process history and failure information. See Monitoring video encoding and YouTube publishing progress. If you have enabled dynamic media and set up video cloud services, the Dynamic Media Encode Video workflow automatically takes effect when you upload a video. (If you are not using dynamic media, the DAM Update Asset workflow takes effect.)

Source video files

When you encode a video file, use a source video file of the highest possible quality. Avoid using previously encoded video files because these files are already compressed, and further encoding creates a subpar quality video.

The following table describes the recommended size, aspect ratio, and minimum bit rate that your source video files should have before you encode them:

Size

Aspect ratio

Minimum bit rate

1024 X 768

4:3

4500 kbps for most videos.

1280 X 720

16:9

3000 - 6000 kbps, depending on the amount of motion in the video.

1920 X 1080

16:9

6000 - 8000 kbps, depending on the amount of motion in the video.

Obtaining a file's metadata

You can obtain a file’s metadata by viewing its metadata using a video editing tool, or using an application designed for obtaining metadata. Following are instructions for using MediaInfo, a third-party application, to obtain a video file’s metadata:

Select and download the installer for the GUI version, and follow the installation instructions.

After installation, either right-click the video file (Windows only) and select MediaInfo, or open MediaInfo and drag your video file into the application. You see all metadata associated with your video file, including its width, height, and fps.

Aspect ratio

When you choose or create a video encoding preset for your master video file, make sure that the preset has the same aspect ratio as the master video file. The aspect ratio is the ratio of the width to the height of the video.

To determine the aspect ratio of a video file, obtain the file’s metadata and note the file’s width and height (see Obtaining a file's metadata above). Then use this formula to determine the aspect ratio:

width/height = aspect ratio

The following table describes how formula results translate to common aspect ratio choices:

Formula result

Aspect ratio

1.33

4:3

0.75

3:4

1.78

16:9

0.56

9:16

For example, a video that is 1440 width x 1080 height has an aspect ratio of 1440/1080, or 1.33. In this case you choose a video encoding preset with a 4:3 aspect ratio to encode the video file.

Bitrate

Bitrate is the amount of data that is encoded to make up a single second of video playback. The bitrate is measured in kilobits per second (Kbps).

註解：

Because all codecs use lossy compression, bitrate is the most important factor in video quality. With lossy compression, the more you compress a video file, the more the quality is degraded. For this reason, all other characteristics being equal (the resolution, frame rate, and codec), the lower the bitrate, the lower the quality of the compressed file.

When selecting a bitrate encoding, there are two types you can choose:

Constant Bitrate Encoding (CBR) - During CBR encoding, the bitrate or the number of bits per second is kept the same throughout the encoding process. CBR encoding persists the set data rate to your setting over the entire video. Also, CBR encoding does not optimize media files for quality but does save on storage space.
Use CBR if your video contains a similar motion level throughout the entire video. CBR is most commonly used for streaming video content. See also Using custom-added video encoding parameters.

Variable Bitrate Encoding (VBR) - VBR encoding adjusts the data rate down and to the upper limit you set, based on the data required by the compressor. This means that during a VBR encoding process the bitrate of the media file dynamically increases or decreases depending on the media files bitrate needs.
VBR takes longer to encode but produces the most favorable results; the quality of the media file is superior. VBR is most commonly used for http progressive delivery of video content.

When should you use VBR versus CRB?
When it comes to selecting VBR versus CBR, it is almost always recommended that you use VBR for your media files. VBR provides higher quality files at competitive bitrates. When you use VBR, be sure you use with two-pass encoding, and set the maximum bitrate to be 1.5x the target video bitrate.

When you choose a video encoding preset, take into account the target end user’s connection speed. Choose a preset with a data rate that is 80 percent of that speed. For example, if the target end user’s connection speed is 1000 Kbps, the best preset is one with a video data rate of 800 Kbps.

This table describes the data rate of typical connection speeds.

Speed (Kbps)

Connection type

256

Dial-up connection.

800

Typical mobile connection. For this connection, target a data rate in the range of 400 to a maximum of 800 for 3G experiences.

2000

Typical broadband desktop connection. For this connection, target a data rate in the 800–2000 Kbps range, with most targets averaging 1200–1500 Kbps.

5000

Typical high-broadband connection. Encoding in this upper range is not recommended because video delivery at this speed is not available to most consumers.

Resolution

Resolution describes a video file’s height and width in pixels. Most source video is stored at a high resolution (for example, 1920 x 1080). For streaming purposes, source video is compressed to a smaller resolution (640 x 480 or smaller).

Resolution and data rate are two integrally linked factors that determine video quality. To maintain the same video quality, the higher the number of pixels in a video file (the higher the resolution), the higher the data rate must be. For example, consider the number of pixels per frame in a 320 x 240 resolution and a 640 x 480 resolution video file:

Resolution

Pixels per frame

320 x 240

76,800

640 x 480

307,200

The 640 x 480 file has four times more pixels per frame. To achieve the same data rate for these two example resolutions, you apply four times the compression to the 640 x 480 file, which can reduce the quality of the video. Therefore, a video data rate of 250 Kbps produces high-quality viewing at a 320 x 240 resolution, but not at a 640 x 480 resolution.

In general, the higher data rate you use, the better your video looks, and the higher resolution you use, the higher data rate you need to maintain viewing quality (compared to lower resolutions).

Because resolution and data rate are linked, you have two options when encoding video:

Choose a data rate and then encode at the highest resolution that looks good at the data rate you chose.

Choose a resolution and then encode at the data rate necessary to achieve high-quality video at the resolution you chose.

When you choose (or create) a video encoding preset for your master video file, use this table to target the correct resolution:

Resolution

Height (pixels)

Screen size

240p

240

Tiny screen

300p

300

Small screen typically for mobile devices

360p

360

Small screen

480p

480

Medium screen

720p

720

Large screen

1080p

1080

High-definition large screen

Fps (Frames per second)

In the United States and Japan, most video is shot at 29.97 frames per second (fps); in Europe, most video is shot at 25 fps. Film is shot at 24 fps.

Choose a video encoding preset that matches the fps rate of your master video file. For example, if your master video is 25 fps, choose an encoding preset with 25 fps. By default, all custom encoding uses the master video file’s fps. For this reason, you do not need to explicitly specify the fps setting when you create a video encoding preset.

Video encoding dimensions

For optimal results, select encoding dimensions such that the source video is a whole multiple of all your encoded videos.

To calculate this ratio, you divide source width by encoded width to get the width ratio. Then, you divide source height by encoded height to get the height ratio.

If the resulting ratio is a whole integer, it means that the video is optimally scaled. If the resulting ratio is not a whole integer, it impacts video quality by leaving leftover pixel artifacts on the display. This effect is most noticeable when the video has text.

As an example, suppose that your source video is 1920 x 1080. In the following table, the three encoded videos provide the optimal encoding settings to use.

Encoded video file format

Publishing videos to YouTube

You can publish on-premise AEM video assets directly to a YouTube channel that you have previously created.

To publish video assets to YouTube, you set up AEM Assets with tags. You can associate these tags with one or more YouTube channels. If a video asset's tag matches the tag of a YouTube channel, then the video is published to YouTube. If the video asset does not have a tag, then it is not published to YouTube.

Publishing to YouTube bypasses the processing profile system in AEM and, therefore, the video encoding profile as well. This bypass occurs because YouTube has its own encoding so a video processing profile is not necessary. In most cases, however, it is expected that you will have already had your video assets go through a video processing profile. When you bypass the video processing profile and publish directly to YouTube, it simply means that your video asset in AEM Asset does not get a viewable thumbnail. It also mean that if you run in dynamicmedia run mode, videos that are not encoded will not work with any of the Dynamic Media asset types.

Publishing video assets to YouTube servers involves completing the following tasks to ensure safe and secure server-to-server authentication with YouTube:

Configuring Google Cloud settings

To publish to YouTube, you need a Google account. If you have a GMAIL account then you already have a Google account. If you do not have a Google account, you can easily create one. You need the account because you need credentials to publish video assets to YouTube. If you have an account already created, then skip this task and proceed to Adding one or more channels to YouTube.

註解：

The following steps were accurate at the time of this writing. However, Google periodically updates their websites without notice. As such, these steps may be slightly different.

On the Google Cloud Platform page, near the top, click Console. You may need Sign in using your Google account credentials.

On the Dashboard page, click Create Project.

In the New Project dialog box, enter in a project name.

Note that your project ID is based on your project name. As such, choose the project name carefully; it cannot be changed after it is created. Also, you will need to enter the same project ID again when you set up YouTube in Adobe Experience Manager later on. You may want to write down the project’s ID.

Click Create.

On your project’s Dashboard, in the Getting Started card, click Enable APIs and get credentials like keys.

Near the top of the Dashboard page, click Enable API.

On the Library page, under YouTube APIs, click YouTube Data API.

Near the top of the YouTube Data API v3 page, click Enable to turn it on.

To use the API, you may need credentials. If necessary, click Create Credentials.

From the Where will you be calling the API from? drop-down list, select Web Server (e.g. node.js, Tomcat).

Under What data will you be accessing? select User data.

Click What credentials do I need? button.

Under the Create an OAuth 2.0 client ID heading, enter a unique name.

In the text field under the Authorized Javascript origins heading, enter the following path, substituting your own domain and port number in the path, then press Enter to add the path to the list:

On the Credentials page, under the Set up the OAuth 2.0 consent screen heading, select the Gmail address that you are currently using.

In the text field under the Product name shown to users heading, enter what you want to show on the consent screen.

The consent screen is displayed to the AEM administrator when they authenticate to YouTube; AEM will contact YouTube for permission.

Click Continue.

Under the Download credentials heading, click Download.

Save the client_id.json file.

You will need this downloaded json file when you set up YouTube in Adobe Experience Manager later on.

Click Done.

Now you will create a YouTube channel.

Creating a YouTube channel

Publishing videos to YouTube requires that you have one or more channels. If you have already created a YouTube channel, you can skip this task and go to Adding tags for publishing.

注意：

Be sure you have already set up one or more channels in YouTube *before* you add channels under YouTube Settings in AEM (see Setting up YouTube in AEM below). If you fail to do this, you are not given any warning of no existing channels. However, Google authentication still occurs when you add a channel, but there is not an option to choose which channel the video is sent.

You can automate the setting of YouTube properties on upload of your videos. You accomplish this by creating a metadata processing profile in AEM.

To create the metadata processing profile, you are first going to copy values from the Field Label, Map to property, and Choices fields, all found in Metadata Schemas for video. Then, you will build your YouTube video metadata processing profile by adding those values to it.

To automate the setting of default YouTube properties for your uploaded videos:

In the upper-left corner of AEM, click the AEM logo, then in the left rail, click Tools (hammer icon) > Assets > Metadata Schemas.

Click default. (Do not add a checkmark to the selection box to the left of "default".)

On the default page, check the box to the left of video, then click Edit.

On the right side of the page, under the Settings tab, do the following:

In the Field Label text field, select and copy the value.
Paste the copied value into an open text editor. You are going to need this value later when you create your metadata processing profile. Leave the text editor open.

In the Map to property text field, select and copy the value.
Paste the copied value into the open text editor. You are going to need this value later when you create your metadata processing profile. Leave the text editor open.

Under Choices, select and copy the default value that you want to use (such as People & Blogs or Science & Technology).
Paste the copied value into the open text editor. You are going to need this value later when you create your metadata processing profile. Leave the text editor open.

On the right side of the page, under the Settings tab, do the following:

In the Field Label text field, select and copy the value.
Paste the copied value into an open text editor. You are going to need this value later when you create your metadata processing profile. Leave the text editor open.

In the Map to property text field, select and copy the value.
Paste the copied value into the open text editor. You are going to need this value later when you create your metadata processing profile. Leave the text editor open.

Under Choices, select and copy the default value that you want to use. Notice that the Choices are grouped in pairs of two. The bottom field in the pair is the default value that you want to copy, such as public, unlisted, or private.
Paste the copied value into the open text editor. You are going to need this value later when you create your metadata processing profile. Leave the text editor open.

Near the upper-right corner of the Metadata Schema Editor page, click Cancel.

In the upper-left corner of AEM, tap the AEM logo, then in the left rail, click Tools (hammer icon) > Assets > Metadata Profiles.

On the Metadata Profiles page, near the upper-right corner of the page, click Create. In the Add Metadata Profile dialog box, in the Profile title text field, enter the name YouTube Video.

On the Metadata Profile Editor page, click the Advance tab.

Add the copied YouTube Publishing values to the profile by doing the following:

On the right side of the page, click the Build Form tab.

Drag the component labeled Section Header to the left and drop it in the form area.

Click Field Label to select the component.

On the right side of the page, under the Settings tab, in the Field Label text field, enter YouTube Publishing.

Click the Build Form tab, then drag the component labeled Single Line Text and drop it below the YouTube Publishing heading that you just created.

Click Field Label to select the component.

On the right side of the page, under the Settings tab, paste the YouTube Publishing values (Field Label value and Map to property value) that you copied earlier, into their respective fields on the form. Paste the Choices value into the Default Value field.

Add the copied YouTube Privacy values to the profile by doing the following:

On the right side of the page, click the Build Form tab.

Drag the component labeled Section Header to the left and drop it in the form area.

Click Field Label to select the component.

On the right side of the page, under the Settings tab, in the Field Label text field, enter YouTube Privacy.

Click the Build Form tab, then drag the component labeled Single Line Text and drop it below the YouTube Privacy heading you just created.

Click Field Label to select the component.

On the right side of the page, under the Settings tab, paste the YouTube Publishing values (Field Label value and Map to property value) that you copied earlier, into their respective fields on the form. Paste the Choices value into the Default Value field.

Near the upper-right corner of the page, click Save.

Apply the YouTube Publishing metadata profile to the folders where you are going to upload videos. You will need to have both the Metadata Profile and the Video Profile set.

(Optional) Verifying the published video on YouTube

Publishing times can vary greatly depending on numerous factors that include the format of your master video, file size, and upload traffic. The publishing process can take anywhere from a few minutes to several hours. Also, be aware that higher resolution formats are rendered much more slowly. For example, 720p and 1080p take significantly longer to appear than 480p.

After eight hours if you you still see a status message that says Uploaded (processing, please wait), try removing the video from our site and uploading it again.

Linking YouTube URLs to your Web Application

You can obtain a YouTube URL string that is generated by Dynamic Media after you publish the video. When you copy the YouTube URL, it lands on the Clipboard so you can paste it as necessary to pages in your website or application.

註解：

The YouTube URL is not available to copy until you have published the video asset to YouTube.

To link YouTube URLs to your web application:

Navigate to the YouTube published video asset whose URL you want to copy, then select it.

Remember that YouTube URLs are only available to copy after you have first published the video assets to YouTube.

On the toolbar, click Properties.

Click the Advanced tab.

Under the YouTube Publishing heading, in the YouTube URL List, select and copy the URL text to your web browser to preview the asset or to add to your web content page.

Unpublishing videos to remove them from YouTube

When you unpublish a video asset in AEM, the video is removed from YouTube.

注意：

If you remove a video directly from within YouTube, AEM is unaware and continues to behave as if the video is still published to YouTube. Always unpublish a video asset from YouTube by way of AEM.

註解：

To remove content from YouTube, AEM uses the Unpublish from YouTube workflow, which lets you monitor progress and view any failure information.

In the upper-left corner of AEM, tap the AEM logo, then in the left rail, click Tools (hammer icon) > Assets.

Navigate to the video assets that you want to unpublish from your YouTube channel.

In an asset selection mode, select one or more published video assets.

On the toolbar, click Unpublish > Unpublish.

Monitoring video encoding and YouTube publishing progress

When you upload a new video to a folder that has video encoding applied or you publish your video to youtube, you can monitor how your video encoding/youtube publishing is progressing (or failing) in a number of ways. Actual YouTube publishing progress is only available via the logs but whether it fails or succeeds is listed in additional ways described in the following procedure. In addition, you may receive email notifications when a YouTube publish workflow or video encoding completes or is aborted.

Monitoring progress

To monitor progress (including failed encoding/YouTube publish):

View video encoding progress in your assets folder:

In card view, video encoding progress displays on the asset by percent. If there is an error, this information also displays on the asset.

In list view, video encoding progress displays in the Processing Status column. If there is an error, this message displays in that same column.

This column does not display by default. To enable the column, select View Settings from the views drop-down menu, and add the Processing Status column and tap or click Update.

View progress in the asset details. When you tap or click an asset, open the drop-down menu and select Timeline. To narrow it down to workflow activities like encoding or YouTube publishing, select Workflows.

Any workflow information such as encoding displays in the timeline. For YouTube publish, the Workflow timeline also includes the name of the YouTube channel and the YouTube video URL. In addition, you see any failure notifications in the Workflow timeline.

You may receive email notifications about aborted or failed workflow jobs. These email notifications are configurable by an administrator. See Configuring email notifications.

Configuring e-mail notifications

註解：

You may need administrative rights to access the Tools menu.

How you configure notification depends on whether you want notifications for encoding jobs or YouTube publishing jobs:

For encoding jobs, you can access the configuration page for all AEM workflow email notifications at Tools > Operations > Web Console and by searching for Day CQ Workflow Email Notification Service. See Configuring Email Notification in AEM. You can select/clear the check boxes for Notify on Abort or Notify on Complete accordingly.

For YouTube publishing jobs, do the following:

In AEM, select Tools > Workflow > Models.

Select the Publish to YouTube workflow and tap or click Edit.

Right-click the YouTube Upload workflow step and tap or click Edit.

Click the Arguments tab.

You can select or clear the following check boxes:

Publish Start

Publish Failure

Publish Completion, which includes information on channels and URLs

Clearing a check box means that you will not receive the specified email notification from the YouTube Publish workflow.

註解：

These emails are specific to YouTube and are in addition to the generic workflow email notifications. As a result, you may receive two sets of email notification - the generic notification available in the Day CQ Workflow Email Notification Service and one specific to YouTube depending on your configuration settings.

Viewing video reports

註解：

Video reports are available when you run Dynamic Media in hybrid mode; reports are not available when you run Dynamic Media in Scene7 mode.

Video Reports display several aggregate metrics across a specified period of time to help you monitor that published individual and aggregate videos are performing as expected. The following top metrics data are aggregated for all published videos across your entire website:

Video Starts

Completion Rate

Average time on video

Total time on video

Videos per visit

A table of all published videos is also listed so you can track the top viewed videos on your website based on total video starts.

When you tap a video name in the list it shows you the video’s audience retention (drop-off) report in the form of a line chart. The chart displays the number of views for any given moment of time during video playback. When you play the video, the vertical bar tracks in synchronization with the time indicator in the player. Drops in the line chart data indicate where your audience drops off from disinterest.

If the video was encoded outside of Adobe Experience Manager Dynamic Media, the audience retention (drop-off) chart and the Play Percentage data in the table are not available.

Tracking and reporting data is based exclusively on the use of Dynamic Media’s own video player and associated video player preset. As such, you cannot track and report on videos that are played by way of other video players.

By default, the first time you enter Video Reports, the report displays video data starting at the first of the current month and ends with the current month's date. However, you can override the default date range by specifying your own date range. The next time you enter Video Reports, the date range you specified is used.

For video reports to work correctly, a Report Suite ID is automatically created when Dynamic Media Cloud Services is configured. At the same time, the Report Suite ID is pushed to the Publish server so that it is available for the Copy URL feature when you preview assets. However, this requires that the Publish server be already set up. If the Publish server is not set up, you can still publish to see the video report, however, you will need to return to the Dynamic Media Cloud Configuration and tap OK.

To view video reports:

In the upper-left corner of AEM, tap the AEM logo, then in the left rail, tap Tools (hammer icon) > Assets > Video Reports.

On the Video Reports page, do one of the following:

Near the upper-right corner, tap the Refresh Video Report icon.
You only need to use Refresh if the end date of the report is the current day. This ensures that you see the video tracking that has occurred since the last time you ran the report.

Near the upper-right corner, tap the Date Picker icon.
Specify the beginning and end date range for which you want video data, and then tap Run Report.

The Top Metrics group box identifies various aggregate measurements for all published videos across your site.

In the table that lists the top published videos, tap a video name to play the video and also see the video’s audience retention (drop-off) report.

Viewing video reports based on a video viewer that you created using the Scene7 HMTL5 Viewer SDK

If you are using an out-of-box video viewer provided by Dynamic Media, or if you created a custom viewer preset based off of an out-of-box video viewer, then no additional steps are required to view video reports. However, if you have created your own video viewer based off the Scene7 HTML5 Viewer SDK, then use the following steps to ensure the your video viewer is sending tracking events to Dynamic Media Video Reports.

Use the Scene7 Viewers Reference and the Scene7 HTML5 Viewers SDK to create your own video viewers.

To view Video Reports based on a video viewer that you created using the Scene7 HTML5 Viewer SDK:

Navigate to any published video asset.

Near the upper-left corner of the asset's page, from the drop-down list, select Viewers.

Select any video viewer preset and copy the embed code.

In the embed code, find the line with the following:

videoViewer.setParam("config2", "<value>");

The config2 parameter enables tracking in HTML5 Viewers. It is also a company-specific preset that contains the configuration information for Video Reporting, and for customer-specific Adobe Analytics configurations.

The correct value for the config2 parameter is found in both the Embed Code and in the copy URL function. In the URL from the copy URL command, the parameter to look for is &config2=<value> . The value is almost always companypreset, but in some instances it can also be companypreset-1, companypreset-2, and so forth.

First, determine if you need the &preset parameter.
If the config2 parameter is companypreset, you do not need &preset=parameter.
If config2 is anything else, set the preset parameter the same as the config2 parameter. For example, if config2=companypreset-2, add &param2=companypreset-2 to the AppMeasurmentBridge.jsp URL.

After calling s7sdk.Utils.init(); create a TrackingManager instance to track events by adding the following:var trackingManager = new s7sdk.TrackingManager();

Connect components to TrackingManager by doing the following:
In the s7sdk.Event.SDK_READY event handler, attach the component you want to track to the TrackingManager.
For example, if the component is videoPlayer, addtrackingManager.attach(videoPlayer);
to attach the component to the trackingManager. To track multiple viewers on a page, use multiple tracking mangaer components.

Create the AppMeasurementBridge object by adding the following:var appMeasurementBridge = new AppMeasurementBridge(); appMeasurementBridge.setVideoPlayer(videoPlayer);

Add the tracking function by adding the following:trackingManager.setCallback(appMeasurementBridge.track,
appMeasurementBridge);

The appMeasurementBridge object has a built-in track function. However, you can provide your own to support multiple tracking systems or other functionality.

For more information, see Using the TrackingManager Component in the Scene7 HTML5 Viewer SDK User Guide available for download from Adobe Developer Connection.

Adding captions to video

You can extend the reach of your videos to global markets by adding captioning to single videos or to Adaptive Video Sets. By adding captioning you avoid the need to dub the audio, or the need to use native speakers to rerecord the audio for each different language. The video is played in the language that it was recorded. Foreign language subtitles appear so that people of different languages can still understand the audio portion.

Captioning also allows for greater accessibility by using closed captioning for people who are deaf or hard of hearing.

註解：

The video player that you use must support the display of captions.

Dynamic Media has the capability of converting caption files to JSON (JavaScript Object Notation) format. This conversion means you can embed the JSON text into a web page as a hidden but complete transcript of the video. Search engines can then crawl and index the content to make the videos more easily discoverable and give customers additional details about the video content.

There are both free and premium tools and services that you can use to author caption/subtitle files outside Dynamic Media. For example, to create a simple video caption file with no styling, you can use the following free online caption authoring and editing tool:

For best results, use the tool in Internet Explorer 9 or above, Google Chrome, or Safari.

In the tool, in the Enter URL of video file field, paste the copied URL of your video file and then click Load. See Obtaining a URL for an Asset to get the URL to the video file itself which you can then paste into the Enter URL of video file field. Internet Explorer, Chrome, or Safari can then natively play back the video.

Now follow the onscreen instructions from the site to author and save your WebVTT file. When you have finished, copy the caption file contents and paste it into a plain text editor and save it with a .vtt filename extension.

註解：

For global support of video subtitles in multiple languages, be aware that the WebVTT standard requires that you create separate .vtt files and calls for each language you want to support.

Generally, you want to name the caption VTT file the same name as the video file, and append it with the language locale, such as -EN, or -FR, or -DE, and so on. By doing so, it can help you with automating the generation of the video URLs using your existing web content management system.

In AEM, upload your WebVTT caption file into DAM.

Navigate to the published video asset that you want to associate with the caption file that you uploaded.

Remember that URLs are only available to copy after you have first published the assets.

For a pop-up video viewer experience, tap URL. In the URL dialog box, select and copy the URL to the Clipboard and then past the URL into a simple text editor. Append the copied URL of the video with the following syntax:

&caption=<server_path>/is/content/<path_to_caption.vtt_file,1>

Note the ,1 at the end of the caption path. Immediately following the .vtt filename extension in the path, you have the option to enable (turn on) or disable (turn off) the closed caption button on the video player bar by setting to ,1 or ,0, respectively.

For an embedded video viewer experience, tap Embed Code. In the Embed Code dialog box, select and copy the embed code to the Clipboard and then paste the code into a simple text editor. Append the copied embed code with the following syntax:

videoViewer.setParam("caption","<path_to_caption.vtt_file,1>");

Note the ,1 at the end of the caption path. Immediately following the .vtt filename extension in the path, you have the option to enable (turn on) or disable (turn off) the closed caption button on the video player bar by setting to ,1 or ,0, respectively.

Adding chapter markers to video

You can make your long form videos easier to watch and navigate by adding chapter markers to single videos or to Adaptive Video Sets. When a user plays the video, they can click the chapter markers on the video timeline (also known as the video scrubber) to easily navigate to their point of interest, or immediately jump to new new content, demonstrations, tutorials, and so on.

註解：

The video player that is used must support the use of chapter markers. Dynamic Media video players do support chapter markers but using third party video players may not.

If desired, you can create and brand your own custom video viewer with chapters instead of using a video viewer preset. For instructions on creating your own HTML5 viewer with chapter navigation, in the Adobe Scene7 Viewer SDK for HTML5 guide, reference the heading “Customizing Behavior Using Modifiers” under the classes s7sdk.video.VideoPlayer and s7sdk.video.VideoScrubber. The Adobe Scene7 Viewer SDK is available as a download from Adobe Developer Connection.

You create a chapter list for your video in much the same way that you create captions. That is, you create a WebVTT file. Note, however, that this file must be separate from any WebVTT caption file that you may also be using; you cannot combine captions and chapters into one WebVTT file.

You can use the following sample as an example of the format you use to create a WebVTT file with chapter navigation:

In the example above, Chapter 1 is the cue identifier and is optional. The cue time of 00:00:000 --> 01:04:364 specifies the start time and end time of the chapter, in 00:00:000 format. That last three digits are milliseconds and can be left as 000, if preferred. The chapter title of The bicycle store behind it all is the actual description of the chapter’s contents. The cue identifier, the starting cue time, and the chapter title all appear in a pop-up in the video player when a user hovers their mouse pointer over a visual cue point in the video’s timeline.

Because you are using an HTML5 video viewer, ensure that the chapter file you create follows the WebVTT (Web Video Text Tracks) standard. The chapter filename extension is .vtt. You can learn more information about the WebVTT captioning standard.

For global support of video chapters in languages other than English, be aware that the WebVTT standard requires that you create separate .vtt files and calls for each language you want to support.

Save the .vtt file in UTF8 encoding to avoid problems with character rendition in the chapter title text.

Generally, you want to name the chapter VTT file the same name as the video file, and append it with chapters. By doing so, it can help you with automating the generation of the video URLs using your existing web content management system.

Navigate to the published video asset that you want to associate with the chapter file that you uploaded. Remember that URLs are only available to copy after you have first published the assets. See Publishing Assets.

From the drop-down menu, then click or tap Viewers.

In the left rail, tap or click the video viewer preset name. A preview of the video is opened in a separate page.

In the left rail, at the bottom, click URL.

In the URL dialog box, select and copy the URL to the Clipboard, then past the URL into a simple text editor.

Append the copied URL of the video with the following syntax to associate it with the copied URL to your chapter file:

&navigation=<full_copied_URL_path_to_chapter_file.vtt>

For an embedded video viewer experience

Navigate to the published video asset that you want to associate with the chapter file that you uploaded. Remember that URLs are only available to copy after you have first published the assets. See Publishing Assets.

From the drop-down menu, then click or tap Viewers.

In the left rail, tap or click the video viewer preset name. A preview of the video is opened in a separate page.

In the left rail, at the bottom, click Embed.

In the Embed Code dialog box, select and copy the entire code to the Clipboard, then paste it into a simple text editor.

Append the embed code of the video with the following syntax to associate it with the copied URL to your chapter file:

About video thumbnails

You can choose from one of ten thumbnail images automatically generated by Dynamic Media to add to your video. The video player displays your selected thumbnail when a video asset is used with the Dynamic Media component in the authoring environment of AEM Sites, AEM Mobile, or AEM Screens. The thumbnail serves as a static picture that best represents the contents of your entire video and further encourages users to click the Play button.

Based on the total time of the video, Dynamic Media captures ten (default) thumbnail images at 1%, 11%, 21%, 31%, 41%, 51%, 61%, 71%, 81%, and 91% into the video. The ten thumbnails persist meaning that if you decide to choose a different thumbnail later on, you do not need to regenerate the series. You preview the ten thumbnail images and then select the one you want to use with your video. If you want to change to default you can use CRXDE Lite to configure the time interval that thumbnail images are generated. For example, if you only wanted to generate a series of four evenly spaced thumbnail images from your video, you can configure the interval time at 24%, 49%, 74%, and 99%.

Ideally, you can add a video thumbnail anytime after you upload your video but before you publish the video on your website.

If you prefer, you can choose to upload a custom thumbnail to represent your video instead of using a thumbnail generated by Dynamic Media. For example, you could create a custom thumbnail image that has the title of your video, an eye-catching opening image, or a very specific image captured from your video. The custom video thumbnail image that you upload should have a maximum resolution of 1280 x 720 pixels (minimum width of 640 pixels) and be no larger than 2MB.

註解：

Custom video thumbnails are only available when you run Dynamic Media - Hybrid mode.

Adding a video thumbnail

Navigate to an uploaded video asset that you want to add a video thumbnail.

In asset selection mode either from the List View or the Card View, tap the video asset.

On the toolbar, tap the View Properties icon (a circle with an "i" in it).

On the video's Properties page, tap Change Thumbnail.

On the Change Thumbnail page, on the toolbar, tap Select Frame.

Dynamic Media generates a series thumbnail images from your video, based on the default time interval or time interval you customized.

Preview the generated thumbnail images, then select the one you want to add to your video.

Tap Save Change.

The video's thumbnail image is updated to use the thumbnail you selected. If you later decide to change the thumbnail image, you can return to the Change Thumbnail page and select a new one.

If you configured new default time intervals, or you uploaded a new video to replace the existing video, you will need to have Dynamic Media regenerate the thumbnails.

Configuring the default time interval that video thumbnails are generated

When you configure and save the new default time interval, your change automatically applies only to videos that you upload in the future. It does not automatically apply the new default to videos that you previously uploaded. For existing videos, you must regenerate the thumbnails.