Skip to content

AD_Server Plugin

Daniel Neto edited this page Aug 15, 2024 · 3 revisions

Make sure you know all types of ads possible on the AVideo Platform, click here

This plugin allows you to create advertisements using the videos in your libraries. We create this plugin based on VMAP and VAST standards

VMAP (Video Multiple Ad Playlist)

VMAP stands for Video Multiple Ad Playlist, which is a format for describing how and when ads should be played during a video. It is an XML-based format that is used to define ad breaks, or when a video should pause and display an advertisement. VMAP can be used to create complex advertising schedules, such as playing different ads for different regions or audiences.

VAST (Video Ad Serving Template)

VAST stands for Video Ad Serving Template, which is a standard for structuring ad tags that serve ads to video players. VAST is also an XML-based format that includes metadata about an advertisement, such as the length of the ad, the video format, and the click-through URL. VAST is used by ad servers to communicate with video players and ensure that the ad is displayed correctly.

Why These Standards Are Important

To ensure effective and efficient advertisement delivery, publishers need to have a common ground to build on when serving ads across multiple platforms and devices. VMAP and VAST provide such a common ground. VMAP describes when ads should be played during a video, while VAST structures the ads themselves and ensures they are displayed correctly. This helps publishers to scale their ad delivery and reach their target audience across various platforms and devices.

Requirements

  1. You necessarily need to use HTTPS.
  2. Campaigns can only contain videos that you host. embed videos do not work.

Limitations

The Campaigns will only play on VOD videos, they do not work on live videos

Global Campaigns and Campaign per user

All the Campaigns are site-wide. Currently, we do not have a Campaigns per user, so only admins can create Campaigns

chrome-capture-2022-10-21

Paid User

By default, if you have a paid user (PPV or subscription) we will not show ads to him.

How to Use the plugin.

To access the plugin configuration screen you can click on the red Advertising Manager button on the top of the videos manager or on the Plugin button on the right side of the AD_Server plugin on the plugin manager

To have your ad videos playing will need to do two things

  1. Create a campaign
  2. Add videos on your campaign (MUST BE MP4 videos)

Create a campaign

Fill all the fields on the left side and click on the Save button The Max Prints field when the ad reaches the number of views will no longer compete with the display ads queue

Campaign List

On the right side, you can see a list of the campaigns and buttons to add videos, see a simple chart about the campaign progress, edit a campaign, and delete the campaign respectively.

Add videos

On the first field type a name of a video, and a list will pop up below, choose a video and fill in the other fields and click on the green add Video button

the videos chosen here will randomly appear in your campaign

Sample site

You may already noticed we have a plugin called AdsForJesus. This plugin automatically adds ads to your videos. this plugin is fed by this website https://videos.forjesus.tv/

This is how the site plugin configuration looks like

chrome-capture (4)

Plugin Parameters

Video Positions

  • start: Check it if an Advertising should appear on the start video position.
  • mid25Percent: Check it if an Advertising should appear when the video position reaches 25% of the full video length.
  • mid50Percent: Check it if an Advertising should appear when the video position reaches 50% of the full video length.
  • mid75Percent: Check it if an Advertising should appear when the video position reaches 75% of the full video length.
  • end: Check it if an Advertising should appear when the video position reaches the end of the full video length.

Frequency

  • showAdsOnEachVideoView: This defines how often advertisements will appear. For example, if it is set to 2, you will see ads every 2 videos, but if it is set to 1 you will see ads on every video.
  • showAdsOnRandomPositions: This will pick random positions to display the ads, but it will pick only the positions you have checked above. For example, if you want to have 2 random positions, but do not want to have videos on the start position, you must uncheck the start video position checkbox.

Others

  • skipoffset: This is the percentage where the skip button should appear.
  • showMarkers: Check it if you want to show the yellow markers on the video, where the advertising should appear.
Clone this wiki locally