MANUAL Windows Live Messenger Activity with parameters
Summary A is a web page (HTML/DHTML) that takes advantage of the multiuser communication functionality provided by Windows Live Messenger. This means it can be simultaneously accessed by two or more users. Admotion allows this social and viral feature on any ad format. The creative piece linked with a Windows Live Messenger Activity must include the necessary code to launch it. The functionality consists of two instances: Launcher Creativity The piece should meet the ad format specification. It must include the following line: #include "msnactapi.as" It must include a button with the following code: callwidget("variable", "value"); Where "variable" and "value" figures the data set that will be sent to the Activity application. These parameters are optional and can be sent up to five per creative. The variables names and the variables values have a maximum of 80 characters. Dimensions: 480px (w) 480px (h) Format: HTML/DHTML The document body must not have margins (equals to zero) in order to engage the entire available area
How it works 1. Launcher Creativity: The final user optionally fills the variable fields and clicks on the button which contains the launching code. (Figure 1) 2. Starting activity: A Windows messenger dialog box pops up, showing the user s contact list. Then, he searches and selects one or more friends to share. (Figure 2) Figure 1 3. Approval: The remote user must accept an invitation in order to launch the application for both sides Figure 2
4. Sharing: The shared experience begins, both users simultaneously access to the web page. In addition, the Windows Live Messenger Activity may identify the sender and the receiver giving the chance to create different designs for each one of them. (Figure 3) Figure 3
The activity can be hosted on any server and requires only one line of code inside the document body: <SCRIPT LANGUAGE="JavaScript" src="http://nspmotion.com/js/msnactapi-v2.js"></script> This initializes Admotion JavaScript API for Windows Live Messenger Activity. Example code: <!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.0 Transitional//EN > <HTML> <HEAD> <TITLE>MSN Activity</TITLE> </HEAD> <BODY style="margin:0px"> <!-- CONTENT --> <SCRIPT LANGUAGE="JavaScript" src="http://nspmotion.com/js/msnactapi-v2.js"></script> </BODY> </HTML> Sharing the activity The activity also requires the following line in the first frame Actions panel: #include "msnactapi.as" The msnactapi.as must be saved on the same folder as the FLA file. To share the activity, from a shared activity, apply the launch method to a button: callwidgeturl ("variable", "value");
Where variable and value figures the data set that will be sent to the Activity application. These parameters are optional and can be sent up to five per creative. The variables names and the variables values have a maximum of 80 characters. For example: callwidgeturl("sender", "John", "recipient", "Michael"); The application receives these parameters thru the Flash object flashvars. Use the flashdata property of the Admotion API to embed the Flash object: An example of how to retrieve the data within the application Flash object: var sendername = getvalue("sender"); var recipientname = getvalue("recipient"); In addition, the may identify the sender and the receiver. This is possible with the _root.admactivityinviter variable: if(_root.admactivityinviter == "true"){ // Sender code else { // Recipient code document.write('<object classid="clsid:d27cdb6e-ae6d- 11cf-96B8-444553540000" WIDTH="480" HEIGHT="480">'+ '<PARAM NAME=movie VALUE="movie.swf">'+ '<PARAM NAME=flashvars VALUE="'+ADMapi. flashdata+'">'+ '<EMBED src="'+thesrc+'" quality=high WIDTH="480"'+ 'HEIGHT="480" flashvars="'+admapi. flashdata+'" TYPE="application/x-shockwave-flash"> </EMBED></OBJECT>');
Activity interaction tracking (POI) Admotion JavaScript API for Windows Live Messenger Activity also allows tracking any point of interaction (POI) in the activity. Each POI has a unique identifier which is sent as a parameter to the tracking method. JavaScript example code: ADMapi.MSNActivity.poi(id); ActionScript example code: geturl("javascript:admapi.msnactivity.poi(id);","_self"); Windows Live Messenger Activity SDK The software development kit (SDK) includes technical information about how to develop and test single-user and multiuser applications by using the Activity object model. The SDK also provides detailed information about the Windows Live development and testing requirements that your Activity must meet, and how to increase the usage of your Windows Live Messenger Activity application. Available on: http://msdn.microsoft.com/en-us/library/aa751024.aspx Creative assets submissions Activity page URL. A list of all the points of interaction to track.