Revma session rules scenarios
- Achilleas Poulios
This article’s purpose is to provide some example scenarios of the session rules' use.
- 1 Scenario #1:Geofence the stream
- 2 Scenario #2: Station Imaging as prompt
- 3 Scenario #3: Geofence the stream and serve the station imaging as media prompt to the correct audience
- 4 Scenario #4: Vast ads as prerolls
- 5 Scenario #5: Vast ads as midrolls
- 6 Scenario #6: Schedule a rule
- 7 Scenario #7: Apply rule to parts of the audience
Scenario #1:Geofence the stream
Steps to be taken to make a stream only available to a specific country. Example Country: United States of America
On the account level, go to ‘Session Rules’
Go to ‘Actions’ and ‘Add Actions’
Create a ‘Drop’ action
You could optionally upload a static media file. Listeners who will not have access to the stream will be served that file and then the connection will be dropped.
Go to ‘Rules’ and ‘Add Rule’
Set ‘Source Type’ as ‘Geo’ and select ‘United States of America’
Click on the ‘Negate Source’ checkbox
At ‘Target Type’, select ‘Single Stream’
Fill in the station’s name under ‘Stream Filter’ or the station’s stream name under ‘Stream’
Under ‘Action’ select the ‘Drop’ action you previously created.
Click ‘Save Changes’
With the above setup, listeners coming from outside of the United States of America, will not be allowed to access the given stream.
If the ‘Negate Source’ checkbox was not checked, listeners coming from the United States of America would not be allowed to access the given stream and listeners outside of the United States of America would be allowed to access the stream.
Scenario #2: Station Imaging as prompt
Steps to be taken to serve a station imaging media prompt to all listeners upon accessing the stream.
On the account level, go to ‘Session Rules’
Go to ‘Actions’ and ‘Add Actions’
Create a ‘Continue’ action
Upload a static media file.
Go to ‘Rules’ and ‘Add Rule’
Set ‘Source Type’ as ‘Any Source’
At ‘Target Type’, select ‘Single Stream’
Fill in the station’s name under ‘Stream Filter’ or the station’s stream name under ‘Stream’
Under ‘Action’ select the ‘Continue’ action you previously created.
Click ‘Save Changes’
With the above setup, all listeners trying to connect to the given stream, will at first audition the uploaded media prompt and then will connect to the stream
Scenario #3: Geofence the stream and serve the station imaging as media prompt to the correct audience
a. Geofence the stream
On the account level, go to ‘Session Rules’
Go to ‘Actions’ and ‘Add Actions’
Create a ‘Drop’ action
You could optionally upload a static media file. Listeners who will not have access to the stream will be served that file and then the connection will be dropped.
Go to ‘Rules’ and ‘Add Rule’
Set the priority to 0.
Set ‘Source Type’ as ‘Geo’ and select ‘United States of America’
Click on the ‘Negate Source’ checkbox
At ‘Target Type’, select ‘Single Stream’
Fill in the station’s name under ‘Stream Filter’ or the station’s stream name under ‘Stream’
Under ‘Action’ select the ‘Drop’ action you previously created.
Click ‘Save Changes’
With the above setup, listeners coming from outside of the United States of America, will not be allowed to access the given stream.
b. Station Imaging as prompt
On the account level, go to ‘Session Rules’
Go to ‘Actions’ and ‘Add Actions’
Create a ‘Continue’ action
Upload a static media file.
Go to ‘Rules’ and ‘Add Rule’
Set the priority to 5.
Set ‘Source Type’ as ‘Any Source’
At ‘Target Type’, select ‘Single Stream’
Fill in the station’s name under ‘Stream Filter’ or the station’s stream name under ‘Stream’
Under ‘Action’ select the ‘Continue’ action you previously created.
Click ‘Save Changes’
With the above setup, all listeners (ie all listeners from within the United States of America, as all listeners from outside of the United States of America have been dropped) trying to connect to the given stream, will at first audition the uploaded media prompt and then will connect to the stream
In scenarios where multiple rules exist, all of the rules must have a proper ‘Priority’ value set in the ‘Rules’ setup page. 0 is the highest priority. If there are two rules with the same priority value, only one of them will randomly apply.
Scenario #4: Vast ads as prerolls
Steps to be taken to serve vast ads as prerolls.
On the account level, go to ‘Session Rules’
Go to ‘Content Providers’ and click on ‘Add Provider’
Fill in the provider’s name and the URL corresponding to the broadcaster's account in the provider.
Make sure to check ‘Append Listener Id’ and ‘Delay Report’
Go to ‘Actions’ and ‘Add Actions’
Create a ‘Vast’ action
You could optionally upload a static media file as a media prompt (media will air before the vast ad) and as an ‘alternative media list’ (media will air instead of the vast ads in case the vast ad is not delivered to the audience).
Select the Provider and fill in the provider params where it is required.
Go to ‘Rules’ and ‘Add Rule’
Set ‘Source Type’ as ‘Any Source’
At ‘Target Type’, select ‘Single Stream’
Fill in the station’s name under ‘Stream Filter’ or the station’s stream name under ‘Stream’
Under ‘Action’ select the ‘Vast’ action you previously created.
Click ‘Save Changes’
Scenario #5: Vast ads as midrolls
Steps to be taken to serve vast ads as prerolls.
On the account level, go to ‘Session Rules’
Go to ‘Content Providers’ and click on ‘Add Provider’
Fill in the provider’s name and the midroll URL corresponding to the broadcaster's account in the provider.
Make sure to check ‘Append Listener Id’ and ‘Delay Report’
Go to ‘Actions’ and ‘Add Actions’
Create a ‘Vast’ action
You could optionally upload a static media file as a media prompt (media will air before the vast ad) and as an ‘alternative media list’ (media will air instead of the vast ads in case the vast ad is not delivered to the audience).
Select the Provider and fill in the provider params where it is required.
Go to ‘Rules’ and ‘Add Rule’
Set ‘Source Type’ as ‘Any Source’
At ‘Target Type’, select ‘Single Stream’
Fill in the station’s name under ‘Stream Filter’ or the station’s stream name under ‘Stream’
Under ‘Action’ select the ‘Vast’ action you previously created.
Click ‘Save Changes’
For a midroll to be triggered in a ‘Streaming only/ No Playout’ type of station, Reva will need to receive a relevant trigger from the broadcaster's end (either via the encoder of the playout system)
For a midroll to be triggered in a ‘Loop Channel’ type of station, the relevant media files (to start and end the midroll) need to be positioned in the station’s playlist. In Between these two files, alternative content ought to be positioned as well.
Scenario #6: Schedule a rule
Once a rule is created a rule is scheduled to apply always.
You could optionally set the rule to apply only at certain time slots (day/time)
The steps below can be used to schedule any type of rule, regardless of the action the rule is connected with.
After having configured the prefered action, go to ‘Rules’ and fill all the fields you would in all cases. Then click on the ‘schedule’ tab at the top
On the account level, go to ‘Session Rules’
Go to ‘Actions’ and ‘Add Actions’
Create a ‘Drop’ action
You could optionally upload a static media file. Listeners who will not have access to the stream will be served that file and then the connection will be dropped.
Go to ‘Rules’ and ‘Add Rule’
Set ‘Source Type’ as ‘Geo’ and select ‘United States of America’
Click on the ‘Negate Source’ checkbox
At ‘Target Type’, select ‘Single Stream’
Fill in the station’s name under ‘Stream Filter’ or the station’s stream name under ‘Stream’
Under ‘Action’ select the ‘Drop’ action you previously created.
Go to ‘Schedule’ at the top.
Select the preferred time zone
Select the dates/days during with the rule should apply
Click ‘Save Changes’
With the above setup, listeners coming from outside of the United States of America, will not be allowed to access the given stream at the times the rule has been scheduled to apply. Apart from these time slots, all listeners will be able to access the stream.
The schedule feature is mostly used for events (sports’ shows, concerts etc) for which the broadcasters only have rights to broadcast within a certain country/ies
In case there is an active listener connection prior to the scheduled time slots, that connection will not be dropped.
Scenario #7: Apply rule to parts of the audience
Steps to be taken to serve two different station imaging media prompts to all listeners upon accessing the stream (each one to 50% of the audience)
On the account level, go to ‘Session Rules’
Go to ‘Actions’ and ‘Add Actions’
Create a ‘Continue’ action (Action#1)
Upload a static media file (file#1)
Create an additional ‘Continue’ action (Action#2)
Upload a static media file (file#2)
Go to ‘Rules’ and ‘Add Rule’
Set ‘priority’ to 0
Set ‘Source Type’ as ‘Any Source’
At ‘Target Type’, select ‘Single Stream’
Fill in the station’s name under ‘Stream Filter’ or the station’s stream name under ‘Stream’
Under ‘Action’ select the ‘Continue’ action (Action#1) you previously created.
Set ‘Percentage of listeners to apply this action’ to 50.
Click on the ‘Proceed to the next available rule’ checkbox
Click ‘Save Changes’
Go to ‘Rules’ and ‘Add Rule’ to create a secondary rule
Set ‘priority’ to 5
Set ‘Source Type’ as ‘Any Source’
At ‘Target Type’, select ‘Single Stream’
Fill in the station’s name under ‘Stream Filter’ or the station’s stream name under ‘Stream’
Under ‘Action’ select the ‘Continue’ action (Action#1) you previously created.
Click ‘Save Changes’
Set ‘Percentage of listeners to apply this action’ to 100.
With the above setup, 50% of the listeners trying to connect to the given stream, will at first audition the uploaded media prompt (file#1) and then will connect to the stream and the rest of them will at first audition the uploaded media prompt (file#2) and then will connect to the stream