Show Menu
主题×

创建设计

设计可定义推荐在页面上的显示方式。
您可以使用默认设计或通过创建自定义设计来创建推荐设计。“ Recommendations” >“设计”屏幕显示默认设计卡和在您的帐户中创建的任何设计。
处理设计时,请牢记以下信息:
  • 您可以使用默认设计创建推荐设计,也可以创建自定义设计。
  • 不能编辑或删除默认设计。
  • 您可以编辑、复制或删除自定义设计。
  • 要创建基于默认设计的设计,必须先复制设计,然后编辑副本。
此插图显示默认的1 x 4设计:
此插图显示自定义设计:
在活动创建过程中,您可以从Visual Experience Composer(VEC)或在活动创建之外的设计库中创建设计。 以下部分假定您是从库创建设计,但步骤相似。

创建设计

您可以基于默认设计创建设计,也可以创建自定义设计。

根据默认设计创建设计

  1. 单击 Recommendations > 设计 ,以显示 设计 库。
  2. 将鼠标悬停在要创建的设计的卡上,然后单击“复 ”图标。
    此时 将显示 “创建设计”对话框。
  3. 在“信 ”面板中,添加要 在设计卡上显示 的“内容名称”和可选的预览图像。
    When you use a default design, the design name and "Copy" appears in the Content Name field. 您可以编辑该名称。您还可以选择要在设计卡上显示的图像。
  4. (视情况而定)根据需 要编 ​辑设计代码。
    推荐设计使用的是开源 Velocity 设计语言。有关Velocity的信息,请访 问https://velocity.apache.org ,并 参阅使用Velocity自定义设计
    设计可以是 HTML 形式,也可以是非 HTML 形式。默认情况下,HTML 设计将使用
    标记封装,以便允许在 Web 环境中进行点击跟踪。非 HTML 设计适用于无法进行点击跟踪的非 Web 环境。将HTML 设计切 换到“关闭”位置,以使用非HTML代码。
    设计中可引用的最大图元数(硬编码或通过循环)为99。
  5. 单击​ 保存

创建自定义设计

  1. 单击 Recommendations > 设计 ,以显示 设计 库。
  2. 单击“ 创建设计 ”。
    如果要将新的自定义设计基于现有设计,请将鼠标悬停在所需设计上,然后单击“复 制 ”图标。 然后,您可以编辑副本以创建新的自定义设计。
  3. 添加内容 名称 和可选预览图像。
  4. (视情况而定)根据需 要编 ​辑设计代码。
    有关详细信息,请参阅上面步骤4中的信息。
  5. 单击​ 保存

编辑、复制或删除设计

请记住,您无法编辑或复制默认设计;您只能复制默认设计。
将鼠标悬停在设计库中 的所 需设计上,然后单击相应的图标:编辑、复制或删除。
您可以复制现有设计以创建随后可以修改的重复设计。 这样,您可以更轻松地创建类似的设计。
请注意,整个客户都有设计可用。 在删除设计之前,请确保考虑这一点。 无法恢复已删除的设计。

JSON 示例

以下示例显示如何通过基于表单的编辑器配置活动时返回JSON响应。
  1. 从设计库或基于表单的工作流程中创建设计。 If you attempt to do this inside the Visual Experience Composer (VEC) workflow you cannot create anything other than an HTML design, which is wrapped in a <div> for click tracking purposes.
  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. Set up a form-based Recommendations activity that uses this design.
    1. Navigate to the Activities page.
    2. 单击​ 创建活动 > 推荐
    3. 在“选 择体验书写器 ”下,选 择表单 ,然后单 击下一步
    4. 在“位置”下方,输入文本:“Sample_Recs_Response”
    5. 在​ 默认内容 ​下方,单击向下箭头,然后单击​ 添加推荐
    6. 选择一种页面类型。这决定了对接下来要显示的屏幕的初步筛选。
    7. 选择一个标准卡片,然后单击​ 下一步
    8. Select the design you created in the previous step, then click Next .
    9. 完成设置过程。
    10. 单击​ 不活跃 ​旁边的向右箭头,然后选择​ 激活
  5. 设置活动并将其激活后,您可以设置示例请求,以获取简洁的 JSON 响应。
    From the time that you save your activity, Target will need to build a model to support the selected criteria configuration. 此过程可能会花费一些时间,具体时间取决于众多因素。构建模型后,便会显示结果。
    例如:
    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]
    (可选)如果您在活动设置过程中选择了某个属性(“企业权限”的一部分),则需添加此参数。
在运行算法并获取结果后,您的响应应当类似于以下示例:

Additional JSON object tips and tricks

您还可以使用以下语法设置设计,以便仅发送回以逗号分隔的项目简单列表:
entity1.id, $entity2.id, $entity3.id, $entity4.id, $entity5.id, 

或者,您也可以在响应中发送更多信息。下面是一个更为复杂的代码文件示例,此代码不仅仅返回了实体 ID 及其关联的版块(顺序),还返回了更多其他内容。This design example also returns activity details, Target Profile details (as applicable), and other entity.attributes associated with the items returned.
    {   
     "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)

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