Campaigns is a tool that allows you to organize content playback placement and timing of your Contents, Messages, Files or even your files in your Folders

How to create campaigns

In the beginning, you have to navigate yourself into

Settings > Campaigns

The Add new campaign modal has 4 parts:

• Basic information
• What to play?
• Where to play?
• When to play?

Basic information

Basic information has the following fields:

• Name : the name of the campaign
• Priority: helps with the ordering of the Campaign if there are multiple campaigns
• Enable advertiser: enables Campaign to report to Advertiser's Proof of Play statistics

Ordering multiple Campaigns

Campaigns will be played in the order of Priority: 1 first 2 second, etc. If multiple campaigns have the same priority (e.g 1) then those campaigns will be played in alphabetical order.
This ordering will be relevant later, when we discuss Campaign playlist.

What to play?

In the 'Type' field there are several options you can choose from:

• Content
• Content by tag
• Message group
• Files
• Folders

Firstly we will see the Content option

You can choose between 2 options if you want to use Contents in your campaign:

Content

This option allows you to choose your contents that you have previously made

With this option you can order your Contents with the Content browser modal

Content by tag

Contents can also be chosen by tags. You can add tags to your Contents on Home Screen

For further options you can select to filter the tags with Content tag filter type to match All or Any of the chosen tags

Message

You can choose Message group instead of Contents, this method will take your chosen message groups into your campaign.

More about Messages option and Message groups: Messages Menu

Files

If you choose Files option, you will be able to select the files you want to play in your Campaign from the file selector.

You will also see a box named Default media duration, where you can set the duration of your media items that don't have a duration of their own e.g. images.

Inherit item duration means that the files will be played as they are.
For example: you choose a video with 4 sec playtime, and an image with Default media duration of 10 sec from the file selector.
Inherit item duration will play the video for 4 seconds and the image for 10 seconds.

If you switch off the Inherit item duration you will see another box named Maximum item duration. This will maximize for how long the items will be able to play.

Please note that, the shorter duration between 'Maximized item duration' and 'Default media duration' will always be applied.

Take the previous example: you choose a video with 4 sec playtime, and an image with Default media duration of 10 sec from the file selector and set the Maximum item duration to 5 sec.
This means the video will be played for only 4 sec, and WILL NOT be restarted to fill out the 5sec. Similarly the 10 sec image will be cut down to 5 sec.

Folders

Folders option is similar like files, but you have to choose folders instead of files.

In the box of Ordering mode you can switch between random and alphabetical.

‍

‍

Where to play?

Where to play option determines to which Screens the campaign will apply.

Please note that there is AND logical connection between "Screen groups" and "Screen tag" filter. This means that the tag filter will only look for screens that are in the selected Screen groups.

When to play?

Campaigns can also be setup to play at certain times. The basic setup only requires a starting date.

‍

You can also customize this setup with:

• Play indefinitely (End date selector)
• Every day (day selector for Affected days)
• All day (hour selector for Affected hours)

Assign Campaigns to devices

First, you have to add a Campaign widget within your content,

Assign your content to your device and the Campaign is ready to use.

Please note that Campaigns do not have master/overlay page, can not use navigations, interactions or animations.

Campaign playlist snaphot

After you assigned your content containing the Contents widget with Campaign mode enabled you can see your campaign playout on your device.

You can download the Campaign playlist snapshot from the right click context menu of a screen

This will generate a PDF file from the given From date with the given Iteration amount

An iteration in the context of the campaign playlist means the following:

In each iteration only exactly one media from each campaign is played (one page from the contents, one message from the group, one file, one file from folder etc).
It doesn't matter if more than one bundle is pulled in (e.g if there are multiple contents in one campaign), it doesn't matter if the campaign is longer than the media, it just switches when it's done. If the length of the campaing is less than the media, it will cut the media for the campaign runtime.
The order of the campaigns will be determined by the Priority setup in Settings > Campaigns and if multiple campaigns have the same priority then they will be ordered alphabetically.

Here is an example of a complex campaign system, and its snapshot

All day every day

• Campaign 1 : Content 1 (has 3 pages)
• Campaign 2 : Content 2 (has 2 pages), Content 3 (has 3 pages)

12:00 - 23:59 every day:

• Campaign 3 : Content 4 (has 2 pages)

12:00 - 23:59 on Weekdays

• Campaign 4 : Content 5 ( has 3 pages), Content 6 (has 1 page)

00:00 - 12:59 on Monday, Wednesday, Friday

• Campaign 5 : Content 7 (has 2 pages)

For ease of understanding every page of the contents are 5 secnonds long.

If you download the Campaign snapshot on Friday at From date 12:50 with iteration number set to 3 you will get the following

Let's review why Iteration #1 looks like this

All day every day

• Campaign 1 – Content 1 - Page 1
• Campaign 2 – Content 2 - Page 1 (we have Content 3 in this same campaign, but remember only 1 media per campaign is allowed in one itaration)

12:00 - 23:59 every day (12:50 is in this time interval)

• Campaign 3 – Content 4 - Page 1

12:00 - 23:59 on Weekdays (12:50 is in this time interval, and because of weekdays Friday is included)

• Campaign 4 – Content 5 - Page 1 (we have Content 6 in this same campaign, but remember only 1 media per campaign is allowed in one itaration)

00:00 - 12:59 on Monday, Wednesday, Friday (12:50 is in this time interval, and Friday is included)

• Campaign 5 – Content 7 - Page 1

Here are the following 2 iterations

‍