Campaign

From Mobitouch cube

The Campaign is one of the core entities of Mobitouch CUBE. A campaign is defined as: "a set of contents to be delivered in a precise time-schedule by a set of transmitting nodes"

Contents 1 Campaign Basics 1.1 Campaign Status 2 Creating a new campaign 3 Editing Campaign parameters 3.1 Scheduling editing 3.2 Content editing 3.3 Contents forwarding 3.4 Node Association

Campaign Basics

The concept of campaign is the core-concept in any Proximity Marketing platform. Every action to be performed is campaign-specific and statistical data gathered from the field is also related to a particular campaign.

Campaign Status

Within the Campaigns manager is it possible to view the status of a campaign according to the following legend:

• Paused, the campaign is waiting to be executed

• Disabled, the campaign has been disabled by the user and won't never be executed until enabled once more by the user

• Active, the campaign is up and running

Creating a new campaign

To create a new campaign you can use one of the following methods

1. Create a new campaign from the system menu (Campaigns->Create new campaign)
2. Create a new campaign from the campaign manager ("Create new" button)

you will be redirected to the edit campaign view

Editing Campaign parameters

Follows an explanation of the main properties of a campaign.

Scheduling editing

The periods of execution of a campaign. It is possible to select multiple periods of execution creating complex scheduling of the campaigns to fulfill any need. Any period of time is composed by a starting date, an end date and a periodicity. Within the start and end date the campaign is executed according to the type of periodicity:

• Always, the campaign is always active during the time between the start and end date

• Days of Week, the campaign is active only during the specified days of week included within the start and end date. For each day selected it is possible to choose whether execute the campaign for the entire day or for specific hours of the day

• Days of the month, the campaign is active only during the selected days of the month included within start and end date. For each day selected it is possible to choose whether execute the campaign for the entire day or for specific hours of the day

• Every day, the campaign is active everyday within the start and end date but it's possible to active the campaign only for specific hours of the day

• Preferred hours, the campaign is active only in the hourly intervals specified.

• Every X minutes, the campaign is active every X minutes, useful to set up campaign you want to start and stop very often (every 5 minutes for example)

Content editing

The contents are the software abstraction of the files actually sent to the users mobile phones. A campaign can contain one or more contents, but usually it is better not to send more than three contents to avoid annoying the users. A content is composed by:

• Name, the name has just a mnemonic role

• Description, the description has just a mnemonic role

• Policy, the policy instructs the node on how to send the files included in the content. There are three types of policy:

• • Simple, the content is composed by one and only one file that is sent to any detected device.

• • Class of devices, the content is composed by one or more files and each file must be addressed to a different class of devices (ex. cellulars, smart-phones, etc...). This policy allows to set a default file, that has to be sent when the remote mobile device contacted is not included in other files settings.

• • Device identification, the content is composed by one or more files and each file must be

addressed to a different subset of mobile device models. The selection of each set of device models is based on the supported features and characteristics of the mobile devices. This policy allows to set a default file that has to be sent when the remote mobile device is not included in the other files settings. For example, you can create a content with two files: an mp3 file that has to be delivered to mobile devices that support mp3 and a midi (default) file for all others mobile devices.

• TwoWay - Messaging

• Bonus content

• Files, the files to be actually sent according to the selected policies. The user can choose the files among the one stored into his account repository (refer to Contents repository for further details).

Contents forwarding

The Contents forwarding allows the WLP-500 to receive contents form users mobile phone and to forward them to a server. On the server a web-application can show the users contents within a gallery, a blog, etc... It's necessary to install on the server a web-server capable to manage the file upload trough HTTP (Apache, IIS, Tomcat, etc...) and a web technology such as PHP, ASP or JSP. Please note that is mandatory to enable the writing permissions for the web-server folders. The WLP-500 you want to receive contents form users mobile phones must be configured fulfilling the Forward to URL text-box with a valid URL.

For example http://server-address/fileupload.php, where server-address is the address of your server and fileupload.php is the script managing the submit form used to receive a file from the WLP-500. Give it a fast try insert the Waymedia URL http://waymediapm.waymedia.it/forward/fileupload.php and share with us your photos posted on our web gallery http://waymediapm.waymedia.it/forward/index.php . An example of script managing the reception of a file is the following:

<?php
	
$uploaddir = './uploads/';

if(is_uploaded_file($_FILES['uploadedfile']['tmp_name']))
{
	$receivedFile=$uploaddir."/".$_FILES['uploadedfile']['name'];
	move_uploaded_file($_FILES['uploadedfile']['tmp_name'], $receivedFile);
}
	
?>

In this case into the path containing such a script file you have to create a folder named uploads, the location where the files coming from the WLP-500 will be stored. If you want to test your web-server configuration just store on the web-server, an HTML file like the following:

<html>
<head><title>File Upload Function</title></head>
<body>
<form action="fileupload.php" method="post" enctype="multipart/form-data">
    <!-- Campo file di nome "image" -->
    <input name="uploadedfile" type="file" size="40" />
    <br /><br />
    <!-- Pulsante -->
    <input name="upload" type="submit" value="Carica immagine" />
</form>
</body>
</html>

Open your browser go to http://server-address/test.html (supposing that we called the previous html file test.html) and try to upload a file from your PC.

If the Enable contents forwarding only (no contents push) check-box is checked, the WLP-500 doesn't send any content to the phone(As you can see, the Contents panel will disappear).

Node Association

The node or set of nodes that have to execute the defined campaign.