TABLE OF CONTENTS
Overview
Pre-roll prevention is a Revma feature that, under specific circumstances and for pre-defined times, prevents pre-rolls to be served on a listener. This applies for both Vast pre-rolls as well as for Media prompts contained in a Continue Action.
The main purpose of this feature is to avoid having the same listener receive a pre-roll after every disconnection and (re)connection to a stream. In other words, this can be seen as a "cooldown" period in between pre-rolls.
The feature can be applied on both account and/or stream level.
A basic scenario for pre-roll prevention, where stream has it set to 5 minutes, would work as following:
Listener connects to stream at 21:00 - receives pre-roll > Listener disconnects from stream at 21:05 > Listener connects to stream at 21:07 - does not receive pre-roll > Listener disconnects and re-connects to stream at 21:12 - receives pre-roll.
Pre-roll prevention is not available to set via the UI and is by default set to off. For this feature to be set as active and/or for any alterations, please contact RCS Revma support.Pre-roll prevention specifications & scenarios
More specifically, in regards to this feature, these are the specifications to keep in mind:
1. Pre-roll prevention aims to prevent pre-rolls based on the listeners. For this reason, Revma's criteria in order to prevent a pre-roll is a stream connection's 'listener id'. The 'listener id' might already be present on the listener's end, otherwise it is generated by Revma with the use of specific values that define a unique listener.
2. If pre-roll prevention is set to active, its values are the following:
- Pre-roll prevention 'grace time', defines the time for which a listener will not receive another pre-roll. Although the most common for this would be a few minutes, the maximum time this can be set to is 24 hours.
3. The pre-roll prevention's 'grace time' will start counting after a listener that received a pre-roll disconnects and not after a listener receives the pre-roll. Therefore, if 'grace time' is set to 10 minutes, the following will apply:
listener connects and receives a pre-roll at 11:00 > listener disconnects at 11:02 > listener re-connects at 11:03 - will not receive a pre-roll as it will be prevented > listener disconnects and re-connects at 11:15 - listener will receive pre-roll as 13 minutes from the initial disconnection have passed.
4. Pre-roll prevention can be set on account level and stream level.
- If it is set only on account level, it will apply for all streams under the account. Furthermore, it will apply when hopping between different streams of the same account. In this case, if 'grace time' is set to 7 minutes, a listener that receives a pre-roll and disconnects from one of the account's streams and then connects to another, will have the pre-roll prevented for these 7 minutes.
- If it is set only on stream level, it will only apply for the specific stream with no connection to the other streams of the same account.
- If it is set both under the account level and stream level, the stream's 'grace time' will apply for the specific stream, therefore 'overriding' the account's setting. However, in 'stream hopping' scenarios, all streams under the account will be 'connected' to each other and will or will not prevent a pre-roll according to the settings that apply for each stream. Naturally, this is given the fact that all streams have pre-roll Actions and the respective Rules set to them.
A scenario for this: account 'grace time' set to 5 minutes, stream A 'grace time' set to 9 minutes, stream B has not pre-roll prevention settings (so it will inherit the account's settings). Listener connects to stream B and receives pre-roll at 07:00 > listener disconnects from stream B at 07:01 > listener connects to stream A at 07:02 - the pre-roll will be prevented as stream A's 'grace time' is set to 9 minutes.
5. Pre-rolls prevention applies for both Vast pre-rolls as well as for Media prompts, which are static media contained in a Continue Action. Keep in mind that this is limited to Continue Actions only and not for any other Action type which can come with a Media prompt (i.e. Drop)
6. Pre-roll prevention for the same stream or between multiple streams of the same account, will apply for any type of pre-roll; be it of different Vast providers or Media prompt's static media.
A scenario for this: account 'grace time' set to 5 minutes, stream A has no pre-roll prevention settings and has a Vast Action set, stream B has no pre-roll prevention settings and has a Continue Action with Media prompt set. Listener connects to stream A and receives Vast pre-roll at 09:00 > listener disconnects from stream A at 09:01 > listener connects to stream B at 09:02 - the pre-roll will be prevented and the Media prompt will not be received.
Here are some every-day life examples:
Example #1
Account pre-roll prevention: Disabled
Station A pre-roll prevention: Enabled - Grace period: 5 minutes
Station B pre-roll prevention: Disabled
Listener connects to station A, receives a pre-roll and at some point
disconnects from station.
If the same listener reconnects again to station A within 5 minutes from the
disconnection (station A grace period), listener will not receive a pre-roll.
Revma will not even attempt to serve a pre-roll, meaning there will be no
request made to the VAST provider.
If the same listener connects to station B, no prevention mechanism will
apply.
Example #2
Account pre-roll prevention: Disabled
Station A pre-roll prevention: Enabled - Grace period: 5 minutes
Station B pre-roll prevention: Enabled - Grace period: 10 minutes
Listener connects to station A, receives a pre-roll and at some point disconnects
from station.
If the same listener reconnects again to station A within 5 minutes from the
disconnection (station A grace period), listener will not receive a pre-roll.
If the same listener connects to station B, no prevention mechanism will apply.
If listener disconnects from station B and reconnects again to station B, the
prevention mechanism based on station B settings will apply (grace period of 10
minutes).
Example #3
Account pre-roll prevention: Enabled - Grace period: 7 minutes
Station A pre-roll prevention: Enabled - Grace period: 5 minutes
Station B pre-roll prevention: Enabled - Grace period: 10 minutes
Listener connects to station A, receives a pre-roll and at some point disconnects
from station.
If the same listener reconnects again to station A within 5 minutes from the
disconnection (station A grace period), listener will not receive a pre-roll.
After the disconnection, if the same listener connects to station B, the prevention
mechanism based on station B settings will apply (grace period of 10 minutes).
Example #4
Account pre-roll prevention: Enabled - Grace period: 7 minutes
Station A grace period: Disabled (will inherit account grace period)
Station B grace period: Disabled (will inherit account grace period)
Listener connects to station A, receives a pre-roll and at some point disconnects
from station.
If the same listener reconnects again to station A within 7 minutes from the
disconnection (account grace period), listener will not receive a pre-roll.
If the same listener connects to station B within 7 minutes from the disconnection
(account grace period), listener will not receive a pre-roll.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article