1. Home
  2. Docs
  3. Publisher
  4. Adding new station
  5. Ads Replacement integration

Ads Replacement integration


To add a station in Ads Replacement integration type, after entering the details, you should also upload the Intro and Outro files, which will replace the intro and outro of the ad break in your stream. The Intro and Outro audio files allow us to detect the ad breaks in your stream and serve the ads.

This is a five- step process of adding a new station in Ads Replacement integration. Please complete all required information for each section. It is necessary to finish the process.

Step 1

Please fill in the information related to your station details as: Broadcaster name, type, content category, content language. You will also have to choose the platform on which stream is tuned.

If you choose Web, in the next step you will be asked to implement JS code and adx.txt files. Website containing the radio station player will also be required.

If Mobile is selected, in the next step you will be asked to insert app.adx.txt files. Please note that for the mobile applications provide exactly the same website address as included on the developer webpage in the Apple App Store or Android Google Play Store.

When you are ready please press the button „Next”.

Step 2

At this step of the process you will find a unique JS code snippet to be embedded on the website filled in the previous section.

Please note that the JS code is assigned to your Publisher account, not to the station. It will be the same for every station you set up.

Here it is also ads.txt contents to be implemented on the website indicated in step 1. It is necessary to create an ads.txt file on the domain or append content to the existing file.

Both JS code snippet and ads.txt contents you can also find in the „Integration” tab of AdTonos’ Dashboard.

Please provide required information and when you are ready press the button „Next”. Then verifying JS code and ads.txt implementation is being started.

If the process has status pass you will be taken to step 3.

This image has an empty alt attribute; its file name is learn_step2copy.png

To learn more about embedding JS code and insering ads.txt read https://learn.adtonos.com/docs/publisher/required-actions-on-your-side/.

If the verification fails you will be informed what is missing. After completing the necessary data please press the button „Next” again.

Step 3

This is the place to upload intro and outro files which allow us to detect ad breaks in your stream to serve ads. Please note that intro and outro files must be the same as in the station’s stream. It is necessary to mark station’s Ad Breaks.

You can set up Ad Break Marker Files in a station’s playlist as many times as you plan to have an ad break.

If you don’t have your own jingle to mark an ad break, AdTonos file is available to use and will be sent when requested. Please contact support@adtonos.com

Intro and outro audio files requirements:

At least 128kbps, 44Hz, stereo, mp3, longer than 500ms and shorter than 5000ms, no silence should be heard.

This image has an empty alt attribute; its file name is learn_step3copy.png

When intro and outro files are uploaded please press the button „Next”. Now the process of jingles verification is being started which can take up to 2 hours.

If the verification is correct you will be taken to step 4. You will be informed if the verification failed. In this case please contact suport@adtonos.com.

Step 4

At this step please enter your stream url.

Important: please note that ad breaks must be added in the station’s stream. To go to the next step Ad Tonos system has to detect at least one ad break.

The main link is required, you can also put additional links.

Stream requirements:

64kbps, 44kHz, mono, Supported codecs: MP3, AAC, OGG, HLS, MPEG-DASH.

This image has an empty alt attribute; its file name is learn_step4copy-1024x585.png

When a stream is added please press the button „Next”. Then the streams are being verified which can take up to 30 minut. When an ad break is detected you will be taken to step 5.

Step 5

You are in step 5 which means that the technical verification was successful. Next, the support team starts checking your station integration with AdTonos system. When the process is finished we will inform you by email.

This image has an empty alt attribute; its file name is learn_step5copy-1024x338.png

From this moment the station has status active. Please download your station’s Output url available in the “Stations” tab of AdTonos’ Dashboard and insert it in your player. Your radio should now be on-air and you can start monetizing your audio stream.

Important information: please use the url output link available in the station details. Using urls from the website makes issues with streaming.

Was this article helpful to you? Yes No

How can we help?