Polling Banner Known Issues Implementing the Block Configuring in Flash... 3 AS AS3... 8

Transcription

1

2 Polling Banner... 2 Known Issues... 2 Implementing the Block... 3 Configuring in Flash... 3 AS AS Setting Up in the Sizmek MDX Platform... 12

3 Polling Banner The Polling Banner Block allows you to create a poll in your ad by using the Data Capture component. You can implement this feature by setting up a form in the Sizmek MDX platform at the ad campaign level. The template works as follows: the user can answer one question, the data is saved in the campaign form and after the user answers the question the poll results are displayed in a chart as follows: Note: The data is only recorded after the campaign starts. No data will be recorded prior to the campaign start date. Demos/Downloads To view a technical demo, click here. ( Banner) To download this block and start using it now: Known Issues If you receive this error when publishing the FLA, you need to update your Workshop for Flash (MXP). Click here ( to download the latest MXP.

4 In general: Note: Viewing the ad in preview mode in the Sizmek MDX platform will not save data in the form and you will not get any polling results. The polling results are in XML format which is built in the Sizmek MDX platform (only for forms that have fields where the polling checkbox is checked). The XML file will be updated up to 1 hour. Implementing the Block The Polling feature is implemented in Flash and in Sizmek as follows: Flash - configure the ad as follows: Sizmek after uploading the assets verify that you attach the ad to an existing form that you defined in the Sizmek MDX platform in the campaign level or create a new form. Configuring in Flash AS2 Creating the Polling Questions Form 1. Open the FLA file: MMpoling_300_250_AS2.fla 2. Select the DataCapture component on the stage and open the Component Inspector. 3. Define the formname. The formname should be the same name when setting up the Data Capture settings in the Sizmek MDX platform.

5 Note: The format and securedprotocol parameters are not used in this block and therefore do not need to be defined. For more information on how to set-up Data Capture forms, see Setting up Data Capture Forms ( 4. Edit your question: 5. Edit the buttons according to your needs (change the text, color, state, etc.) 6. Open the com\mediamind\polling\mmform.as file and adjust the script according to your changes. Note: The ActionScript files are included with the #include method in the Polling MovieClip time line.

6 Showing the Polling Results 1. The Polling Block automatically detects whether the asset is served online or offline (local preview or Workshop preview, respectively). When the asset is served offline, the ad loads the local pollingtest_1.xml file. This file contains static data. 2. The polling result XML file structure is as follows: 3. Adjust the messages as follows: In this block the polling results are displayed in a chart as follows: The showchart function in line 113 handles the chart results. (The MMpollLoad function calls the showchart function after the polling data was loaded and is ready to use).

7 4. Change the field name according to your pre-existing form in the Sizmek MDX platform as follows: Note: The pollfieldvotes array structure that the MMpoll returns is an object that contains the parameters fieldvalue ; counter ; and 'percent. 5. The following script builds the chart from the results: 6. The following script adds a text box with the total vote number for the field: (if you don t want to show this feature you can remove the script) :

8 7. To customize the chart Column, open the library and select the column. Adjust the movie clip according to your needs. 8. Another way to get polling data is using the showsinglevote function in line178. You can get the data results for a Specific field and value. In this template the results are displayed in the trace output.

9 AS3 Creating a Polling Questions Form 1. pen the FLA file: MMpoling_300_250_AS3.fla 2. Select the DataCapture component on the stage and open the Component Inspector. Define the formname. The formname should be the same name when setting up the Data Capture settings in the Sizmek MDX platform. Note: The format and securedprotocol parameters are not used in this block and therefore do not need to be defined. For more information on how to set-up Data Capture forms, see Setting up Data Capture Forms ( 3. Edit your question: 4. Edit the buttons according to your needs (change the text, color, state, etc.):

10 5. Open the com\mediamind\polling\mmform.as file and adjust the script according to your changes. Showing Polling Results 1. For testing your polling results use the local xml file. The publishstatus value should be offline. Note: When you are done and the ad is ready to be uploaded to the Sizmek MDX platform change the publishstatus to online. The polling result XML file structure is as follows: Note: It can take up to one hour for the XML file to be updated.

11 2. Adjust the messages as follows: 3. In this block the polling results are show in a chart as follows: The showchart function in line 120 handles the chart results. (The MMpollLoad function calls the showchart function after the polling data was loaded and ready to use). 4. Change the field name according to your pre-existing form in the Sizmek MDX platform as follows: Note: The pollfieldvotes array structure that the MMpoll returns are objects that contain the parameters fieldvalue ; counter ; and percent.

12 5. The following script builds the chart from the results: 6. The following script adds a text box with the total vote number for the field: (if you don t want to show this feature you can remove the script ) 7. To customize the chart Column, open the library and select the column. Adjust the movie clip according to your needs.

13 8. Another way to get polling data is using the showsinglevote function in line180. You can get the data results for a Specific field and value. In this template the results are displayed in the trace output. Setting Up in the Sizmek MDX Platform Note: Before you upload your ad to the Sizmek MDX platform make sure you change the publish status in the form.as file to be online. You can implement the Polling block by creating a form with the name "pollingform" in the Sizmek MDX platform as follows. 1. Upload your ad to the Sizmek MDX platform. 2. Go to Manage > Ads then find and select your ad from the Ads list. 3. Click Edit. 4. Select the Advanced Features tab and expand Data Capture.

14 5. Click Add New, define the fields and make sure the Polling checkbox is selected as follows: 6. Define the form names that were identified in the ad as follows: For more information on how to create data capture forms please see the Sizmek Help Creating Data Capture Forms ( cads.html) (login required).

15