Clips/Ads: Interactivity (clickable text, images, VAST overlays) | WS.WebTV Documentation | WebTV Solutions

Print

Interactivity

Interactivities are clickable banners that are overlaid during Clip playback. Useful to show publicity over Clips or to link Clips with other Websites, online stores, etc. You can specify as many as you want (per Clip).

Interactivities can display a text or (optionally, through ClipInteractivity+ extension) images, Iframes or VAST ads.

A note regarding the use of Interactivitites with YouTube EmbedClips: According to the Google/YouTube terms and conditions, you must not overlay elements in front of the YouTube video player; in this regard, you shall not use Interactivities with YouTube direct playback EmbedClips.

Example 1 (Interactivity with text content and not closable):


Example 2 (ClipInteractivity+ with a VAST Ad and closable):

Adding Interactivities to a Clip/Ad

1. Goto to the Clips or Ads page and edit the desired Clip/Ad...

2. Go to the Interactivity Tab...

3. Click the "New Interactivity" button.

A new interactivity will be added...
If Timing is "Absolute" you will see this:

If Timing is "Relative" you will see this:

You can change timing anytime "Relative" vs "Absolute" timing:
When "Absolute" timing is selected, you will need to specify the Start and End time for the Interactivity; those times are synced with the video or current time and you will have precise control as to when the Interactivity appears and disappears over the video.
When "Relative" timing is selected, you specify the duration, time between interactivities, start delay, etc.; and the system will take care of the rest. This option is great for use on live broadcasts. Additionally, you will be able to specify the random option if you want the Interactivities to have a different order every the video is played back.

Absolute Timing Settings
• Start/End (24hrs. format): (Synced with the Clip time or with the current time). Start: The time when the Interactivity will be displayed. End: The time when the Interactivity will be hidden.

Relative Timing Settings
• Start Deleay: The time (in seconds) it will take for the first Interactivity to appear.
• Time Between Interactivities: The "spacing" (in seconds) for the Interactivities.
• Random: No: If you want to use the specified appearance order for the Interactivities. Yes: If you want the system sort them out randomly (every time a video is watched the order will change).
• Duration: The time (in seconds) during which the Interactivity will be visible.
NOTE: When Relative timing is used, Intearctivities will be "looped".

Common Settings
• Width / Height: The size (in pixels) of the Interactivity. If you leave these values set to 0, the system will use the default values (400x45 pixels).
• Content: In this field you enter what will be displayed. Either a text (for example: "Click here to purchase on our online store!") or the URL of an image/Iframe/VAST Ad - Detailed information about these cases can be found below.
• Link (URL): This is the URL that will open when the Interactivity is clicked. In case it is blank, nothing will happen when clicked.
• Pause Video: (Since WS.WebTV v53pf1) Select whether the playback should pause when the Interactivity is displayed.
• Closable: (Since WS.WebTV 1.8.5) Select whether the Interactivity can be closed by the viewer or not. When it is "closable" a button with an "X" will appear at the top-right of the Interactivity.

Special labels (WS.WebTV 3.0+)
It is worth noting that in the "Content" and "Link" fileds it is possible to enter certain special labels that will be replaced by WebTV data.
Supported labels: {clip.id} (since 3.0.5), {user.id}, {user.alias}, {user.name}, {user.surname}, {user.email}, {user.country}, {user.country_code}, {user.telephone}.

4. Done editing...
Once you are done click the Save button.

ClipInteractivity+: VAST Ads, Banner Images, Iframes

If your WebTV has the ClipInteractivity+ extension, then you can display VAST NonLinear Ads (overlays), banner images and Iframes.

VAST

In the content field, enter the VAST Tag URL with the "[vast]" prefix. Example:
[vast]http://vast_tag_url...
You can supply several fallback URLs, separated with commas (in order to increase the fill rate). Example:
[vast]http://vast_tag_url1,http://vast_tag_url2,http://vast_tag_url3

NOTES:
- The "Link (URL)" field will be ignored when using VAST because the clickthrough URL is specified in the feed.
- When using VAST, the duration of an Interactivity will be determined by the VAST "minSuggestedDuration" setting or (when the setting is not specified in the VAST feed) according to the Interactivity duration.
- WS.WebTV 1.8.5 is required in order to use VAST.

Banner images

In the content field, enter the absolute URL of the image file (JPG, GIF or PNG).

Note regarding images hosted on external servers or CDN: If the image is served from a server which is different than the one that hosts the WebTV (or from a CDN) then the server must have a crossdomain.xml file properly set, allowing the resource sharing; additionally, the resources (images) must be served using CORS headers allowing GET requests.

NOTE: You can not use text and image, at the same time, in the same Interactivity.

Iframes

Since WS.WebTV 3.0.5 it is possible to display an Iframe as the content of an Interactivity (typical use example: a form).
In the content field, enter the URL of the Iframe with the "[iframe]" prefix. Example:
[iframe]https://www.domain.com/iframe.html...
NOTES:
- The Iframe protocol must be "https://" or at least match the one of the WebTV URL otherwise it will be blocked by the Web browser.
- This feature will only work on the HTML5 Video Player (The Flash Video Player will ignore these Interactivities).

Global Interactivities

These Interactivities are defined globally and get inserted into all WebTV Clips (not on Ads) which do not have any Interactivity defined. This is very useful to add publicity to all WebTV Clips.
Unlike Clip Interactivities, the global ones always use relative timing (see explanation above).

In order to add Global Interactivities, go to Configuration > Interactivities:

• Clip Probability (%): The probability of appearing in a Clip. For example: A 50% probability would imply that approx. half the Clips played back will show Global Interactivities, the other half will not show any.
• Start Delay (secs.): The time (in seconds) it will take for the first Interactivity to appear.
• Time Between Interactivities (secs.): The "spacing" (in seconds) for the Interactivities.
• Sorting:
» Rel. Position: The position of the list will be used (you can sort the Interactivities using drag and drop).
» Random: The Interactivities will be randomized.
» Views (less viewed first): The lest viewed Interactivities will appear fisrt.
...The procedure to add Global Interactivities is the same as adding Clip Interactivities (click "New Interactivity" and set the options).