Create a custom metadata schema for per-entry bumpers in player


About

Custom metadata lets you control bumper videos per entry instead of using the same bumper for all videos in a player.

By mapping metadata fields to bumper settings, each entry can define its own bumper video, click-through URL, and position.

This is useful when managing large content libraries where bumper content varies between entries.

Step 1: Create a custom metadata schema

Access the Custom Data page

  1. Log into your Rich Media CMS.
  2. Click the Settings gear icon at the right of the navigation menu.
  3. The 'Account' page displays.

  4. Click the Custom Data tab at the top of the page.
  5. The 'Custom Data' page displays.

Create a custom metadata schema

  1. Click Add Custom Schema.
  2. The Add Custom Schema window displays.

  3. Complete the following fields:
  • Custom Schema Title - Add a title (for example, Bumper metadata)
  • Description - (optional) Enter a relevant description.
  • System name - (optional) This field is required if you plan to use the schema with bulk XML uploads or APIs.
  • Apply to - Select Entries (default).

3. Click + Add Custom Field.  

The 'Add Custom Field' window displays.

4. Complete the fields:

  • Field Type - Select Text.
  • Max No. of Values - Choose Single (default).
  • Field Label - BumperUrl (You must type BumperUrl exactly as shown in these instructions. The player only reads metadata fields with this exact field name.)
  • Short description - optional
  • Description - optional
  • Searchable - Enable if you want to allow search by this field.

5. Click Add.

The field displays in your custom schema list.

6. Click +Add Custom Field and repeat the steps above for the remaining fields:

BumperClickThroughUrl

  • Field Type – Text
  • Field label – BumperClickThroughUrl

BumperPosition

  • Field Type – Text
  • Field label - BumperPosition

Use the exact field labels shown above. The player only reads metadata fields with these exact names.

7. Click Add to save the custom field.

8. Click Save in the top-right corner to finalize the schema. 

Your new metadata schema appears under the Custom Data tab.

Step 2: Add bumper metadata to an entry

  1. Access the entry details page by clicking the Content tab in the navigation menu.
  2. The Entries page displays by default.

  3. Click on the desired entry's title or thumbnail. 
  4. The Metadata tab displays by default.

  5. Scroll down to the bumper metadata section.
  6. Complete the fields as needed: 
  • BumperUrl - Enter the bumper video URL  
  • BumperClickThroughUrl - (optional) Enter a destination URL
  • BumperPosition - Enter one of the supported values:
    • 0 – before playback
    • -1 – after playback
    • 0,-1 – before and after playback

5. Click Save.

The bumper is applied when the entry is played in a player with Metadata based bumper video enabled. 

If BumperUrl is empty or not set, the bumper is not displayed and the player falls back to the global bumper settings.

Was this article helpful?
Thank you for your feedback!
User Icon

Thank you! Your comment has been submitted.

In this article
Related articles
  • None