[Premium]{class="badge positive" title="查看Target Premium中包含的内容。"}
使用Velocity自定义设计
使用开源Velocity设计语言自定义Adobe Target Recommendations中的推荐设计。
Velocity概述 section_C431ACA940BC4210954C7AEFF6D03EA5
有关Velocity的信息可在https://velocity.apache.org中找到。
所有Velocity逻辑、语法等均可用于推荐设计。 这意味着您可以使用Velocity而不是JavaScript创建 for 循环、if 语句和其他代码。
发送到productPage mbox中的Recommendations或CSV上传的实体属性可以在设计中显示，但“多值”属性除外。 可以发送任何类型的属性；但是，Target不会将“多值”类型的属性作为模板可对其进行迭代的数组传递（例如entityN.categoriesList）。
这些值引用了下列语法：
$entityN.variable
实体属性名称必须跟在Velocity速记符号之后，速记符号由前导 $ 字符组成，后跟Velocity模板语言(VTL)标识符。 VTL 标识符必须以字母字符（a-z 或 A-Z）开头。
Velocity实体属性名称仅限于以下字符类型：
- 字母（a-z、A-Z）
- 数字 (0-9)
- 连字符 ( - )
- 下划线 ( _ )
以下属性可用作Velocity数组。 因此，可通过索引对这些变量进行迭代或引用。
entitiesentityN.categoriesList
例如：
#foreach ($category in $entity1.categoriesList)
<br/>$category
#end
或
#if ($entities[0].categoriesList.size() >= 3 )
$entities[0].categoriesList[2]
#end
有关Velocity变量（属性）的详细信息，请参阅https://velocity.apache.org/engine/releases/velocity-1.7/user-guide.html#variables。
如果您在设计中使用配置文件脚本，脚本名称前面的$必须用\（反斜杠）进行转义。 例如：
\${user.script_name}
例如，如果您想要在设计中显示类似于下面的内容：
您可使用以下代码：
<table style="border:1px solid #CCCCCC;">
<tr>
<td colspan="3" style="font-size: 130%; border-bottom:1px solid
#CCCCCC;"> You May Also Like... </td>
</tr>
<tr>
<td style="border-right:1px solid #CCCCCC;">
<div class="search_content_inner" style="border-bottom:0px;">
<div class="search_title"><a href="$entity1.pageUrl"
style="color: rgb(112, 161, 0); font-weight: bold;">
$entity1.id</a></div>
By $entity1.message <a href="?x14=brand;q14=$entity1.message">
(More)</a><br/>
sku: $entity1.prodId<br/> Price: $$entity1.value
<br/><br/>
</div>
</td>
<td style="border-right:1px solid #CCCCCC; padding-left:10px;">
<div class="search_content_inner" style="border-bottom:0px;">
<div class="search_title"><a href="$entity2.pageUrl"
style="color: rgb(112, 161, 0); font-weight: bold;">
$entity2.id</a></div>
By $entity2.message <a href="?x14=brand;q14=$entity2.message">
(More)</a><br/>
sku: $entity2.prodId<br/>
Price: $$entity2.value
<br/><br/>
</div>
</td>
<td style="padding-left:10px;">
<div class="search_content_inner" style="border-bottom:0px;">
<div class="search_title"><a href="$entity3.pageUrl"
style="color: rgb(112, 161, 0); font-weight: bold;">
$entity3.id</a></div>
By $entity3.message <a href="?x14=brand;q14=$entity3.message">
(More)</a><br/>
sku: $entity3.prodId<br/> Price: $$entity3.value
<br/><br/>
</div>
</td>
</tr>
</table>
${entity1.thumbnailUrl}.gif。您还可以在设计中将algorithm.name和algorithm.dayCount用作实体属性，以便使用一个设计来测试多个标准，并在该设计中动态显示标准名称。 这样可指示访客查看了“最畅销商品”或属于“查看了这个项目，但购买了那个项目的人”。您甚至还可以使用这些属性来显示dayCount（标准中使用的数据所对应的天数，例如“过去2天的最畅销商品”，等等）。
处理Velocity模板中的数字
默认情况下，Velocity模板将所有实体属性视为字符串值。 您可能希望将实体属性视为数字值，以便执行数学操作或将其与另一个数值进行比较。 要将实体属性视为数字值，请执行以下步骤：
- 声明一个虚拟变量并将其初始化为一个任意整数或双精度值。
- 确保要使用的实体属性不为空（Target Recommendations模板解析器验证并保存模板所必需的）。
- 将实体属性传递到您在步骤1中创建的虚拟变量上的
parseInt或parseDouble方法中，以将字符串转换为整数或双精度值。 - 对新数值执行数学运算或比较。
示例：计算折扣价
假设您要将项目的显示价格降低0.99美元以应用折扣。 可以使用以下方法获得此结果：
#set( $double = 0.1 )
#if( $entity1.get('priceBeforeDiscount') != '' )
#set( $discountedPrice = $double.parseDouble($entity1.get('priceBeforeDiscount')) - 0.99 )
Item price: $$discountedPrice
#else
Item price unavailable
#end
示例：根据项目的评级选择要显示的星级数
假设您要根据项目的数字平均客户评级显示适当的星级数。 可以使用以下方法获得此结果：
#set( $double = 0.1 )
#if( $entity1.get('rating') != '' )
#set( $rating = $double.parseDouble($entity1.get('rating')) )
#if( $rating >= 4.5 )
<img src="5_stars.jpg">
#elseif( $rating >= 3.5 )
<img src="4_stars.jpg">
#elseif( $rating >= 2.5 )
<img src="3_stars.jpg">
#elseif( $rating >= 1.5 )
<img src="2_stars.jpg">
#else
<img src="1_star.jpg">
#end
#else
<img src="no_rating_default.jpg">
#end
示例：根据项目的长度（分钟）以小时和分钟计算时间
假设您以分钟为单位存储影片长度，但希望以小时和分钟为单位显示影片长度。 可以使用以下方法获得此结果：
#if( $entity1.get('length_minutes') )
#set( $Integer = 1 )
#set( $nbr = $Integer.parseInt($entity1.get('length_minutes')) )
#set( $hrs = $nbr / 60)
#set( $mins = $nbr % 60)
#end
显示带有推荐产品的关键项目 section_7F8D8C0CCCB0403FB9904B32D9E5EDDE
您可以对设计进行修改，以便同时显示关键项目和其他推荐产品。例如，您可能想要在推荐产品旁边显示当前项目，以供访客参考。
要实现这一点，需在设计中创建一个列，并使该列使用您的推荐所基于的 $key 属性，而不是 $entity 属性。例如，您的关键项目列的代码可能与以下内容类似：
<div class="at-table-column">
<a href="$key.pageURL">
<img src=$key.thumbnailUrl" class="at-thumbnail"/>
<br/><h3>$key.name</h3>
<br/><p class="at-light">$key.message</p>
<br/><p class="at-light">$key.value</p>
</a>
</div>
最终生成的设计如下所示，其中有一列显示了关键项目。
创建Recommendations活动时，如果关键项目是从访客的配置文件中获取的（例如“上次购买的项目”），则Target会在Visual Experience Composer (VEC)中显示一个随机产品。 这是因为在您设计活动时配置文件不可用。访客查看页面时，他们将看到预期的关键项目。
在字符串值中执行替换 section_01F8C993C79F42978ED00E39956FA8CA
您可以修改设计以替换字符串中的值。 例如，将美国使用的小数点分隔符替换为欧洲和其他国家/地区使用的逗号分隔符。
以下代码显示了条件销售定价示例中的一行内容：
<span class="price">$entity1.value.replace(".", ",") €</span><br>
以下代码显示了完整的条件销售价格示例：
<div class="price">
#if($entity1.hasSalesprice==true)
<span class="old">Statt <s>$entity1.salesprice.replace(".", ",") €</s></span><br>
<span style="font-size: 10px; float: left;">jetzt nur</span> $entity1.value.replace(".", ",") €<br> #else
<span class="price">$entity1.value.replace(".", ",") €</span><br> #end
<span style="font-weight:normal; font-size:10px;">
$entity1.vatclassDisplay
<br/>
$entity1.delivery
<br>
</span>
自定义模板大小并检查空白值 default
使用Velocity脚本控制实体显示的动态大小，以下模板可容纳一对多结果，以避免在从Recommendations返回的匹配实体不足时创建空的HTML元素。 此脚本最适合备份推荐没有意义且已启用Partial Template Rendering的情况。
以下 HTML 代码段将替换 4x2 默认设计中的现有 HTML 部分（为简便起见，此处不包括 CSS）：
- 如果存在第五个实体，脚本将插入一个闭合 div，并使用
<div class="at-table-row">另起一个新行。 - 在 4x2 设计中，显示的结果最多为 8 个，但可以通过修改
$count <=8对该值进行自定义，以适应较小或较大的列表。 - 请注意，该逻辑无法将实体均衡地分布在多个行上。例如，如果有五个或六个实体要显示，则不会动态地变为顶行显示三个，底行显示两个（或顶行显示三个，底行显示三个）。顶行将显示四个项目后，才会另起一行。
<div class="at-table">
<div class="at-table-row">
#set($count=1)
#foreach($e in $entities)
#if($e.id != "" && $count < $entities.size() && $count <=8)
#if($count==5)
</div>
<div class="at-table-row">
#end
<div class="at-table-column">
<a href="$e.pageUrl"><img src="$e.thumbnailUrl" class="at-thumbnail" />
<br/>
<h3>$e.name</h3>
<br/>
<p class="at-light">$e.message</p>
<br/>
<p class="at-light">$$e.value</p>
</a>
</div>
#set($count = $count + 1)
#end
#end
</div>
</div>