{{ page.title }}

{{ page.description }}

Introduction

OTT Catalog Export generally assists in getting your OTT assets available on platform searches, for instance Apple and Roku, as well as in search engines. For instance, the functionality provides viewers with the ability to find movies and TV shows that are available on Beacon iOS and tvOS apps using the built-in search utilities on iPhones and Apple TV devices. The discovered titles are then either opened in the OTT app or the viewer is guided through app installation and then opens the app to view the desired content.

Specifically, the OTT Catalog Export functionality available in Studio is used for the following tasks:

The general tasks to create one of these data reports is:

  1. Add a new template. Note that for SEO Page HTML templates this is all that is required, for other template types proceed to the next step.
  2. Create a new job that uses the template.
  3. Run the job, either manually or on a schedule, to produce the desired data report.

Starting in the Adding a new template section below are enumerated steps to perform these tasks.

Overview of the processes

Using OTT Catalog Export tools to implement and improve searching for your video assets is a process. The process involves you, Brightcove's OTT delivery team and sometimes the platform vendor themselves. Following are quick overviews for Apple, Google and Roku.

Apple

First, you need to work with Brightcove's OTT Delivery Team and Apple to prepare for the universal search implementation. Typically, one Apple UMC Catalog CSV template is created for each supported asset type (series, season, episode, movie), and a single Apple UMC Availability CSV template is created that aggregates availability info for all asset types. The data in all the reports needs to match the current state of your catalog. You again work with Brightcove's OTT Delivery Team to be sure the CSV reports are in the correct format. Once the format is verified, you submit the data to Apple. Once the process is working, you periodically submit new data to Apple.

Note that the initial setup and verification process can take up to several months.

Google Search

The Google site map XML and Sitemap index XML templates work together to improve search results using sitemaps. You generate one or more sitemaps (possibly more than one because of size) and the sitemap index is the top level file that points to your sitemap(s). Once the process is working, no further manual submissions are needed, assuming that a stored job was created to automatically refresh the sitemap(s) periodically. As long as the stored job continues to refresh the sitemap(s), Google automatically crawls those sitemaps periodically as well.

SEO Page HTML

The SEO Page HTML templates work with the Google site map XML and Sitemap index XML templates to provide enhanced search engine optimization (SEO) as well as other benefits, detailed next, in social media sharing of your assets. When the OTT app backend detects a search crawler trying to load one of the web app pages, it fetches a corresponding SEO-optimized page from the syndication service and return that page content to the crawler instead of the normal, SEO-unfriendly web app page.

Unlike other template types, SEO Page HTML templates are used to generate asset-specific results in response to on-demand requests from the webapp. As a result, there is no need to create or run stored jobs that include template instances of this type.

Benefits

The benefits of the SEO optimization are:

To implement this feature, you need to use the SEO Page HTML, Google site map XML and Sitemap index XML templates to generate the required data and pass these reports to Brightcove's OTT Delivery Team. Brightcove personnel then configure your app to use the SEO functionality. Periodically you need to regenerate the data and post to the location directed by Brightcove.

Roku

You need first to go to the Roku site and complete forms that enable you to submit syndication data. Once completed, you generate data using the Roku Search Feed template. Using that data, you work with Brightcove's OTT Delivery Team to submit it to Roku. Once the process is working, no further manual submissions are needed, assuming that a stored job was created to automatically refresh the search feed(s) periodically. As long as the stored job continues to refresh the search feed(s), Roku automatically, periodically pulls the latest feed from the results URL.

Adding a new template

To add a new template follow these steps:

  1. In Studio, select Layout, then click the gear icon to enter the app settings.
    click gear icon
  2. From App settings, under Data export click OTT Catalog Export.
    OTT Catalog Export
  3. Be sure Configure templates is selected, then click Create new template.
    add new template
  4. Supply a Template name. This name is for internal use and viewed only in Studio.
  5. Choose a Platform and format type. Based on your selection different options are presented.
  6. Complete the form based on the type selected.
  7. Click Save.

Creating and using a new job

  1. From the App settings screen be sure Manage jobs is selected, then click Create new job.
    create new job
  2. Supply a Job name. This name is for internal use and viewed only in Studio.
  3. Select the template(s) you wish to use for this job by clicking the checkbox(es) in front of the template(s) name.
  4. From the Schedule job run frequency choose your wanted frequency. Note that repeated time is based on the current day of week and time the selection is made. This can be changed by running a job manually, which resets the day of week and time.
  5. Click Confirm.
  6. Back on the Manage jobs screen, note that you can also delete, edit and manually run a job.
    delete edit run job
  7. To download the file(s) from the jobs created, in the Results column click the down arrow. The file or files created appear and click the filename to begin the download process.
    download a file

Platform and format type options

When creating a new template you choose a Platform and format type. Based on the type selection a form appears that you complete. This section details the information needed for each type. The types are:

Apple UMC Catalog CSV

Apple UMC Availability CSV

Google site map XML

Sitemap index XML

SEO Page HTML

Roku Search Feed 2.0 (JSON)

Possible conflicts

There are two conflicts possible when running jobs that use multiple templates. Those conflicts are:

  1. A Beacon application cannot support a job or jobs that publish to the web that use multiple templates of the same Platform and format type. For example, a Beacon app cannot have two Google site map XML templates (or two Sitemap index XML templates).
  2. A Beacon application cannot support a job or jobs that use multiple templates that publish to the same filename. For example, a Beacon app cannot have a Google site map XML template that publishes to sitemap.xml AND a Sitemap index XML template that also publishes to the same name, sitemap.xml. You must use different file names.