Quick Start: Creating and Publishing an In-Page Experience

Product(s)
Gallery
Role(s)
Studio User
Task(s)
Create an In-Page Experience
Get Started using Gallery

The purpose of this Quick Start is to show you how you can create an in-page experience using Brightcove Gallery.

After completing this Quick Start, you should be able to:

  • Use Gallery to create a new experience
  • Add videos to an in-page experience
  • Customize and style an in-page experience
  • Preview and publish an in-page experience

Audience

Any Video Cloud publisher who wants to create in-page experiences that can be embedded in web pages.

Prerequisites

Using the Quick Start assets

If you would like to follow along using the sample videos provided with this Quick Start, perform the following steps.

  1. Download the sample file.
  2. Use the Upload module to upload the videos to your Video Cloud account.
  3. Use the Media module to create an Animals playlist and add the videos to the playlist.
  4. Use the Players module to create a new Brightcove Player called Gallery Player.

Note: The image in the sample file will be used later in the Quick Start.

Using Gallery to create an in-page experience

To create an in-page experience using Brightcove Gallery, you will complete the following tasks:

Selecting an account

Depending on your Video Cloud subscription, you may have access to multiple Video Cloud accounts. Before getting started, make sure you are using the correct account.

  1. Login to Video Cloud Studio.
  2. The current Video Cloud account name will appear in the upper right corner of the page. If you have multiple accounts, click the account selector drop down and select the account you would like to create the in-page experience in. Note that this should also be the account that has the videos you want to use as well.
  3. Click Gallery in the navigation header.
  4. If this is your first time using Gallery, you will be prompted to enter your Video Cloud API read token. This is not required when creating an in-page experience.

Creating a new in-page experience

To create a new in-page experience, follow these steps.

  1. Click the Experiences link at the top of the page.
  2. If you haven't created any experiences, a no projects page will appear. Click Create next to In-Page.

    If you have existing experiences, click New Experience and then click the In-Page link at the top of the page.

  3. A list of In-Page experience templates will be displayed. Locate the Vertical Playlist template and click Choose.

    Note: Once you select a template it can't be changed. For more information in-page experience templates, see the Overview of Gallery In-Page Experience Templates topic.

  4. Enter a Experience Title and Experience Description. For the Layout Size, select Responsive.

    Note: These values can be changed later. This is covered later in this Quick Start.

  5. Click Create Experience.

The layout editor will open. The experience title will appear at the top of the page. The title can be changed as part of the experience details.

Customizing the experience

Objects can be added to the experience to customize the appearance. In-page experiences have different states and each state can be customized. The following states are available to customize:

  • BEFORE PLAY - How the experience will appear when first rendered, before any video playback has started
  • PLAYING - How the experience will appear when a video is being played
  • AFTER PLAY - How the experience will appear after a video plays

To edit the different states, click a state and then add components to the experience as needed. For more information, see Customizing an In-Page Experience.

To add objects to an in-page experience, follow these steps.

  1. Click LAYOUT in the left navigation.
  2. Click the BEFORE PLAY state. Plus icons () indicate where components can be added to the experience. Click the plus icon at the top of the experience. The component picker will open.
  3. Click on the Image component. Click the browse link and select an image to use as a header for the experience. Note that the Quick Start sample files include an image that can be used.
  4. Click Save. The image will appear on the experience.
  5. Click the plus icon above the image component and add a Text component to the experience. Enter some text and then click Save.
  6. Confirm that the image and text appear on the experience.

To edit any of the component properties, or to delete a component, hover over the component and click the edit or delete icons.

Adding videos to the experience

Depending on the template that was selected, the experience may display one or more videos at a time. Individual videos can be added to an experience or a playlist can be selected. For more information on adding videos to an in-page experience, see Adding Videos to an In-Page Experience.

To add videos to an in-page experience, follow these steps.

  1. Click VIDEOS icon in the left navigation.
  2. Click Add Videos.
  3. Click Manual and select videos to add, OR, click Playlist and browse and select the Animals playlist you created with the sample videos.
  4. Click Select. The list of videos will display.

Adding interactivity to a video

Link and card interactions can be added to videos. Interactions are displayed as the video is played. For more information on adding interactivity to an experience, see Adding Interactions to an In-Page Experience.

To configure interactivity for a video, follow these steps.

  1. Click VIDEOS icon in the left navigation.
  2. Select a video to add interactivity to and click the link icon () in the Actions column.
  3. Add Link Text and a Link URL. The preview player will display a preview of the link.
  4. Click the Configure link.
  5. Click the switch to % link. Set the Start Time to be the 50% point in the video.
  6. For the Duration, check Until the video ends.

    Note: The slider under the preview player can also be used to the set the start time and duration for the link.

  7. Click the Design link. Set the link to appear in the bottom right of the player.
  8. Click Save. A list of all interactions configured for the video will be displayed.
  9. Click the X in the dialog title to close the interactivity editor.

Videos with interactivity will display an icon in the Interactivity column indication the type(s) of interactions that have been configured.

Customizing the style

The style controls the fonts and colors that are used on the experience. For more information on customizing the style, see Customizing the Style of an In-Page Experience.

To configure the style, follow these steps.

  1. Click STYLE in the left navigation.
  2. Locate the GLOBAL style. Click the Text Color circle and change the text color to Red. The text component that was added to the experience earlier should change to red.
  3. Click the X to close the color picker.
  4. Locate the VIDEO TITLE style. Click the Text Color circle and change the text color to Blue. Click the X to close the color picker.
  5. Scroll the left navigation to the top and click on the Back to Layout link.

Configuring the experience settings

The experience settings control various aspects of the experience such as the player to use, social settings and other settings. For more information on customizing the settings, see Configuring the Settings for an In-Page Experience.

To configure the experience settings, follow these steps.

  1. Click SETTINGS > Player in the left navigation.
  2. Use the Available Players dropdown list to select the Gallery Player you created earlier. This is the player that will be used on the in-page experience.
  3. Check the Advance to next video automatically option.
  4. Click Save.
  5. Click SETTINGS > Social in the left navigation.
  6. Select how the social sharing options should display.
  7. Select the social media sites videos can be shared to. Some sites also allow custom messages to be posted.
  8. Click Save.

Reviewing the experience details

The experience details is where the experience title and sizing is configured. For more information on customizing experience details, see Configuring the Details for an In-Page Experience.

To configure the experience details, follow these steps.

  1. Click OVERVIEW in the left navigation.
  2. If needed, edit the experience title and description.
  3. Confirm the Layout Size is set to Responsive. When the layout size is set to responsive, it will resize to fit its container on the page.
  4. If any changes were made, click Save.

Previewing and publishing the in-page experience

Previewing an in-page experience lets you see how the experience is going display without having to view it inside the Gallery interface. Publishing the in-page experience will generate the embed code needed to display the experience inside of a web page. For more information on previewing and publishing an in-page experience, see Previewing and Publishing an In-Page Experience.

  1. To preview an in-page experience:
    • From the main Experiences page, select the experience and then click Preview
    • From the top right of any page, click Preview
  2. A desktop preview will open in a new browser tab.
  3. The icons in the left margin can be used to preview the experience on a desktop, tablet or mobile device. A mobile preview is displayed below.
  4. To publish an in-page experience, click Publish & Embed.
  5. Click Publish Changes.
  6. The publishing process will begin and when done, the Publishing Status will change to This experience is up to date.

After the in-page experience is published, the Shareable URL can be shared with others so they can preview the experience. The Embed Code can be used to embed the in-page experience in an existing web page.

Note: Any changes you make to an in-page experience will require that the experience be republished. NO changes to any existing embed code are required UNLESS you change the layout size from a fixed size to responsive or vice versa.

Note: If the experience size is set to Responsive, the Recommended embed code must be used. The No JavaScript embed code is not responsive.