Custom Ads is an feature that allows you to play a preroll ad for listeners before your stream plays, or a postroll after your stream. Available only on the Radio Mast Streaming Network.
A preroll ad is a jingle or message that plays when a listener connects, before your stream's audio is heard. A postroll ad plays after a listener hits a timelimit.
Custom Ads are inserted server-side and will be heard on any device or player where your stream can play. No player-side customization is required. All "ads" are your own - Radio Mast will not alter your stream or insert third party advertising.
With Custom Ads, you can:
To get started with Custom Ads, log into your Radio Mast account and click a radio station (if you have multiple), then:
The next time you listen to your stream, you should hear your preroll ad play before your stream starts. Note that it may take up to 30 seconds for your changes to apply.
A preroll ad is an audio file that plays before listeners hear your stream.
A postroll ad is an audio file that plays after your listeners exceed their time limit. Currently, time limits can only be imposed using Custom Listener Authentication and so postroll ads can only be inserted dynamically.
Custom Ads are compatible only with MP3, AAC, HE-AAC v1, and HE-AAC v2 (AAC+) streams. They will not play on Ogg Vorbis, FLAC, or Opus streams.
Custom Ads may be uploaded as any of the following audio file formats: .mp3, .m4a (AAC), .aac (ADTS AAC), .ogg, .flac
Ads are automatically transcoded to ensure they match the audio format of a stream.
This is an advanced feature recommended for power users only.
Preroll or postroll ads can be be dynamically customized on a per-listener basis using Custom Listener Authentication.
When a listener connects to a stream that has Custom Listener Authentication
configured, a webhook HTTP request is dispatched to your webhook
handler. In the response to this webhook, your handler can reply
preroll HTTP header with a value containing the URL of an
audio file to insert as the preroll for this listener.
By inspecting the parameters passed to your webhook handler, you can determine information about the listener, such as their IP address and user-agent. This information can be used to tailor the ad for the listener.
For more details, please see Custom Listener Authentication.
For examples of how to insert Dynamic Custom Ads, please refer to our Code Samples for Custom Listener Authentication
The following checklist outlines the steps needed to use Dynamic Custom Ads on your stream:
preroll: <url>HTTP header, where
<url>points to a valid audio file.