Show Menu
主題×

建立設計

設計可定義建議出現在頁面上的方式。
您可以使用預設的設計來建立 Recommendations 設計,或建立自訂的設計。「建 議>設計 」畫面會顯示預設設計卡片和您帳戶中建立的任何設計。
當您處理設計時,請記住下列資訊:
  • 您可以使用預設設計來建立建議設計,或建立自訂設計。
  • 不能編輯或刪除預設設計。
  • 您可以編輯、複製或刪除自訂設計。
  • 要根據預設設計建立設計,必須先複製設計,然後編輯該副本。
此圖顯示預設的1 x 4設計:
下圖顯示自訂設計:
您可以在活動建立程式期間,從Visual Experience Composer(VEC)或設計程式庫建立活動建立以外的設計。 以下章節假設您是從程式庫建立設計,但步驟類似。

建立設計

您可以根據預設設計建立設計,或建立自訂設計。

根據預設設計建立設計

  1. 按一 下「建議 >設 」以顯示 「設計 」庫。
  2. 將滑鼠指標暫留在卡片上,以便建立設計,然後按一下「復 」圖示。
    將顯 示「建立設計 」(Create Design)對話框。
  3. 在「資 」面板中,新增「內 容名稱 」和可選的預覽影像,以顯示在設計卡片上。
    When you use a default design, the design name and "Copy" appears in the Content Name field. 您可以編輯名稱。您也可以選取要在設計卡上顯示的影像。
  4. (條件性)視需要編 輯設 ​計程式碼。
    Recommendation 設計使用開放式原始碼 Velocity 設計語言。有關Velocity的資訊,請造訪 https://velocity.apache.org ,以及使 用Velocity自訂設計
    設計可以是 HTML 或非 HTML。根據預設,HTML 設計會以 <div> 標籤包住,以允許在 Web 環境中進行點擊追蹤。非 HTML 設計用於非 Web 環境,在其中無法進行點擊追蹤。投影片 HTML Design (HTML設計)切換至「關閉」位置,以使用非HTML程式碼。
    在設計中可參考的實體(硬式編碼或透過循環)數目上限為99。
  5. 按一下​ 「儲存」

建立自訂設計

  1. 按一 下「建議 >設 」以顯示 「設計 」庫。
  2. 按一 下「建立設計 」。
    如果您想要在現有設計的基礎上建立新的自訂設計,請將滑鼠移至所要的設計上,然後按一下「復 制 」圖示。 然後,您可以編輯復本以建立新的自訂設計。
  3. 新增內容 名稱 ,以及選用的預覽影像。
  4. (條件性)視需要編 輯設 ​計程式碼。
    如需詳細資訊,請參閱上述步驟4中的資訊。
  5. 按一下​ 「儲存」

編輯、複製或刪除設計

請記住,您無法編輯或複製預設設計;您只能複製預設設計。
將滑鼠指標暫留在 Design程式庫中 ,然後按一下適當的圖示:編輯、複製或刪除。
您可以複製現有設計以建立複製設計,然後再加以修改。 這可讓您輕鬆建立類似的設計。
請注意,整個帳戶都提供設計。 在刪除設計之前,請務必考慮這一點。 無法刪除的設計。

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. 按一下​ 「建立活動」 > 「Recommendations」
    3. 在「選 擇Experience Composer 」下,選 擇「表單 」,然後按「 下一步 」。
    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
    
    
    where
    參數
    [YOUR_CLIENT_CODE]
    Target 用戶端代碼 (位於 ../target/products.html#recsSettings > Recommendations API Token > 用戶端代碼。
    [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)

此影片包含下列資訊:
  • 建立自訂設計
  • 瞭解如何參考設計中的顯示變數