Show Menu
主题×

创建设计

设计可定义推荐在页面上的显示方式。
您可以使用默认设计或通过创建自定义设计来创建推荐设计。​ 推荐 > 设计 ​屏幕显示了默认设计卡片以及您创建的所有设计。默认设计无法编辑或删除。
  1. 在​ 推荐 > 设计 ​屏幕上,将鼠标悬停在要创建的设计的卡片上。
  2. 要复制或编辑现有设计,请单击​ 复制 ​图标。
    要创建自定义设计,请在​ 推荐 > 设计 ​屏幕上单击​ 创建设计。
  3. 添加​ 内容名称 ​。
    如果使用默认设计,则​ 内容名称 ​字段中会显示该设计的名称和“副本”字样。您可以编辑该名称。1. (可选)单击以选择要在设计卡片上显示的图像。
  4. 编辑设计​ 代码 ​。
    推荐设计使用的是开源 Velocity 设计语言。有关 Velocity 的信息可在 velocity.apache.orghttps://velocity.apache.org 中找到。
    设计可以是 HTML 形式,也可以是非 HTML 形式。默认情况下,HTML 设计将使用
    标记封装,以便允许在 Web 环境中进行点击跟踪。非 HTML 设计适用于无法进行点击跟踪的非 Web 环境。
    设计中可引用(无论是以硬编码方式引用还是通过循环引用)的最大实体数为 99。
  5. 单击​ 保存 ​。

JSON 示例

以下示例显示了通过基于表单的编辑器配置活动时可以如何返回 JSON 响应。
  1. 在设计库中或基于表单的工作流中创建一个设计。如果您尝试在可视化体验编辑器 (VEC) 工作流中创建设计,则只能创建 HTML 设计,此类设计封装在 <div> 中,用于执行点击跟踪。
  2. 确保已关闭“HTML 设计”选项:
  3. 下面是一个示例代码,您可以将此代码粘贴到自己的设计中:
        #* 
        * "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"   
          }   
        }  
    
    
  4. 设置一个基于表单的“推荐”活动,使其使用此设计。
    1. 导航到“活动”页面。
    2. 单击​ 创建活动 ​。
    3. 选择​ 推荐 ​。
    4. 在​ 选择体验编辑器 ​下方,选择​ 表单 ​。
    5. 在“位置”下方,输入文本:“Sample_Recs_Response”
    6. 在​ 默认内容 ​下方,单击向下箭头,然后单击​ 添加推荐 ​。
    7. 选择一种页面类型。这决定了对接下来要显示的屏幕的初步筛选。
    8. 选择一个标准卡片,然后单击​ 下一步 ​。
    9. 选择在上一步中创建的设计,然后单击​ 保存 ​。
    10. 完成设置过程。
    11. 单击​ 不活跃 ​旁边的向右箭头,然后选择​ 激活 ​。
  5. 设置活动并将其激活后,您可以设置示例请求,以获取简洁的 JSON 响应。
    从保存活动时起,Target 将需要构建一个模型来支持选定的标准配置。此过程可能会花费一些时间,具体时间取决于众多因素。构建模型后,便会显示结果。
    例如:
    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
    
    
    其中
参数
[YOUR_CLIENT_CODE]
Target 客户端代码(位于 ../target/products.html#recsSettings >“推荐 API 令牌”>“客户端代码”)。
[YOUR_MBOX_NAME]
您在基于表单的Recommendations的“位置”部分中选择的名称,在此示例中为Sample_Recs_Response。
[ENTITY_ID ]
您目录中的项目的 entity.id
[AT_PROPERTY_TOKEN]
(可选)如果您在活动设置过程中选择了某个属性(“企业权限”的一部分),则需添加此参数。
在运行算法并获取结果后,您的响应应当类似于以下示例:

其他 JSON 对象提示和技巧

您还可以使用以下语法设置设计,以便仅发送回以逗号分隔的项目简单列表:
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"   
       }   
      }   
     }   
    }  

Training video: Create custom designs in Recommendations (3:20)

本视频包含以下信息:
  • 创建自定义设计
  • 了解如何在设计中引用显示变量