Configuring the Message Connector

Before you deploy the Message Connector, you must customize the configuration file included with your installation to match your specific environment. You can modify the XML file called MessageConnectorConfig.xml found in your Message Connector directory on the Unica Interact runtime server, similar to <Unica Interact_home>/msgconnector/config/MessageConnectorConfig.xml.

About this task

The MessageConnectorConfig.xml file contains some configuration settings that are required, and some that are optional. The settings that you use must be customized for your specific installation. Follow the steps here to modify the configuration.

Procedure

  1. If the Message Connector is deployed and running on your web application server, undeploy the Message Connector before continuing.
  2. On the Unica Interact runtime server, open the MessageConnectorConfig.xml file in any text or XML editor.
  3. Modify the configuration settings as needed, making sure that the following required settings are correct for your installation.

    • <interactUrl>. The URL of the Unica Interact runtime server on which the Message Connector runs and to which the Message Connector page tags must connect.

    • <interactUsername>. The Unica Interact username authenticates Message Connector with Unica Interact runtime. It is required when Unica Interact API authentication (Affinium|interact|general|API) is set to True.
    • <interactPassword>. The Unica Interact password authenticates Message Connector with Unica Interact runtime. It is required when Unica Interact API authentication (Affinium|interact|general|API) is set to True. Only the passwords, encrypted using the Platform’s encryptPasswords utility are valid. Plain text passwords are not allowed.

    • <imageErrorLink>, the URL to which the Message Connector will redirect if an error occurs while processing a request for an offer image.

    • <landingPageErrorLink>, the URL to which the Message Connector will redirect if an error occurs while processing a request for an offer landing page.

    • <audienceLevels>, a section of the configuration file that contains one or more set of audience level settings, and which specifies the default audience level if none is specified by the Message Connector link. There must be at least one audience level configured.

    All of the configuration settings are described in greater detail in Message Connector Configuration Settings.

  4. When you have completed the configuration changes, save and close the MessageConnectorConfig.xml file.
  5. Continue setting up and deploying the Message Connector.