Video

You are reading the AEM 6.1 version of Video.
This documentation is also available for the following versions:  AEM 6.3  AEM 6.2  AEM 6.0 

This section describes working with video in Dynamic Media.

Quick Start: Video

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.

Note

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

See Configuring Dynamic Media Cloud Services.

  1. Upload your Dynamic Media videos by doing the following:

     

  2. Manage your Dynamic Media videos by doing any of the following:

     

  3. Publish your Dynamic Media videos by doing one of the following:

     

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:

  1. 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.
  2. Video player switches based on changes to the bandwidth speed using the following criteria:
    1. Player picks the highest bandwidth stream below or equal to the estimated bandwidth.
    2. 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 detailed technical information about the algorithm, see https://android.googlesource.com/platform/frameworks/av/+/master/media/libstagefright/httplive/LiveSession.cpp

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.
  • 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.

Adaptive video streaming is supported on a variety of iOS platforms. See Scene7 Viewers Reference Guide.

Dynamic Media supports mobile video playback for MP4 H.264 video. You can find Blackberry devices that support this video format at the following: Supported video formats on Blackberry.

You can find Windows devices that support this video format at the following: Supported video formats on Windows Phone

  • Play back the video using Dynamic Media Video Viewer Presets, including the following:
    • Single video viewers.
    • Mixed Media viewers that combine both video and image content.
  • Configure video players to meet your branding needs.
  • Integrate video to your website, mobile site, or mobile application with a simple URL or embed code.

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 Apple 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.

See also About HTML5 Viewers in the Adobe Scene7 Viewers Reference Guide.

Playback of video on desktop computer and mobile devices using the HTML5 Video Viewer

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

Video playback occurs using either HLS or progressive video. 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+ HLS video streaming.
Desktop Firefox 23-44 Progressive download.
Desktop Firefox 45 or later HLS video streaming.
Desktop Chrome HLS video streaming.
Desktop Safari (Mac) HLS video streaming.
Mobile Chrome (Android 6 or earlier) Progressive download.
Mobile Chrome (Android 7 or later) HLS video streaming.
Mobile Android (default browser) Progressive download.
Mobile Safari (iOS) HLS video streaming.
Mobile Chrome (iOS) HLS video streaming.
Mobile Blackberry HLS video streaming.

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.

file

Hybrid publishing architecture for videos

file

Best practices for encoding videos

The following are best-practice tips for encoding source video files.

For advice about video encoding, see the following:

 

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:

  1. Go to this web page: http://mediainfo.sourceforge.net/en/Download.

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

  3. 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).

 

Note

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.

 

Video Type

Width x Height

Width Ratio

Height Ratio

Source

1920 x 1080

1

1

Encoded

960 x 540

2

2

Encoded

640 x 360

3

3

Encoded

480 x 270

4

4

 

Encoded video file format

Dynamic Media recommends using MP4 H.264 video encoding presets. Because MP4 files use the H.264 video codec, it provides high-quality video but in a compressed file size.

Publishing videos to YouTube

You can automate the publishing of on-premise Adobe Experience Manager video assets directly to a YouTube channel that you have previously created.

To publish video assets to YouTube, you set up Adobe Experience Manager Assets with tags. You can associated these tags with one or more YouTube channel. 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 Processing Profile. When you bypass the Processing Profile/Video Profile and publish directly to YouTube, it simply means that your video asset in Adobe Experience Manager Asset does not get a viewable thumbnail.

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

  1. Configuring Google Cloud Settings.
  2. Adding one or more channels to YouTube.
  3. Setting up tags for publishing.
  4. Setting up YouTube in Adobe Experience Manager.
  5. Automating the setting of default YouTube properties for your uploaded videos.
  6. Publishing videos to your YouTube channel.
  7. Verifying the published video on YouTube.
  8. Linking YouTube URLs to your Web Application.

You can also unpublish videos to remove them from 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.

To configure Google Cloud settings:

 

  1. Create a new Google account.
    https://accounts.google.com/SignUp?service=mail
    If you already have a Google account, skip to the next step.

  2. On the Google Cloud Platform page, near the top, tap Go to my console. If Go to my console is not visible, you may need to tap Sign in using your Google account credentials.

  3. On the Google Developers page, tap Create Project.

  4. In the New Project dialog box, enter in a project name and a project ID.
    Choose the project ID carefully; it cannot be changed. Also, you will need to enter the project ID again when you set up YouTube in Adobe Experience Manager later on. You may want to write down the project ID.

  5. Check I have read and agree to all Terms of Service.

  6. Tap Create.

  7. On the left pane of the Google Developers Console page, under your project name, tap APIs & auth.

  8. In the right pane, tap YouTube Data API v3.

  9. In the YouTube Data API v3 page, tap Off to turn it on.

  10. In the Enable YouTube Data API v3 dialog box, check I have read and agree to both Google APIs Terms of Service and YouTube Data API v3 Terms of Service.

  11. Specify the email address that you created earlier. In the Product Name field, enter the text that will appear as the header for the content screen later when you add channels as part of the YouTube Settings in Adobe Experience Manager (see Setting up YouTube in Adobe Experience Manager), and then click Create.

  12. In the left pane, under the APIs & auth heading, tap Credentials.

  13. In the right pane, under the OAuth heading, tap Create New Client ID.

  14. In the Create Client ID dialog box, leave Web Application selected.

  15. In the Authorized Javascript origins field, paste in the following:

    http://<servername.domain>:<port#>

    For example, http://1a2b3c.mycompany.com:4321/

  16. In the Authorized redirect URI field, paste the following:

    http://<servername.domain>:<port#>/etc/cloudservices/youtube.youtubecredentialcallback.json

    For example, http://1a2b3c.mycompany.com:4321/etc/cloudservices/youtube.youtubecredentialcallback.json

  17. Tap Create Client ID.

  18. Under the Client ID for web application heading, tap Download JSON.

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

    Now you will add one or more channels to YouTube.

Adding one or more channels to Youtube

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

Caution

Be sure you have already set up one or more channels in YouTube *before* you add channels under YouTube Settings in Adobe Experience Manager (see Setting up YouTube in Adobe Experience Manager 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.

To add one or more channels to YouTube:

  1. Go to https://www.youtube.com and sign in using your Google account credentials.

  2. In the upper-right corner of the YouTube page, tap the blue box.

  3. Tap All my channels.

  4. On the "Use YouTube as..." page, tap Create a new channel.

  5. On the Create a new channel page, enter a name for the channel where you will publish your video assets.
    Remember the name you enter here because you will need to enter it again when you setup YouTube in Adobe Experience Manager.

  6. Select the category and content fields that you want for your channel.

  7. Check I agree to the Pages Terms.

  8. Tap Done.

  9. (Optional) If necessary, create additional channels.

    Now you will set up tags for publishing.

Setting up tags for publishing

To publish to your YouTube channels, Adobe Experience Manager associates tags to one or more channels. If you intend to use the default tags, then you can skip this task and go to Setting up YouTube in Adobe Experience Manager.

To set up tags for publishing:

 

  1. In the left rail, tap Tools > Operations > Tagging.

  2. Add tags as necessary.

    Now you will set up YouTube in Adobe Experience Manager.

Setting up YouTube in Adobe Experience Manager

  1. In the left rail, tap Tools > Operations > Cloud > Cloud Services.

  2. Under the Third Party Services heading, under YouTube, tap Configure now.

  3. In the Create Configuration dialog box, enter a title (mandatory) and name (optional) in the respective fields.

  4. Tap Create.

  5. In the YouTube Account Settings dialog box, in the Application Name field, enter the Google Project ID.
    You specified the project ID when you initially configured Google Cloud settings earlier.
    Leave this dialog box open; you will return to it in a moment.

  6. Using a plain text editor, open the JSON file that you downloaded and saved in the earlier task Configure Google Cloud settings.

  7. Select and copy the entire JSON text.

  8. Return to the YouTube Account Settings dialog box, in the JSON Config field,  paste the JSON text.

  9. Tap OK.

  10. To the right of Available Channels, tap + (plus sign icon).

  11. In Adobe Experience Manger, in the YouTube Channels dialog box, in the Title field, enter the name of the channel that you created in the task Adding a channel to YouTube.
    You can optionally add a description, if desired.

  12. Tap OK.

  13. YouTube/Google authentication.

    • Enter the Google username and password associated with the Google Project ID and the JSON text above.
    • Depending on how many channels your account has you see two or more items. Select a channel. Do not select the e-mail address because that is not a channel.
    • On the next page, tap Accept to allow access to this channel.

     

  14. On the Cloud Services > YouTube page, tap the pencil icon to edit the list of tags that you want to use.

  15. Tap the drop-down list icon (upside-down caret) to display the list of available tags in Adobe Experience Manager.

  16. Tap one or more tags to add them.
    To delete a tag you have added, select the tag, and tap X.

  17. When you are finished adding the tags you want, tap OK.
     

    Now you will publish videos to your YouTube channel.

(Optional) Automating the setting of default YouTube properties for your uploaded videos

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:

  1. In the left rail, tap Tools > Assets > Metadata Schemas.

  2. Tap default.

  3. Check the box to the left of video, then tap Edit.

  4. On the Edit Form page, tap the Advanced tab.

  5. Tap YouTube Category. (Do not tap the YouTube Category drop-down list.)

  6. 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.
  7. Near the middle of the Edit Form page, under YouTube Publishing, tap YouTube Privacy. (Do not tap the YouTube Privacy drop-down list.)

  8. 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.
  9. Near the upper-left corner of the Edit Form page, tap Cancel.

  10. In the left rail, tap Processing Profiles > Metadata Profiles. Tap the plus sign to create a new metadata profile. Name it "YouTube Video".

  11. On the Edit Form page, tap the Advance tab.

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

    • On the right side of the page, tap the Build Form tab.
    • Drag the component labeled Section Header to the left and drop it in the form area.
    • Tap Field Label.
    • On the right side of the Edit Form page, under the Settings tab, in the Field Label text field, enter YouTube Publishing.
    • Tap the Build Form tab, then drag the component labeled Multi Value Text to the left and drop it below the YouTube Publishing heading.
    • Tap Field Label.
    • On the right side of the Edit Form page, under the Settings tab, paste the three YouTube Publishing values (Field Value, Map to property, Default Value) that you copied earlier, into their respective fields on the form.
  13. Add the copied YouTube Privacy values to the profile by doing the following:

    • On the right side of the page, tap the Build Form tab.
    • Drag the component labeled Section Header to the left and drop it in the form area.
    • Tap Field Label.
    • On the right side of the Edit Form page, under the Settings tab, in the Field Label text field, enter YouTube Privacy.
    • Tap the Build Form tab, then drag the component labeled Multi Value Text to the left and drop it below the YouTube Publishing heading.
    • Tap Field Label.
    • On the right side of the Edit Form page, under the Settings tab, paste the three YouTube Privacy values (Field ValueMap to propertyDefault Value) that you copied earlier, into their respective fields on the form.
  14. Near the upper-right corner of the page, tap Done.

  15. Apply the YouTube Publishing metadata processing profile to the folders where you are going to upload videos. When you upload videos, the processing profile is automatically applied to each one.

    See Applying a processing profile to folders.

Publishing videos to your YouTube channel

Now you need to associate the tags you just added in the previous task to video assets. This process lets Adobe Experience Manager know which assets to publish to your YouTube channel.

To publish videos to your YouTube channel:

 

  1. Navigate to a video asset you want to publish to your YouTube channel.

  2. In an asset selection mode either from the Asset List View or the Asset Card View, select the video asset.

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

  4. On the toolbar, tap the Edit icon (a pencil).

  5. Tap in the Tags form field.

  6. In the Basic tab, under the Publish Status heading, in the Tags drop-down list, select one or more tags that are associated with one or more YouTube channels to which you want to publish the video.

  7. On the tookbar, tap the Save icon (check mark).

  8. On the toolbar, tap the Publish icon (earth globe without the X)  > Publish.

    You can optionally verify the published video on your YouTube channel.

(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.

To optionally verify the published video on YouTube:

 

  1. Select the channel you created.

  2. Tap the channel name that appears in the upper-right of your YouTube page.

  3. Tap Video Manager to see the progress of the video asset.

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.

Note

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:

  1. Navigate to the YouTube published video asset whose URL you want to copy, and tap the asset to open it.

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

     

  2. Near the upper-right corner of the page, tap the Views icon and select Properties.

  3. Tap the Advanced tab.

  4. Under YouTube Publishing, in the Published URLs group, 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 Adobe Experience Manager, the video is removed from YouTube.

To unpublish videos to remove them from YouTube:

 

  1. Sign in to your Adobe Experience Manager account.

  2. Tap Assets.

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

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

  5. On the toolbar, tap the Unpublish icon (earth globe with the X)  > Unpublish > Unpublish.

Viewing video reports

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.

See also Configuring Dynamic Media Cloud Services.

 

Note

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:

  1. In Adobe Experience Manager, in the left rail, tap Tools > Assets > Reports > Video Reports.

  2. 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.

     

  3. 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.

See Scene7 Viewers Reference Guide.

Download the Scene7 HTML Viewer SDK from Adobe Developer Connection.

See Adobe Developer Connection.

 

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

  1. Navigate to any published video asset.

  2. Near the upper-right corner, tap the View (eye) icon, and select Viewer Presets.

  3. Select any video viewer preset and copy the embed code.

  4. 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.

  5. In your custom video viewer code, add AppMeasurementBridge .jsp to the viewer page by doing the following:

    • 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.
    • Then, add the AppMeasurementBridge.jsp script:
      <script language="javascript" type="text/javascript" src="http://s7d1.scene7.com/s7viewers/AppMeasurementBridge.jsp?company=robindallas&preset=companypreset-2"></script>
  6. Create the TrackingManager component by doing the following:

    • 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, add
      trackingManager.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.

​