Documentation Center

Installing Tracking components on Java Web site

You need to install tracking JAR files and perform configuration files to implement tracking for Online Marketing Explorer on the Presentation Server.

Before you begin

  • Content Delivery API Server Role installed and configured in your Web site, including the Ambient Data Framework.
  • Audience Manager installed and configured, if you want to use a lead generation goal (success is judged on whether a visitor subscribed by entering their details).

About this task

The installation instructions require a Java Web application with the following folder structure:
WEB-INF/
      +--classes/
      +--lib/
  • You need to install tracking JARs to the lib directory.
  • You need to add configuration files to the classes directory.

If your Presentation Server is running on the same machine as Content Delivery, you can put the configuration files in your TRIDION_HOME\config directory and put the Content Delivery JAR files, and third-party JAR files, in your TRIDION_HOME\lib directory.

Procedure

  1. Go to your existing public-facing Web site.
  2. Install the Content Delivery API Server Role—for more information, see the SDL Tridion suite documentation available on the documentation portal.
  3. On Oracle WebLogic Server only, you need to add the antlr.jar installed as part of your Content Delivery installation to the beginning of your server classpath.
  4. Install and configure SmartTarget, if you want to use and track Promotions in your Initiatives.
    For more information, refer to the installation documentation for SmartTarget on the implementor's documentation portal.
  5. Access the Online Marketing Explorer installation media.
  6. Navigate to the folder Content Delivery\roles\web tracking\java\lib and copy the following JAR files into the lib subdirectory:
    • smarttarget_tracking_cartridge.jar
    • tracking_cartridge.jar
    • tracking_core.jar
  7. Navigate to the folder Content Delivery\resources\tld and copy the following file into the lib subdirectory:
    • tracking_tags.tld
  8. Download the JDBC driver (JAR file) required for your specific database vendor and Java version, and copy it into the lib folder:
    Database vendorJDBC DriverFile to download when using Java 5File to download when using Java 6
    Microsoft SQL ServerMicrosoft SQL Server JDBC Driver 3.0sqljdbc.jarsqljdbc4.jar
    Oracle

    Oracle JDBC driver 11.2.0.2.0 or

    Oracle JDBC driver 11.2.0.1.0 (deprecated)

    ojdbc5.jarojdbc6.jar
  9. Add the following code to all relevant Page Templates (to Web pages that use these controls) to register the Custom Tags used for Tracking:
    <%@ taglib uri="tracking_tags" prefix="tracking" %>
  10. Configure your web.xml deployment descriptor and add following to enable tracking tag handling:
    <web-app>
        <jsp-config>
                  <taglib>
                       <taglib-uri>tracking_tags</taglib-uri>
                       <taglib-location>/WEB-INF/lib/tracking_tags.tld</taglib-location>
                   </taglib>
        </jsp-config>
    </web-app>
  11. Configure the Tracking database—see Configuring the Content Data Store for Tracking
  12. Configure logging—see Configuring logback.xml
  13. Configure the Ambient Data Framework—see Configuring cd_ambient_conf.xml
  14. Configure dynamic linking—see Configuring cd_dynamic_config.xml
  15. Restart your Web application server.