Installing the Audience Manager Cartridge

The Audience Manager Cartridge puts Segments, Contact details and Contact extended details into the Claim Store as Claims. You need to install and configure the Audience Manager Cartridge in the Content Service, or, if you have it installed, in the Session-enabled Content Service.

Procedure

  1. In the services\ folder of your Content Service or Session-enabled Content Service, create a new folder called, for example, AM.
  2. Access the SDL Web installation media.
  3. Navigate to the folder Audience Manager\roles\api\in-process\java\subscription\ and copy the following files into the folder you just created:
    • oe_profile.jar
    • oe_utils.jar
    • commons-lang3.jar
  4. Navigate to the folder Audience Manager\roles\audience manager\ambient\ and copy the file called audiencemanager_cartridge.jar into the folder you just created.
  5. Navigate to the config\ folder of your Content Service or Session-enabled Content Service, and open the Ambient Data Framework configuration file cd_ambient_conf.xml for editing.
  6. Configure the file to include the Audience Manager cartridge:
    <Cartridges>
    	<Cartridge File="/audiencemanager_cartridge_conf.xml"/>
    </Cartridges>
  7. Save and close cd_ambient_conf.xml.
  8. In the same folder, add the Audience Manager configuration file cd_audience_manager_conf.xml. Copy the configuration file from the Audience Manager\roles\api\in-process\java\config\ folder.
  9. In the config\ directory of the Content Service or Session-enabled Content Service, open the Content Delivery Storage configuration file cd_storage_conf.xml in a text editor. Ensure the following has been configured:
    • In the<Storages> element:
      <StorageBindings>
      	<Bundle src="AudienceManagerDAOBundle.xml"/>
      </StorageBindings>
    • In the <Storage> element, configure the connections to your Subscription and Tracking databases. For full details see Configuring the Tracking and Subscription databases.

    • In the <ItemTypes> element:
      <Item typeMapping="AudienceManagerProfile" storageId="profiledb"/>
      <Item typeMapping="AudienceManagerTracking" storageId="trackingdb"/>
  10. Save and close cd_storage_conf.xml.