Skip to main content
Skip table of contents

URL Builder

This service supports dynamic advert insertion and restriction of content in streams. URLs can be created dynamically using pre-defined rulesets containing a number of parameters associated with them.

Click here to see a blackout example.

The URL Builder is used to add parameters to the URL used for playout when connecting to the encoder endpoint, to enable the encoder provider to make runtime decisions as to what content to show or not show based upon those parameters.

For example, user A is watching a particular channel at home in Los Angeles, and user B is watching the same channel in New York.

The channel is configured to use a ruleset specifying that location for both country and city is included in the parameters sent to the encoder provider for each client connection. When the users are watching the channel, the URL used by the client to connect to the encoder carries the values of city and country based on the IP address of the client device.

The encoder provider has its own rules defined, outside the OpenTV Platform. If their rules for the channel state that anyone located in New York cannot watch an event (such as NBA Game 1), via their manifest manipulator they can change the content in the stream based on the parameters provided by the URL builder. In this case, user A will be able to see the event, whereas user B will see a different event or black screen in their stream.

Global settings

The Global Settings tab displays the URLs of the standard endpoint provider. For example:

  • Manifest Manipulator URL
  • Dynamic Ad Injection URL
  • Blackout URL

You can also create custom rules for other URLs.

Editing Global settings

Use this to change the URLs.

  1. On the Global Settings tab, click EDIT GLOBAL SETTINGS .
  2. Update the relevant URL(s) and click the SAVE CHANGES button.

Rulesets

The Rule Sets tab displays currently configured rules.

Creating rule sets

Use this to create a new rule.

  1. On the URL Builder page Rule Sets tab, click ADD RULE .
  2. Enter a name for the ruleset.
  3. Select the default URL to associate with the ruleset. To enter a custom URL, select Custom and enter the URL in the Custom URL field.
  4. Select the parameters for the rule set.
  5. Click the CREATE RULE SET button.

Editing rule sets

Use this to edit a ruleset.

  1. Select Edit Rule... from the relevant  menu.
  2. Update the URL and/or parameters are required and click the SAVE RULE SET button.

Deleting rule sets

Use this to delete a rule set.

  1. Select Delete Rule... from the relevant  menu.
  2. A confirmation message is displayed; click the DELETE button.
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.