Geo-filtering Videos with FTP Batch Provisioning

You can use  the Video Cloud geo-filtering feature to restrict access to content based on the viewer's geographic location. For example, if you have a video that, for legal reasons, cannot be distributed outside the U.S. and Canada, you can set geo-filtering on the video to keep viewers outside of the approved countries from accessing that content. You can also use geo-filtering to restrict access to players. Filtering is supported for over 240 countries and regions defined by ISO-3166.

The ability to use geo-filtering to restrict videos is a feature available to Video Cloud Pro or Enterprise publishers for an additional fee. Contact Brightcove if you want to upgrade your account to include video geo-filtering.

Geo-filtering can be either exclusive or inclusive of the list of countries you select. This means that you can specify countries that should have access to the content in question (inclusive). Alternatively, you can specify countries that should not have access to the content in question (exclusive). This topic describes how to use FTP batch provisioning to set geo-filtering properties for your videos. You can also set geo-filtering properties for your videos using the Media module's Edit Videos: Availability tab or using the Media API.

To set geo-filtering properties for a video using FTP batch provisioning, you use two attributes in the <title> element for the video and one or more <allowed-country> child elements of the <title> element.

To enable geo-filtering for the video, include the geo-restricted="true" attribute in the <title> element. Then set the exclude-listed-countries attribute to determine whether you want to use exclusive or inclusive geo-filtering.

Exclude viewing in specified countries

To exclude specified countries from viewing the video and allow it for all other countries, include the exclude-listed-countries="true" attribute in the <title> element for the video and list the ISO-3166 two-letter country code for each of the excluded countries in an <allowed-country> child element of the <title> element. Note that the country code needs to be entered as lower case. For example, the following would exclude the video from being viewed in Tajikistan, Turkmenistan, Tuvalu, or France, but allow it everywhere else:

<title geo-restricted="true" exclude-listed-countries="true">
    <allowed-country>tj</allowed-country>
    <allowed-country>tm</allowed-country>
    <allowed-country>tv</allowed-country>
    <allowed-country>fr</allowed-country>
...
</title>

Allow viewing in specified countries

To allow a video to be viewed only in the specified countries and exclude it for all other countries,  include the exclude-listed-countries="false" attribute in the <title> element for the video and list the ISO-3166 two-letter country code for each of the allowed countries in an <allowed-country> child element of the <title> element. Note that the country code needs to be entered as lower case.  For example, the following would allow the video to be viewed in Svalbard, Swaziland, or Switzerland and prohibit it everywhere else:

<title geo-restricted="true" exclude-listed-countries="false">
    <allowed-country>sj</allowed-country>
    <allowed-country>sz</allowed-country>
    <allowed-country>ch</allowed-country>
...
</title>