Multi-channel & geoblocking

Define aliases for your channel and restrict countries with access to your playout

This guide describes the multi-channel approach of THEOlive: ingest only once, and create multiple channel aliases to configure unique playouts. Next to a different configuration for each alias, THEOlive offers the possibility to apply some security settings (like Geoblocking) on each alias.

All of this is possible via the THEOlive management console, as well via the THEOlive API.

Multi-channel: player aliases

Do you want to make your live stream available to multiple customers concurrently? And do you require for each customer a different player look & feel, restrictions on countries the content is made available, and usage stats to be tracked separately? You can easily do this with the THEOlive multi-channel capability.

When accessing your "Channel Details" page, you can create aliases for your channel under the section "Playout configurations". For each alias that you create it’s possible to subsequently change the playout configuration: colors, poster image, announcement message, logo etc.

10531053

Create a new channel alias under the "Playout configurations" tab

The big advantage here is that you only have to configure your ingest once, and can then share your content on multiple web pages as each alias has a different channel ID. Including an alias is very simple: you just have to copy the ID and paste it as the value of the data-theo-live-id attribute. Click on the "Include channel on your page" tab to see the full explanation on how the include a specific playout configuration (alias) on your page.

13481348

Find the unique channel ID of your alias in the "Include channel on your page" tab

Managing your alias

At any time, you can update, enable, disable or delete a channel alias. The default alias can't be deleted, you'll have to delete your whole channel in case you want to do so.

13161316

Icon buttons to disable, enable or delete an alias

Analytics per channel alias

It's possible to visualize data per channel alias. In the console you can see your viewing insights (concurrent viewers, latency, locations of your viewers, browsers and operating systems used) and channel usage (viewing minutes) per alias by clicking on one of the links in the analytics section of the Channel Details page.

THEOlive also offers an API endpoint where you can query the minutes viewed on an hourly basis per channel alias. You can read more about it here.

10171017

Link to viewing insights and channel usage page where analytics are stored per channel alias

Geoblocking

Per alias you can configure some security settings as well. Currently, you can only enable geoblocking and set a list of countries where people can play your stream. You get here by clicking on the "Security" tab.

13231323

Limit countries with access to the playout in the "Security" tab

🚧

Restart needed for Default channel alias

When you change the geoblocking settings for your default channel (the "parent"), you need to restart your whole channel in order to make it active.

For all the other aliases, a save is sufficient to make it active immediately.