FV Player VAST is a FV Player addon which allows the use of VAST (Digital Video Ad Serving Template) and VPAID (Digital Video Player-Ad Interface Definition) ads. If you do not have our add-on yet, you can purchase it here.
Installation
First thing you have to do after the purchase, is to download and install the plugin. You can start with entering the name of your domain to the respective field in the My Orders section on Foliovision.com. After you do that, the system will generate a unique license key and you will be able to download your copy of FV Player VAST.
1. Enter the name of your domain
2. Download the plugin
After downloading the plugin in a zip file, open your WP Admin and go to Plugins -> Add New -> Upload Plugin and choose the zip file. FV Player VAST is a separate plugin and has it’s own settings, so after it’s installed, you should follow the steps below.
Activation
Go to Settings -> FV Player VAST -> License. Here you can enter your license number (the one that can be found in My Orders section).
Inserting license key
Setting up the Global VAST URL
Insert your ad tag you’ve received from your VAST provider to the VAST URL field in Settings -> FV Player VAST -> Global VAST Ads.
Inserting ad tags
If your ad network requires dynamic parameters, you can click URL tags to get a hint. Your ad network uses these parameters to optimize the ad delivery. You can find comprehensive guide to URL tags in here.
Accessing the list of URL Tags
Make sure your REPLACE tags are replaced with the right URL tags. That means that if your URL contains REPLACE_ME or [video_id_goes_here] you need to put in the required URL tag.
Here is the example of how should the URL look like in your configuration:
By default, the Global VAST URL only works in pre-roll. You can, however, set the ad tag to be triggered during playback as well.
Located in the Settings tab, the Global Mid-roll setting will allow you to choose how often the ad gets triggered:
The setting is measured in minutes and offers several options. The frequency of ads is calculated from the actual watch time on each player, instead of the timestamp. Meaning viewers only get ads after viewing the set amount of content.
Waterfalling Ads
You can use multiple VAST tags for “waterfall” loading of the ads (in case one ad fails, another one will load). You simply enter different VAST URLs. In case the first one is empty, it automatically checks for the next one and so on. To enter more VAST URLs, simply click on Add More and a new line to enter URL appears.
Adding more ads
Setting up Ad Tags for Individual Videos
You can specify a different VAST URL on a per-video basis. You can either use the shortcode editor or add a parameter to the shortcode manually. Using the shortcode editor is easy, just open it and switch to the Options tab. There you will find a field called VAST URL. Paste your ad tag there and click on the Update button.
Vast URL in shortcode editor
Adding the tags to the shortcode manually requires using the parameter vast=””. Just add vast=”{your ad URL here to your shortcode}”:
If you have set a default ad tag for all your videos in the FV Player VAST settings, but you want to have some videos without an ad, you can add the vast=”none” parameter into the shortcode. For example:
If you’d like to build a subscription model that separates logged in users of your website from simple visitors by sparing them having to watch ads, you can do so by enabling the Settings -> FV Player VAST -> Tweaks -> Do not show ads to logged in users setting
Disabling ads for logged in users
Multiple Ads
For linear ad placement, you can use the mid-roll parameter both in the shortcode editor, or manually in the shortcode. The mid-roll command allows you to specify the exact second in which the ad should start during the video playback. If you add value ‘0’, the ad will start as pre-roll. If you use the last second of your video, the ad will play as post-roll. You can also use it for playing one ad multiple times during one video.
For example:
midroll=”60,300″ – the ad will load in 60th second and in 5th minute.
midroll=”60″ – the ad will load in 60th second
midroll=”0″ – the ad will load in pre-roll
midroll=”120″ – in this hypotethic example, the video has exactly two minutes, so we set the value to ‘120’ to make it play on the last second of the video, thus loading in post-rol
To use it in the shortcode editor, just type the time in seconds into the VAST Midroll field, that is under the Options tab.
Silent Start And Ads Control
If you turn on the Silent Start option, all ads on your site will start muted by default and user will be able to unmute them by clicking on the sound icon, that will appear after hovering over the video.
To activate it, go to Settings -> FV Player VAST -> Tweaksand check the box Silent Start.
Activating silent start
If your VPAID tag supports skipping, volume control and other ad controls you can allow them by enabling the Enable VPAID ad controls setting in the Tweaks tab
:
Troubleshooting
Debugging will offer you a tool that enables you to monitor the execution of the program. You can examine VAST events, loading and tracking. If it’s not enabled, then you can’t see what FV Player VAST is doing. You can turn on debug option in Settings -> FV Player Vast -> scroll down to Debug and tick the box.
Enabling the debug mode
You can use your JavaScript console to check the VAST/VPAID messages, the ad network shows the error messages there:
SWF:
[Ad requested : http://search.spotxchange.com/vast/2.00/97610?VPAID=1&content_page_url=page-url&cb=random-number&player_width=player-width&player_height=player-height]
Error: Ad adLoadError error: No ads were found in the ad response. At least one ad is required to be able to load or play. errorCode: 1001
SWF:
[Ads load error: : No ads were found in the ad response. At least one ad is required to be able to load or play.]
If you do not have your JavaScript console enabled yet, here is a helping hand.
If you’re having trouble with VPAID tags not loading, enabling the Enable VPAID Secure Mode could help you:
Enabling VPAID Secure Mode
Additionally, you have an option to effectively use your ad network stats. For example, it checks fill rate. You can also use Google Analytics to track your ads – more about that in the guide Tracking VAST and VPAID Ads With Google Analytics.
Examples
You can watch our examples of ad integration at these demo pages:
This website uses cookies so that we can provide you with the best user experience possible. Cookie information is stored in your browser and performs functions such as recognising you when you return to our website and helping our team to understand which sections of the website you find most interesting and useful.
Necessary Cookies
Strictly Necessary Cookie allow you to log in and download your software or post to forums.
We use the WordPress login cookie and the session cookie.
If you disable this cookie, we will not be able to save your preferences. This means that every time you visit this website you will need to enable or disable cookies again.
Support Cookies
Foliovision.com uses self-hosted Rocket.chat and self-hosted Freescout support desk to provide support for FV Player users. These cookies allow our visitors to chat with us and/or submit support tickets.
We are delighted to recommend self-hosted Rocket.chat and especially Freescout to other privacy-conscious independent publishers who would prefer to self-host support.
Please enable Strictly Necessary Cookies first so that we can save your preferences!
3rd Party Cookies
This website uses Google Analytics and Statcounter to collect anonymous information such as the number of visitors to the site, and the most popular pages.
Keeping this cookie enabled helps us to improve our website.
We reluctantly use Google Analytics as it helps us to test FV Player against popular Google Analytics features. Feel free to turn off these cookies if they make you feel uncomfortable.
Statcounter is an independent Irish stats service which we have been using since the beginning of recorded time, sixteen years ago.
Please enable Strictly Necessary Cookies first so that we can save your preferences!
Leave a Reply