WebConnector Configuration HTML Display Types

Use the HTML Display Types page to determine the HTML code that will be provided for each interaction point on the page. You can choose from the list of default templates (.flt files) that contain some combination of cascading style sheet (CSS) code, HTML code, and JavaScript™ code to use for each interaction point. You can use the templates as provided, customize them as needed, or create your own.

Configuration settings on this page correspond to the interactionPoints section of the jsconnector.xml configuration file.

The interaction point can also contain placeholders (zones) into which offer attributes can be dropped automatically. For example, you might include ${offer.TREATMENT_CODE}which would be replaced with the treatment code assigned to that offer during the interaction.

The templates that appear on this page are loaded automatically from the files stored in <Interact_home>/jsconnector/conf/html directory of the Web Connector server. Any new templates you create here are also stored in that directory.

To use the HTML Display Types page to view or modify any of the existing templates, select the .flt file from the list.

To create a new template on the HTML Display Types page, click Add a Type.

Regardless of the method you choose to create or modify a template, the following information appears next to the template list:

Setting

Description

Equivalent setting in jsconnector.xml

File name for this display type

The name assigned to the template you are editing. This name must be valid for the operating system on which the Web Connector is running; for example, you cannot use a slash (/) in the name if the operating system is Microsoft™ Windows™.

If you are creating a new template, this field is preset to CHANGE_ME.flt. You must change this to a meaningful value before continuing.

HTML Snippet

The specific content that Web Connector should insert into the Interaction Point on the web page. This snippet can contain HTML code, CSS formatting information, or JavaScript™ to be executed on the page.

Each of those three types of content must be enclosed by BEGIN and END codes, as in the following examples:

${BEGIN_HTML} <your HTML content> ${END_HTML}

${BEGIN_CSS} <your Interaction Point-specific stylesheet information> ${END_CSS}

${BEGIN_JAVASCRIPT} <your Interaction Point-specific JavaScript code> ${END_JAVASCRIPT}

You can also enter a number of pre-defined special codes that are replaced automatically when the page is loaded, including the following:

${logAsAccept} : A macro that takes two parameters (a target URL, and the TreatmentCode used to identify the acceptance of the offer) and replaces it with the click-through URL.

${offer.AbsoluteLandingPageURL}

${offer.OFFER_CODE}

${offer.TREATMENT_CODE}

${offer.TextVersion}

$offer.AbsoluteBannerURL}

Each of the offer codes listed here represent offer attributes defined in the offer template in IBM® Campaign that was used by the marketer to create the offers that Interact is returning.

Note that the Web Connector uses a template engine called FreeMarker that provides many additional options that you may find useful in setting up codes on your page templates. See http://freemarker.org/docs/index.html for more information.

No equivalent because the HTML snippet resides in its own file separate from jsconnector.xml.

Example Special Codes

Contains samples of the type of special codes, including codes that identify blocks as HTML, CSS, or JAVASCRIPT, and droppable zones you can insert to refer to specific offer metadata.

No equivalent.

Your changes to this page are saved automatically when you navigate to another Web Connector configuration page.