Home >	Contents >	Index >
Template Tag TOC  |   Alpha TOC  |   Tag Family TOC  |   Purpose TOC  |   Annotated TOC  |   Index

COMMERCECONTEXT.GETSINGLERECOMMENDATION

Returns one recommended asset based on the recommendation criteria passed to the tag.

Syntax

<COMMERCECONTEXT.GETSINGLERECOMMENDATION
      COLLECTION="recommendationname" 
      [LIST="inputlist"]
      [VALUE="rating"]
      VARNAME="assetid"
      TYPEVARNAME="assettype"
      [FILTER="true|false"]/> 

Parameters

COLLECTION (required)

Input parameter. Name of the recommendation. The sort and selection criteria defined in the recommendation are used to determine which asset to return. If there are any promotions in place that override this recommendation, it substitutes the name of the promotion, instead.

LIST (optional)

Input parameter. Name of the list of assets you want to be used as input for the calculation. This argument is only applicable if the recommendation named by COLLECTION is an context-based recommendation. Columns are assettype and assetid.

VALUE (optional)

Input parameter. Default rating for assets that do not have one. If you do not declare a value, unrated assets are assigned a default rating of 50 on a scale of 1-100.

VARNAME (required)

Input and output parameter. Name you want to assign to the variable that holds the ID of the asset that is returned on output.

TYPEVARNAME (required)

Input and output parameter. Name you want to assign to the variable that holds the type of asset that is returned on output.

FILTER (optional)

Input parameter. A boolean value: true specifies that no assets in the input list can be returned as output; false (default) allows input assets to be returned as output.

Description

This tag is a convenience version of the COMMERCECONTEXT.GETRECOMMENDATIONS tag. It returns zero or one recommended asset. The actual recommendation is based on the details of the referenced recommendation asset. This tag automatically calculates segment affinity and promotion affinity for the current visitor, if they have not yet been calculated. For information about creating recommendations, including context-based recommendations, see the CS Developer's Guide.

NOTE: This tag also causes compositional dependencies to be recorded for all assets that contribute to the returned lists, and may, under the right conditions, have the same effect as a RENDER.UNKNOWNDEPS tag.

		Home >	Contents >	Index >
	FatWire XML Tag Reference Copyright 2005 by FatWire Software All rights reserved.