What is JSConnector?
Where is it available:
JSConnector comes built-in as part of the Interact Runtime Web application (post Interact version 8.1). It can also be deployed separately as its own web app, configurable to communicate with the remote Interact Runtime instance.
In addition to the web app, there is a configuration directory that will contain all the configuration files used to manage the behavior of the JSConnector. For convenience purposes, the web app comes with a web page that will help administer most of the features available in these configuration files ( https://host:port/<interact>/jsp/WebConnector.jsp )
Inbuilt JS Connector :
If you are relying on the JSConnector service that is built in to the Interact, then the only thing that needs to be done is to set two Java properties at the start-up of the app server that will tell the system where the JSConnector root directory (that contains the conf data) resides on the file system.
-DUI_JSCONNECTOR_HOME=<jsconnectorHome> [For e.g. -DUI_JSCONNECTOR_HOME=E:\u101\Interact\jsconnector]
Demonstration with test data :
- Create an Interactive channel “IC_web” and mapped customer audience table
- Create a zone ‘Z1’ and an interaction point ‘IP1.’
- Create two events “present” as contact and “accept” as accept event
- Create a new session and add an interactive flowchart
- Add Interaction PB, decision PB (only one branch as all records) and Populate Seg PB (Segment name is “Allseg”)
- Go to the campaign setting and add offer attributes (AbsoluteLandingPageURL as a string, TREATMENT_CODE as a string, TextVersion as string and AbsoluteBannerURL as string)
- Create an offer template and all attributes
- Create a new offer
- AbsoluteLandingPageURL – https://www.spain.info/
- TREATMENT_CODE – 1
- TextVersion – 12
- AbsoluteBannerURL – https://www.map-of-spain.co.uk/maps-of-spain/spain/map-of-spain2.jpg
- 9. Create a new campaign and add an interaction strategy. Add “Allseg” smart segment and assign Offer (Webconnector_Offer)
- 10. Deploy the Interactive channel.
Configurations in JS Connector
A. Navigate to /jsconnector/conf directory, and edit jsconnector.xml file.
B. Copy the attached WebConnector_TestPage.html in the local directory.
Edit WebConnector_TestPage.html and set the correct URL for unicaWebConnectorBaseURL
C. Restart the application server.
D. Open the WebConnector URL
https://<interacr runtime host:port/interact/jsp/WebConnector.jsp
E. Click on Basic Settings (these settings should be picked up from jsconnector.xml, so no need to change anything here. Just make sure the URL and IC name are correct).
F. Setting for Most Interaction Point (The HTML Element ID should be the name of the HTML file that we created for testing)
G. Click on “Rollout the changes” and click on “Generate the finished configuration XML.”
It should give a pop up as “Your configurations were saved successfully,” and jsconnector.xml should get updated.
H. Click on Enhanced Pages > Click on WebConnector_TestPage.
I. Fill the information on Interaction Points (offer display locations) on this page or set of pages.
Here IP1 should be IP name picked up from jsconnector.xml and the name of the IP from your IC.
J. Click on basic settings and Select events.
The three drop-downs should list the events from your IC. Again, these values are picked up from jsconnector.xml
K. In HTML Display types, we are using Image_Banner_Link.flt
L. Click on “Roll out the changes.”
Test for jsConnector
- We are using following jsconnector url
- Click on the Reload Configuration link. It should display the message as “Configuration reload successful”.
- Set URL: https://<interacthostName:PortNumber>/WebConnector_TestPage.html
Session Cookie name: SessionID
SessionId Value : 123
VisitorID : CustomerID
Visitorid value: 10001
- Click on Execute PageTag
5. Click the OK button on the Popup.
6. The offer Image should be displayed. This is set in the field ‘ AbsoluteBannerURL’ while creating offers.
This is treated as Offer Contact.
- Click on the image. Users should navigate to the web page set in the field ‘ AbsoluteLandingPageURL.’
This is treated as offer Accept.
The JSConnector is used to design web pages and capture customer responses on the page, which may not have server-side programmatic control over the page display. These responses [offer accept/reject/contact] from the customer are captured and inserted into the staging tables of interact. With the normal ETL process, this data gets transferred into the campaign history tables and then used for reporting and for the interact learning functionality.