How to trigger Vast ads

For the Revma infrastructure to serve ads, a certain metadata trigger (ADBREAK_LENGTH_{duration}) needs to be sent. When the Revma infrastructure receives this metadata, it will call for ads from the ad provider. The duration of the ads that the Revma infrastructure will try to fetch and serve for each listener is included in the metadata trigger. For the listeners that will receive an ad, the content that is broadcasted will be “overlapped” with ads.

Note that it is unlikely that a provider will provide ads whose duration is exactly the same as the duration requested by the mid-roll start metadata (ADBREAK_LENGTH_{duration}). Once the mid-roll is finished, each listener switches back to the actual stream, which means that each listener will return to what is streamed via the encoder.

If the mid-roll's combination of ad files turn out to be longer than what was requested and the listener receives longer duration, they will then be switched back to the actual stream at the point that they were supposed to switch back when the mid-roll was supposed to end (the ADBREAK_END point). As this will mean that listeners will be “behind” the real-time stream, this is limited up to a certain duration equal to the “overfill limit” setting (as set on the stream configuration settings section of the station).

The Broadcaster will need to send the metadata from their end, via a broadcasting tool in use.

As mentioned, the metadata is ADBREAK_LENGTH_{duration}  where duration is in milliseconds. So, if the broadcaster wants to send a request to the provider for 60 seconds of ads, the metadata will need to be ADBREAK_LENGTH_60000.

Here are some more examples:

ADBREAK_LENGTH_45000, for 45 seconds of ads

ADBREAK_LENGTH_60000, for 60 seconds of ads

ADBREAK_LENGTH_120000, for 120 seconds of ads

Also, as mentioned, at the point that the duration ends, the broadcaster will need to send the metadata ADBREAK_END.

Example: the broadcaster sends metadata ADBREAK_LENGTH_60000 from the encoder. After 60 seconds, the metadata ADBREAK_END will need to be sent.

Note that these metadata will need to be sent via the "title" or "song" section of the broadcasting tool in use.