[Premium]{class="badge positive" title="檢視Target Premium包含的內容。"}

建立設計

設計可定義建議出現在頁面上的方式。

您可以使用預設設計或建立自訂設計來建立Recommendations設計。 Recommendations > Designs ​畫面會顯示預設設計卡片以及在您的帳戶中建立的任何設計。

使用設計時,請牢記下列資訊:

  • 您可以使用預設設計來建立建議設計,也可以建立自訂設計。
  • 您無法編輯或刪除預設設計。
  • 您可以編輯、複製或刪除自訂設計。
  • 若要根據預設設計建立設計,您必須先複製設計,然後再編輯副本。

下圖顯示預設的1 x 4設計:

1 x 4預設設計

下圖顯示自訂設計:

自訂設計

您可以在活動建立過程中從視覺化體驗撰寫器(VEC)內或在活動建立之外從設計程式庫建立設計。 以下各節假設您是從資料庫中建立設計,但步驟類似。

建立設計

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

根據預設設計建立設計

  1. 按一下「Recommendations > Designs」以顯示Designs資料庫。

    設計資料庫

  2. 將游標移至您要建立的設計的卡片上,然後按一下​ Copy ​圖示。

    Card_CopyDesign圖片

    Create Design對話方塊隨即顯示。

    createDesign影像

  3. 在​ Information ​面板中,新增​ Content Name ​和選用的預覽影像以顯示於設計卡片。

    使用預設設計時,設計名稱和「Copy」會出現在​ Content Name ​欄位中。 您可以編輯名稱。您也可以選取要在設計卡片上顯示的影像。

  4. (視條件而定)視需要編輯設計​ Code

    Recommendation 設計使用開放式原始碼 Velocity 設計語言。有關Velocity的資訊,請參閱https://velocity.apache.org使用Velocity自訂設計

    設計可以是 HTML 或非 HTML。根據預設,HTML設計會以<div>標籤包住,以允許在Web環境中進行點選追蹤。 非HTML設計適用於無法進行點選追蹤的非Web環境。 滑動HTML Design切換至「關閉」位置以使用非HTML代碼。

    note note
    NOTE
    可在設計中參照(硬式編碼或透過回圈)的實體數上限為99。
  5. 按一下 Save

建立自訂設計

  1. 按一下「Recommendations > Designs」以顯示Designs資料庫。

  2. 按一下 Create Design

    如果您想要讓新的自訂設計以現有設計為基礎,請將滑鼠移至所需設計上,然後按一下Copy圖示。 然後您可以編輯復本以建立新的自訂設計。

  3. 新增​ Content Name ​和選用的預覽影像。

  4. (視條件而定)視需要編輯設計​ Code

    如需詳細資訊,請參閱上述步驟4中的資訊。

  5. 按一下 Save

編輯、複製或刪除設計

請記住,您無法編輯或複製預設設計;您只能複製預設設計。

將游標暫留在Design資料庫中所需的設計上,然後按一下適當的圖示:編輯、複製或刪除。

設計的暫留圖示

您可以複製現有設計來建立複製設計,然後可以修改設計。 這可讓您輕鬆建立類似的設計。

請注意,設計在整個帳戶中皆可使用。 刪除設計前,請務必考量這一點。 已刪除的設計無法復原。

JSON 範例 section_75BFB2537CFF4FBD9B560F59EB32C8DD

以下範例說明透過表單式編輯器設定活動時,如何傳回JSON回應。

  1. 在「設計程式庫」內或表單式工作流程內建立設計。 如果您嘗試在視覺化體驗撰寫器(VEC)工作流程內這樣做,則無法建立除了HTML設計以外的任何專案,此設計會包裝在<div>中以利點選追蹤。

  2. 確定「HTML 設計」選項已關閉:

    html_design_toggle image

  3. 下列程式碼為貼到設計中的範例:

    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"
          }
        }
    
  4. 設定使用此設計的表單式Recommendations活動。

    1. 導覽至​ Activities ​頁面。
    2. 按一下​ Create Activity > Recommendations
    3. 在​ Choose Experience Composer ​下,選取​ Form,然後按一下​ Next
    4. 在位置下,輸入文字: "Sample_Recs_Response"
    5. 在​ Default Content ​下,按一下向下箭頭,然後按一下​ Add Recommendation
    6. 選擇頁面類型。這會決定下一個畫面的起始篩選。
    7. 選取條件卡,然後按一下​ Next
    8. 選取您在上一步建立的設計,然後按一下​ Next
    9. 完成設定程序。
    10. 按一下​ Inactive ​旁的向右箭頭,然後選取​ Activate
  5. 在設定並啟動活動之後,您可以設定請求範例來取回全新的 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
    

    where

    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 Token >使用者端代碼。
    [YOUR_MBOX_NAME] 您在表單式Recommendations的「位置」區段中選取的名稱,此例子中是Sample_Recs_Response。
    [ENTITY_ID 目錄中之項目的 entity.id
    [AT_PROPERTY_TOKEN] (可選) 如果您已在活動設定期間選取「屬性」(「企業權限」的部分),則新增。

當演算法執行之後,而且也有結果,則回應會如下所示:

json_recommendation影像

其他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) Overview badge

此影片包含下列資訊:

  • 建立自訂設計
  • 瞭解如何參考設計中的顯示變數
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654