[Premium]{class="badge positive" title="檢視Target Premium包含的內容。"}
建立設計
設計可定義建議出現在頁面上的方式。
您可以使用預設設計或建立自訂設計來建立Recommendations設計。 Recommendations > Designs 畫面會顯示預設設計卡片以及在您的帳戶中建立的任何設計。
使用設計時,請牢記下列資訊:
- 您可以使用預設設計來建立建議設計,也可以建立自訂設計。
- 您無法編輯或刪除預設設計。
- 您可以編輯、複製或刪除自訂設計。
- 若要根據預設設計建立設計,您必須先複製設計,然後再編輯副本。
下圖顯示預設的1 x 4設計:
下圖顯示自訂設計:
您可以在活動建立過程中從視覺化體驗撰寫器(VEC)內或在活動建立之外從設計程式庫建立設計。 以下各節假設您是從資料庫中建立設計,但步驟類似。
建立設計
您可以根據預設設計建立設計,也可以建立自訂設計。
根據預設設計建立設計
-
按一下「Recommendations > Designs」以顯示Designs資料庫。
-
將游標移至您要建立的設計的卡片上,然後按一下 Copy 圖示。
Create Design對話方塊隨即顯示。
-
在 Information 面板中,新增 Content Name 和選用的預覽影像以顯示於設計卡片。
使用預設設計時,設計名稱和「Copy」會出現在 Content Name 欄位中。 您可以編輯名稱。您也可以選取要在設計卡片上顯示的影像。
-
(視條件而定)視需要編輯設計 Code。
Recommendation設計使用開放原始碼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
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]
(可選) 如果您已在活動設定期間選取「屬性」(「企業權限」的部分),則新增。
當演算法執行之後,而且也有結果,則回應會如下所示:
{width="575px"}
其他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)
此影片包含下列資訊:
- 建立自訂設計
- 瞭解如何在設計中參考顯示變數