Documentation Center

Setting up the Footprint Cartridge for the Ambient Data Framework

To enable Footprint functionality, add a JAR file containing the Footprint Cartridge to the set of Cartridges in use by the Session-enabled Content Service, and switch it on in the Ambient Data Framework configuration file, cd_ambient_conf.xml.

Procedure

  1. Access your presentation environment.
  2. Navigate to the configuration location of a Web site for which you have the Ambient Data Framework enabled.
  3. In this location, open cd_ambient_conf.xml for editing.
  4. In the GloballyAcceptedClaims section, ensure the presence of the following Claim child elements:
    <Claim uri="taf:session:preview:preview_session" />
    <Claim uri="taf:claim:ambientdata:sessioncartridge:useragent:browser" />
    <Claim uri="taf:claim:ambientdata:footprintcartridge:acceptlanguage" />
    <Claim uri="taf:claim:ambientdata:footprintcartridge:recurringvisitor" />
    <Claim uri="taf:claim:ambientdata:sessioncartridge:useragent:os" />
    <Claim uri="taf:claim:ambientdata:footprintcartridge:searchquery" />
    <Claim uri="taf:claim:ambientdata:sessioncartridge:session:lifetime" />
    <Claim uri="taf:claim:ambientdata:sessioncartridge:refererdomain" />
    <Claim uri="taf:claim:contentdelivery:webservice:user" />
    <Claim uri="taf:claim:contentdelivery:webservice:post:allowed" />
  5. In the ForwardedClaims section, ensure the presence of the exact same Claim child elements mentioned in step 4.
  6. Save and close cd_ambient_conf.xml and restart your Web site.
  7. Repeat steps 2-6 as needed for other Web sites.
  8. Access the configuration location of your Session-enabled Content Service.
  9. Open cd_ambient_conf.xml for editing.
  10. Within the <Cartridges> section, ensure the presence of the following child element:
    <Cartridge File="footprint_cartridge_conf.xml" />
  11. In the GloballyAcceptedClaims section, ensure the presence of the exact same Claim child elements mentioned in step 4.
  12. Save and close cd_ambient_conf.xml.
  13. Reinstall the Session-enabled Content Service by doing one of the following:
    • If you installed the service using the installService.ps1 PowerShell cmdlet, uninstall it by running uninstallService.ps1. Then run installService.ps1 again, with the same parameter-value pairs you used originally.
    • If you installed the service using the start.ps1 PowerShell cmdlet, kill the process. Then run start.ps1 again, with the same parameter-value pairs you used originally.
    • If you installed the service using the start.sh shell command, uninstall it by running stop.sh. Then run start.sh again, with the same parameter-value pairs you used originally.