Experience Optimization TCDL Tag Reference

This topic provides a list of the TCDL tags available for Experience Optimization.

Syntax

The following example provides an overview of the Experience Optimization tags you can use:

<tcdl:region>
  <tcdl:query>
   <tcdl:facet />
   <tcdl:item />	
   <tcdl:search />
   <tcdl:attribute />
   <tcdl:promotions />
   <tcdl:navigation />
  <tcdl:items />								
 </tcdl:query>
</tcdl:region>

Experience Optimization tags

Experience Optimization provides the following TCDL tags:

<tcdl:region>
The <tcdl:region> tag is the root node which encapsulates a Page Region in which Promotions returned by Fredhopper are displayed.
<tcdl:query>
The <tcdl:query> defines a query for retrieving content that is displayed in a Page Region.
Use the following tags to influence what kind of query is sent to Fredhopper:
  • <tcdl:facet>
  • <tcdl:item>
  • <tcdl:search>
  • <tcdl:attribute>
Use the following tags to determine what to do with the results (the facet map, list of items and list of Promotions) that are returned by the query:
  • <tcdl:promotions>
  • <tcdl:navigation>
  • <tcdl:items>
<tcdl:facet>
Defines a facet Promotion that displays content items depending on the location of the end-user in the Web site. The <tcdl:facet> tag specifies a branch in the Folder, Structure Group, or Categories & Keywords (taxonomy) hierarchy.
<tcdl:item>
Defines an item Promotion that displays content items depending on a single other item (Component Presentation) displayed on the Page.
<tcdl:search>
Defines a search Promotion that displays content items depending on search terms entered by the user.
<tcdl:attribute>
Defines a name and value pair that is added to the Fredhopper query to allow you to filter Promotions, items returned by a Promotion, or items returned by a query on attributes.
<tcdl:attribute> has the following child element:
  • <tcdl:value> defines the value on which to filter Promotion.
<tcdl:items>
Handles content items returned by a query.
<tcdl:items> has the following child elements:
  • <tcdl:itemsHeader> defines a header section for content items returned by a query.

    <tcdl:itemTemplate> handles each content item returned by a query.

<tcdl:promotions>
Identifies a region for displaying Promotion items returned by a Fredhopper query.
<tcdl:promotions> has the following child elements:
  • <tcdl:promotionalItems> displays the content that is returned from Experience Optimization when the query is executed. (see also <tcdl:itemTemplate>)
  • <tcdl:fallbackcontent> displays alternative content if Experience Optimization times out or no content is returned.
<tcdl:navigation>
Displays navigation links to related items. <tcdl:navigation> has the following child elements:
  • <tcdl:navigationSection> defines a section in your Web page in which navigation links are displayed (see also <tcdl:itemTemplate>):
    • <tcdl:navigationSectionHeader> defines a header section.
    • <tcdl:navigationSectionFooter> defines a footer section.
    • <tcdl:navigationLink> displays the navigation links (see also <tcdl:itemTemplate>)
<tcdl:itemTemplate>
Handles a list of items:
  • In the <tcdl:navigation> tag, use <tcdl:itemTemplate> to handles one item in a list containing navigation sections.
  • In the <tcdl:navigationSection> tag, use <tcdl:itemTemplate> to handles one item in a list of navigation links.
  • In the <tcdl:promotionalItems> tag, use <tcdl:itemTemplate> to handles one item in a list of content items.
  • In the <tcdl:items> tag, use <tcdl:itemTemplate> to handles one item in a list of items returned by a search query.