Table of Contents

Advertising Scheduling in mAirListDB

This article explains how to use advertising scheduling in mAirListDB, either by importing traffic logs from external software, or buy using the (simple) built-in scheduler.

Advertising will be scheduled using the Mini Scheduler, so we assume that you have followed the Music Scheduling tutorial, and have hour templates set up as as required. At that point, you will be able to add advertising breaks to your hourly schedule.

Advertising Block Setup

Defining the blocks

The first step is to decide about the (maximum) number of advertising blocks/breaks you will have per hour, and set up the block accordingly. Open the mAirListDB app and go to Administration → Advertising Setup, which will bring up the following dialog:

First, adjust the number of available blocks (per hour) as required. We currently support up to 16 blocks per hour, which should be more than enough for most purposes.

Thereafter, select a block from the list on the left, then edit its properties:

Once you have set up all blocks as required, you can continue to add them to your hour templates.

Adding advertising to the hour templates

Go to Administration → Manage Templates and edit your hour templates. In the list of the available template items on the left, you will see one named Advertising. Drag one or more of these into the desired positions:

Double-click each item, and select the corresponding block (see above) for this ad break:

We strongly recommend that you use containers for all advertising blocks; but rather than setting the container options on the Settings tab in this dialog, you should check the Always use a container option the advertising block setup (see above), to make the Update Advertising function work.

Once you have added the ad blocks to your hour templates, you can re-run scheduling to create new playlists with the ad blocks included. They will initially be empty - now it's time to fill them with content.

Importing Traffic Logs

mAirList can import most traffic logs created by external software, given that they are available in one of the playlist format that mAirList understands. We encourage you to use mAirList's Text Playlist Import (TPI) format when available, but any other format like M3U will do as well.

To set up a block for import, edit the block in the Advertising Settings dialog, set its source to e.g. Source 1, and click Configure to set up the import file location and format:

In the above example, we use TPI-style files, with a separate file per block, all located in the same folder, and named <Year>-<Month>-<Day>-<Block Number>.tpi.

Some useful notes:

Using the Built-In Scheduler

mAirListDB has a very simple advertising scheduler built in that can be used to schedule spots based on campaigns and hour/blocks selected by the users.

To use a spot with the internal scheduler, edit its properties in the DB library, go the Scheduling tab, and to the Advertising sub-tab:

First, you must add a new campaign. A campaign is a period of time in which the spot is going to be broadcasted. It can have a start and/or end date, or start instantly and run indefinitely. You can set up multiple campaigns at the same time, and also disable running campaigns temporarily. Spots can be filtered by campaign in the DB Library tree.

You can devide about the placement of the spot within the block: anywhere, towards the beginning or towards the end. This can be fine-tuned by setting the priority value accordingly. You can also specify another spot that is used as the reminder, i.e. that is added at the end of the ad block whenever the current spot is being used.

If you are using multiple stations and/or regions, select them as required.

In the Hour/Block Selection grid, check the days/hours/blocks where the spot should be used. You must do so manually (this is where mAirList is different from a full-featured advertising scheduler), but it is possible to save/restore often used assignments using the right click menu.

Hint: Click a column header to toggle all blocks for the entire day; click a row header to toggle all days for that block; shift+click a row header to toggle the same block for all hours of the day.

Using the "Update Advertising" Function

Advertising blocks are created (and filled with content) at the time that you run the scheduling for the particular hours.

But it can often happen that the advertising content changes later. For example when there is a last-minute booking or cancellation. Or if the scheduling is performed long before the traffic logs are available.

For that reason, mAirList includes an Update Advertising function that will redo the advertising scheduling for the selected hours, and update the playlists accordingly.

You must enable the Always use container option in the ad block settings to make Update Advertising work. Without that option, and the containers, mAirList will not be able to identify the start end end of the ad blocks within the hourly playlist.

The Update Advertising function is available in various places: