Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
xml [2014/05/21 18:18]
hongsudt [Manual Campaign Creation]
xml [2019/08/11 18:11] (current)
ids-shuhao
Line 1: Line 1:
-A data //​campaign//​ can be configured by a //campaign definition//​ which is an XML file describing the structure and properties of the data to be collected. A campaign contains a set of //​surveys//,​ each of which is a sequence of messages or prompts to be displayed. A //message// (e.g. ''​Please get up and walk for 2 minutes.''​) is a brief communication which does not require user input. A //prompt// solicits a response from the user; either an answer to a question (e.g. ''​Did you exercise today?''​),​ or some other form of input (e.g. ''​Take a picture of your snack wrapper''​). Our software supports a rich set of prompt types including: 1) single/​multiple choices with the option for users to define additional choices; 2) number; 3) free-text; 4) timestamp; 5) multimedia such as pictures, videos or audios; and 6) a //remote activity// that launches a third party application,​ such as a game app to assess attention. Each prompt and message can optionally set a condition based on previous prompt responses that determines whether or not it should be displayed. For instance, a prompt ''​Did you take your medication before, after, or without food?''​ can be set to display if the user responded ''​Yes''​ to the previous prompt ''​Did you take medication X this morning?''​ This capability enables a more interactive and responsive survey answering experience. **For the purpose of the Mobilize project, we will only be using a subset of prompts including single-choice,​ number, free-text, and photo.** ​+A data //​campaign//​ can be configured by a //campaign definition//​ which is an XML file describing the structure and properties of the data to be collected. A campaign contains a set of //​surveys//,​ each of which is a sequence of messages or prompts to be displayed. A //message// (e.g. ''​Please get up and walk for 2 minutes.''​) is a brief communication which does not require user input. A //prompt// solicits a response from the user; either an answer to a question (e.g. ''​Did you exercise today?''​),​ or some other form of input (e.g. ''​Take a picture of your snack wrapper''​). Our software supports a rich set of prompt types including: 1) single/​multiple choices with the option for users to define additional choices; 2) number; 3) free-text; 4) timestamp; 5) multimedia such as pictures, videos or audios; and 6) a //remote activity// that launches a third party application,​ such as a game app to assess attention. Each prompt and message can optionally set a condition based on previous prompt responses that determines whether or not it should be displayed. For instance, a prompt ''​Did you take your medication before, after, or without food?''​ can be set to display if the user responded ''​Yes''​ to the previous prompt ''​Did you take medication X this morning?''​ This capability enables a more interactive and responsive survey answering experience. **For IDS, we will only be using a subset of prompts including single-choice,​ number, free-text, and photo.** ​
  
 There are two different ways to create a campaign: ​ There are two different ways to create a campaign: ​
Line 9: Line 9:
   - Create: Users manually create an XML file using any editor of their choice. The campaign XML file has to be well-formed and conform to [[https://​github.com/​cens/​ohmageServer/​wiki/​Campaign-Definition|the ohmage campaign definition schema]]. The following ppt file summarizes the campaign properties and how to create a simple campaign with the XML. For a quick and simple creation, we recommend taking an XML example below as a template and modify the content where necessary. ​   - Create: Users manually create an XML file using any editor of their choice. The campaign XML file has to be well-formed and conform to [[https://​github.com/​cens/​ohmageServer/​wiki/​Campaign-Definition|the ohmage campaign definition schema]]. The following ppt file summarizes the campaign properties and how to create a simple campaign with the XML. For a quick and simple creation, we recommend taking an XML example below as a template and modify the content where necessary. ​
     * [[http://​web.ohmage.org/​~hongsudt/​slides/​CampaignCreation_MZP_PD_2013.pptx|How to create your own campaign (ppt)]] ​     * [[http://​web.ohmage.org/​~hongsudt/​slides/​CampaignCreation_MZP_PD_2013.pptx|How to create your own campaign (ppt)]] ​
-  - Upload: After the campaign definition is created, please login to [[https://lausd.mobilizingcs.org|the Mobilize Web Frontend]], select the campaign tab, then create campaign to upload your campaign. ​+  - Upload: After the campaign definition is created, please login to [[https://tools.idsucla.org|the Mobilize Web Frontend]], select the campaign tab, then create campaign to upload your campaign. ​
  
 == Campaign XML Examples == == Campaign XML Examples ==
Line 25: Line 25:
     * Mac OS: [[http://​www.barebones.com/​products/​textwrangler/​|Text Wrangler]]     * Mac OS: [[http://​www.barebones.com/​products/​textwrangler/​|Text Wrangler]]
     * On-line XML editors: [[http://​collabedit.com/​]],​ [[http://​www.xslfiddle.net/​]],​ [[http://​icecoder.net/​]]     * On-line XML editors: [[http://​collabedit.com/​]],​ [[http://​www.xslfiddle.net/​]],​ [[http://​icecoder.net/​]]
- +. 
-==== Campaign ​Authoring Tool (alpha version) ==== +==== Campaign ​Manager ​(alpha version) ==== 
-[[http://lausd.mobilizingcs.org/campaignAuthoringTool|Campaign Authoring Tool]] provides an interactive Graphic User Interface (GUI) for the entire campaign creation process. [[https://​wiki.mobilizingcs.org/​app/​authoring|The campaign authoring wiki page]] provides the how-to and tutorial. ​Please note that the tool is still under development.  ​+[[https://tools.idsucla.org/#campaigns/]] provides an interactive Graphic User Interface (GUI) for the entire campaign creation process. [[https://​wiki.mobilizingcs.org/​app/​authoring|The campaign authoring wiki page]] provides the how-to and tutorial. ​
  
Print/export