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
- Access your presentation environment.
- Navigate to the configuration location of a Web site for which you have the Ambient Data Framework enabled.
- In this location, open cd_ambient_conf.xml for editing.
- In the
GloballyAcceptedClaimssection, ensure the presence of the followingClaimchild 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" /> - In the ForwardedClaims section, ensure the presence of the exact same
Claimchild elements mentioned in step 4. - Save and close cd_ambient_conf.xml and restart your Web site.
- Repeat steps 2-6 as needed for other Web sites.
- Access the configuration location of your Session-enabled Content Service.
- Open cd_ambient_conf.xml for editing.
- Within the
<Cartridges>section, ensure the presence of the following child element:<Cartridge File="footprint_cartridge_conf.xml" /> - In the
GloballyAcceptedClaimssection, ensure the presence of the exact sameClaimchild elements mentioned in step 4. - Save and close cd_ambient_conf.xml.
- 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.