Simple Configuration

1. Navigate to http://<url address>/awasr/deployer_html/index.html

(Please request for an account to get the <url address> details)

2. Login as <user name> / <password>

3. Navigate to the Proposition tab, and enter proposition details,

• • Proposition id - unique proposition name

  • Proposition name - unique proposition name, i.e. Course information

  • Proposition type - values must either - topbanner, rightbanner, messagebanner, inboxpromotion

  • Xquery Rules - Define XQuery expressions. Returning -1 equates to false. A positive number is true, see footnote 1.

  • Description - Proposition description

  • Proposition value - set to 0

  • Message - used for messagebanner proposition type. Contains the message to be displayed

  • Click URL - The url which activated if the container is clicked

  • Image reference URL - image references go here. See footnote 2.

  • Journey Order - Determines the order in which multiple 'valid' (see step d.) propositions will be displayed. Non journey propositions should be set to a high number, i.e, 999

  • Journey Stage - Determines the order in which multiple 'valid' (see step d.) propositions will be displayed within the scope of an Journey order. All propositions within a stage must be valid for any proposition to be displayed within that stage. Set to '0' to turn that functionality off (Non journey proposition).

  • HTML Div tagID - The Div tag name within your html file where the container is to be placed

  • Channel - web or mobile

  • userid - breuserid

  • brecontext - A user defined value which defines the circumstances the proposition should be considered for evaluation.

  • Active - switch the proposition on and off.

4. Update web page with JavaScript reference

a. Add the JavaScript references

<script type="text/javascript" src="http://webandserver.com/ws/js/nbaadservclient.js"></script>

b. Call container function

Enter function mandatory call details

controller_nbc.nbc({userid: input_userid, channel : input_channel , breuserid : input_breuserid, brecontext : input_brecontext });

where,

input_userid - customerid (Unique customer identifier)

input_channel - calling channel - web or mobile

input_breuserid - corresponds to the userid defined in step 2.

input_brecontext - corresponds to the brecontext defined in step 2.

Other parameters can be added which are user defined and can be referenced in step 4.b.

For example,

controller_nbc.nbc({userid: $('#customersList').val(), age: customerProfile["CustomerAge"], EventId : msg["EventId"], channel : "web" , breuserid : "breuser", brecontext: "SplashPage"});

The parameters defined above can then be accessed via the rules within the engine in the manner shown in this example,

//request/userid eq 40

Note : xquery expressions are not currently validated. An error in any of the expressions will cause no results to be returned. Please validate before entry.

See the source html of link http://webandserver.biz.tm/ws/usertestharness/ to how the java script of configured.

5. (Optional step) Test configuration using link http://<address url>/usertestharness/.

footnote 1.

Examples of expressions include

let $doc :=.

let $doc2 := if (this.responsecount = 0)

then 1 else -1

let $return_val := $doc2

return $return_val

This translates to return '1' if there are no responses else return '-1' (false)

'this.' is a key word which will allow to access a number of special variables:

responsecount - number of responses for the given proposition

impressioncount - number of impression for the given proposition. Note - this should be used with care. The impression counted equates to number of times a proposition has been sent to the client , but not necessarily displayed.

footnote 2.

A number of test images can be accessed as follows,

images/product-1.jpg

using the test harness link