Documentation Center

Installing Tracking components on .NET Web site

You need to install tracking DLLs and 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 .NET Web application with the following folder structure:
root\
   +--bin\
      +--config\
      +--lib\
  • You need to install tracking DLLs to the bin directory.
  • You need to install tracking JARs to the lib directory.
  • You need to add configuration files to the config 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. Open Internet Information Services (IIS) Manager.
  2. Go to your existing public-facing Web site.
  3. Install and configure the Content Delivery API Server Role—for more information, see the SDL Tridion suite documentation available on the documentation portal.
  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 Content Delivery\roles\web tracking\dotNet\bin\ and copy the following files to the bin folder of your Web application:
    • Tridion.Tracking.Core.dll
    • Tridion.Tracking.Interop.dll
  7. 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
  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. Open your web.config deployment descriptor in a text editor:
    1. Make sure you have configured it for the Ambient Data Framework filter.
      In IIS 6.0:
      <system.web>
          <httpModules>
            <add name="AmbientFrameworkModule" type="Tridion.ContentDelivery.AmbientData.HttpModule" />
          </httpModules>
      </system.web>
      In IIS 7.0/7.5:
      <system.webServer>
          <modules>
            <add name="AmbientFrameworkModule" type="Tridion.ContentDelivery.AmbientData.HttpModule" />
          </modules>
      </system.webServer>
    2. To handle tracking Web server controls on an ASPX page, add the following in the <system.web> section:
      <system.web>
          <pages>
            <controls>
              <add tagPrefix="tracking" namespace="Tridion.Tracking.Core.WebControls" assembly="Tridion.Tracking.Core"/>
            </controls>
          </pages>
      </system.web>	
  10. Configure the Tracking database—see Configuring the Content Data Store for Tracking
  11. Configure logging—see Configuring logback.xml
  12. Configure the Ambient Data Framework—see Configuring cd_ambient_conf.xml
  13. Configure dynamic linking—see Configuring cd_dynamic_config.xml
  14. Restart your Web application server.