[Premium]{class="badge positive" title="查看Target Premium中包含的内容。"}
创建设计
设计可定义推荐在页面上的显示方式。
您可以使用默认设计或通过创建自定义设计来创建Recommendations设计。 Recommendations > Designs 屏幕显示默认设计卡片以及在您的帐户中创建的所有设计。
在处理设计时，请牢记以下信息：
- 您可以使用默认设计创建推荐设计，也可以创建自定义设计。
- 不能编辑或删除默认设计。
- 您可以编辑、复制或删除自定义设计。
- 要基于默认设计创建设计，必须首先复制设计，然后编辑副本。
此图显示了默认的1 x 4设计：
此图显示了一个自定义设计：
在活动创建过程中，您可以在可视化体验编辑器(VEC)中创建设计，也可以在活动创建之外从设计库创建设计。 以下部分假定您是从库中创建设计，但步骤类似。
创建设计
您可以基于默认设计创建设计，也可以创建自定义设计。
基于默认设计创建设计
-
单击 Recommendations > Designs 以显示Designs库。
-
将鼠标悬停在要创建的设计的卡片上，然后单击 Copy 图标。
此时将显示Create Design对话框。
-
在 Information 面板中，添加一个 Content Name 和一个可选的预览图像以显示在设计卡片上。
当您使用默认设计时，设计名称和“副本”将出现在 Content Name 字段中。 您可以编辑该名称。您还可以选择要在设计卡片上显示的图像。
-
（视情况而定）根据需要编辑设计 Code。
推荐设计使用开源Velocity设计语言。 有关Velocity的信息可在https://velocity.apache.org和使用 Velocity自定义设计。
设计可以是 HTML 形式，也可以是非 HTML 形式。默认情况下，HTML设计使用
<div>标记封装，以便允许在Web环境中进行点击跟踪。 非HTML设计适用于无法进行点击跟踪的非Web环境。 将HTML Design切换开关滑动到“关闭”位置以使用非HTML代码。note note NOTE 设计中可引用（无论是以硬编码方式引用还是通过循环引用）的最大实体数为99。 -
单击 Save。
创建自定义设计
-
单击 Recommendations > Designs 以显示Designs库。
-
单击 Create Design。
如果要将新的自定义设计基于现有设计，请将鼠标悬停在所需设计上，然后单击Copy图标。 然后，您可以编辑副本以创建新的自定义设计。
-
添加 Content Name 和可选的预览图像。
-
（视情况而定）根据需要编辑设计 Code。
有关更多信息，请参阅上述步骤4中的信息。
-
单击 Save。
编辑、复制或删除设计
请记住，您不能编辑或复制默认设计；您只能复制默认设计。
将鼠标悬停在Design库中的所需设计上，然后单击相应的图标：编辑、复制或删除。
您可以复制现有设计以创建复制设计，然后可对其进行修改。 此过程可让您用更少的工作量创建类似设计。
请注意，设计可在整个帐户中使用。 在删除设计之前，请考虑在其他帐户中的使用。 无法恢复已删除的设计。
JSON 示例 section_75BFB2537CFF4FBD9B560F59EB32C8DD
以下示例显示了在通过基于表单的编辑器配置活动时如何返回JSON响应。
-
从设计库或基于表单的工作流中创建设计。 如果尝试在Visual Experience Composer (VEC)工作流中创建设计，则无法创建除了HTML设计之外的任何其他设计，该设计封装在
<div>中以进行点击跟踪。 -
确保已关闭“HTML 设计”选项：
-
以下代码是您可以粘贴到设计中的内容示例：
code language-javascript #* * "Return a simple list of recommended entity ids" *# { "notes":{ "purpose": "Return a simple list of recommended entity ids", "use-case": "Use this approach if you prefer to do a real-time lookup of entity attribute details (such as inventory, price, rating) from another system (such as a CMS, PIM or ecommerce platform)", "version": "01" }, "recommendedItems": { "key": "$key.id", "slot-01": "$entity1.id", "slot-02": "$entity2.id", "slot-03": "$entity3.id", "slot-04": "$entity4.id", "slot-05": "$entity5.id", "slot-06": "$entity6.id", "slot-07": "$entity7.id", "slot-08": "$entity8.id", "slot-09": "$entity9.id", "slot-10": "$entity10.id" } } -
设置使用此设计的基于表单的Recommendations活动。
- 导航到 Activities 页面。
- 单击 Create Activity > Recommendations。
- 在 Choose Experience Composer 下，选择 Form，然后单击 Next。
- 在“位置”下方，输入文本：“Sample_Recs_Response”
- 在 Default Content 下，单击向下箭头，然后单击 Add Recommendation。
- 选择一种页面类型。这决定了对接下来要显示的屏幕的初步筛选。
- 选择标准卡片，然后单击 Next。
- 选择在上一步中创建的设计，然后单击 Next。
- 完成设置过程。
- 单击 Inactive 旁边的向右箭头，然后选择 Activate。
-
设置活动并将其激活后，您可以设置示例请求，以获取简洁的 JSON 响应。
从您保存活动开始，Target需要构建模型以支持所选标准配置。 根据多种因素，此过程可能需要一些时间。 构建模型后，便会显示结果。
例如：
code language-none https://[YOUR_CLIENT_CODE].tt.omtrdc.net/m2/YOUR_CLIENT_CODE/ubox/raw?mbox=[YOUR_MBOX_NAME]&mboxContentType=text/html&mboxXDomain=disabled&entity.id=[ENTITY_ID]&mboxHost=rawbox_sample&at_property=[AT_PROPERTY_TOKEN]&mboxNoRedirect=true&mboxPC=1234-4321&mboxSession=9876-7000其中
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 参数 值 [YOUR_CLIENT_CODE]Target客户端代码(位于/help/target/products.html#recsSettings > Recommendations API令牌>客户端代码)。 [YOUR_MBOX_NAME]您在基于表单的Recommendations的“位置”部分中选择的名称，在本例中为Sample_Recs_Response。 [ENTITY_ID您目录中的项目的 entity.id。[AT_PROPERTY_TOKEN]（可选）如果您在活动设置过程中选择了某个属性（“企业权限”的一部分），则需添加此参数。
在运行算法并获取结果后，您的响应应当类似于以下示例：
其他JSON对象提示和技巧 section_C305673C68944749969DB239E3221DC2
您还可以使用以下语法设置设计，以便仅发送回以逗号分隔的项目简单列表：
entity1.id, $entity2.id, $entity3.id, $entity4.id, $entity5.id,
或者，您也可以在响应中发送更多信息。下面是一个更为复杂的代码文件示例，此代码不仅仅返回了实体 ID 及其关联的版块（顺序），还返回了更多其他内容。此设计示例还返回了活动详细信息、Target配置文件详细信息（如适用），以及与返回的项目关联的其他entity.attributes。
{
"adobeRecommendations": {
"notes": {
"purpose": "Return a list of entity ids with their associated entity.attributes",
"use-case": "Use this approach to avoid looking up attribute details after receiving a response from Target",
"version": "01"
},
"recommendedItems": {
"slot-01": "$entity1.id",
"slot-02": "$entity2.id",
"slot-03": "$entity3.id",
"slot-04": "$entity4.id",
"slot-05": "$entity5.id",
"slot-06": "$entity6.id",
"slot-07": "$entity7.id",
"slot-08": "$entity8.id",
"slot-09": "$entity9.id",
"slot-10": "$entity10.id"
},
"activityDetails": {
"mbox.name": "email-mbox",
"campaign.name": "\${campaign.name}",
"campaign.id": "\${campaign.id}",
"campaign.recipe.name": "\${campaign.recipe.name}",
"campaign.recipe.id": "\${campaign.recipe.id}",
"offer.name": "\${offer.name}",
"offer.id": "\${offer.id}",
"criteria.title": "$criteria.title",
"algorithm.name": "$algorithm.name",
"algorithm.dayCount": "$algorithm.dayCount"
},
"visitorProfile": {
"profile.favorite-category": "\${profile.favorite-category}",
"profile.test": "\${profile.test}",
"user.endpoint.lastPurchasedEntity": "\${user.endpoint.lastPurchasedEntity}",
"user.endpoint.lastViewedEntity": "\${user.endpoint.lastViewedEntity}",
"user.endpoint.mostViewedEntity": "\${user.endpoint.mostViewedEntity}",
"user.endpoint.categoryAffinity": "\${user.endpoint.categoryAffinity}",
"profile.geolocation.city": "\${profile.geolocation.city}",
"profile.geolocation.dma": "\${profile.geolocation.dma}",
"profile.geolocation.state": "\${profile.geolocation.state}",
"profile.geolocation.country": "\${profile.geolocation.country}",
"profile.sessionCount": "\${profile.sessionCount}",
"profile.averageDaysBetweenVisits": "\${profile.averageDaysBetweenVisits}",
"profile.browserTime": "\${profile.browserTime}",
"user.activeActivities": "\${user.activeActivities}",
"user.pcId": "\${user.pcId}",
"user.isFirstSession": "\${user.isFirstSession}",
"user.isNewSession": "\${user.isNewSession}",
"user.header": "\${user.header}",
"user.parameter": "\${user.parameter}"
},
"recKey": {
"recKeyDetails": {
"id": "$key.id",
"name": "$key.name",
"category": "$key.category",
"pageUrl": "$key.pageUrl",
"thumbnailUrl": "$key.thumbnailUrl"
}
},
"recDetailedResults": {
"recEntity1Details": {
"id": "$entity1.id",
"name": "$entity1.name",
"category": "$entity1.category",
"pageUrl": "$entity1.pageUrl",
"thumbnailUrl": "$entity1.thumbnailUrl"
},
"recEntity2Details": {
"id": "$entity2.id",
"name": "$entity2.name",
"category": "$entity2.category",
"pageUrl": "$entity2.pageUrl",
"thumbnailUrl": "$entity2.thumbnailUrl"
},
"recEntity3Details": {
"id": "$entity3.id",
"name": "$entity3.name",
"category": "$entity3.category",
"pageUrl": "$entity3.pageUrl",
"thumbnailUrl": "$entity3.thumbnailUrl"
},
"recEntity4Details": {
"id": "$entity4.id",
"name": "$entity4.name",
"category": "$entity4.category",
"pageUrl": "$entity4.pageUrl",
"thumbnailUrl": "$entity4.thumbnailUrl"
},
"recEntity5Details": {
"id": "$entity5.id",
"name": "$entity5.name",
"category": "$entity5.category",
"pageUrl": "$entity5.pageUrl",
"thumbnailUrl": "$entity5.thumbnailUrl"
},
"recEntity6Details": {
"id": "$entity6.id",
"name": "$entity6.name",
"category": "$entity6.category",
"pageUrl": "$entity6.pageUrl",
"thumbnailUrl": "$entity6.thumbnailUrl"
},
"recEntity7Details": {
"id": "$entity7.id",
"name": "$entity7.name",
"category": "$entity7.category",
"pageUrl": "$entity7.pageUrl",
"thumbnailUrl": "$entity7.thumbnailUrl"
},
"recEntity8Details": {
"id": "$entity8.id",
"name": "$entity8.name",
"category": "$entity8.category",
"pageUrl": "$entity8.pageUrl",
"thumbnailUrl": "$entity8.thumbnailUrl"
},
"recEntity9Details": {
"id": "$entity9.id",
"name": "$entity9.name",
"category": "$entity9.category",
"pageUrl": "$entity9.pageUrl",
"thumbnailUrl": "$entity9.thumbnailUrl"
},
"recEntity10Details": {
"id": "$entity10.id",
"name": "$entity10.name",
"category": "$entity10.category",
"pageUrl": "$entity10.pageUrl",
"thumbnailUrl": "$entity10.thumbnailUrl"
}
}
}
}
培训视频：在Recommendations中创建自定义设计(3:20)
本视频包含以下信息：
- 创建自定义设计
- 了解如何在设计中引用显示变量