建議擴充資料實體
本文提供有關如何在智慧建議資料合約中設定建議擴充資料實體的指引。
資料實體檢閱
資料實體是一組有一個或多個資料文字檔的集合，每個檔案都有欄 (也稱為屬性) 和包含實際資料值之列的清單。
智慧建議定義資料實體的邏輯群組，每個群組都各有本身用途。
注意
資料實體為選擇性實體 (除非明確指出)，這表示其資料可以空白或遺失。
簡介
智慧建議支援手動擴充產生的建議，這可讓您在任何建議清單中手動新增或移除特定項目或項目變體。
支援的擴充動作為：
包含：將指定的項目和項目變體新增至指定清單的頂端。 這些手動新增的項目依據其排名屬性進行排序。
排除：從指定清單中移除指定的項目或項目變體，不論該清單中項目的排名為何。
一律都會考慮項目可用性。 任何未在呼叫建議 API 時視為可用的項目，都不會傳回做為回應的一部分。
下列資料實體是建議擴充資料實體的一部分：
特定項目的建議擴充
資料實體名稱：Reco_SeededRecommendationsEnrichment
描述：使用稱為 SeedItemId 的 ItemId，擴充特定項目的建議結果。 僅適用於特定項目所提示的清單 (例如「人們也喜歡」)。
屬性：
| 姓名 | 資料類型 | 必要 | 預設值 | 無效值行為 | 意見 |
|---|---|---|---|---|---|
| RecoListName | 字串 | .是 | 修剪值 | 移至 ListNames 資料表，取得支援的清單名稱。 | |
| AlgoType | 字串 | 無 | 修剪值 | 並非所有的清單名稱都需要設定此值。 如需了解每個清單名稱支援的演算法類型，請參閱 AlgoTypes 資料表。 | |
| SeedItemId | 字串 (16) | .是 | 置放項目 | 清單建議使用的 ItemId。 如需項目識別碼，請參閱每個建議案例所需的資料實體。 | |
| SeedItemVariantId | 字串 (16) | 無 | 置放項目 | 清單建議使用的 ItemVariantId。 如需項目變體識別碼，請參閱每個建議案例所需的資料實體。 | |
| ItemId | 字串 (16) | .是 | 置放項目 | 如需項目識別碼，請參閱每個建議案例所需的資料實體。 | |
| ItemVariantId | 字串 (16) | 無 | 置放項目 | 如需項目變體識別碼，請參閱每個建議案例所需的資料實體。 | |
| EnrichmentAction | 字串 | .是 | 置放項目 | 目前僅支援包含或排除。 | |
| 階層 | int | 無 | 置放項目 | 對於排除擴充動作，將會忽略此值。 |
指導方針：
標示為包含項目只能新增至所產生之建議清單的最上方。
從項目未出現於其中的清單排除該項目時，不會執行任何動作。
排除永遠會成功。 如果同時在同一個清單中包含和排除相同的項目，則會從最終的 API 回應中排除該項目。
排名屬性僅指定新增項目或項目變體之間的順序。 在任何情況下，都會新增至清單的頂端。 如果多個項目有重複的排名值，則依其間的某種隨機順序來新增這些項目。
系統會忽略使用不受支援 AlgoType 值的擴充。
範例資料：
標題只是為了方便起見而出現，不應成為實際資料的一部分。
| RecoListName | AlgoType | SeedItemId | SeedItemVariantId | ItemId | ItemVariantId | EnrichmentAction | 階層 |
|---|---|---|---|---|---|---|---|
| 類似 | MF | Item1 | Item2 | 包括 | 1 | ||
| 類似 | MF | Item1 | Item3 | Item3Var1 | 包括 | 2 | |
| 類似 | DAS | Item3 | Item3Var1 | Item1 | Item1Var2 | 排除 | |
| 購物車 | Item3 | Item1 | Item1Var1 | 包括 | 7 |
建議擴充
資料實體名稱：Reco_RecommendationsEnrichment
描述：建議結果的擴充
屬性：
| 名稱 | 資料類型 | 必要 | 預設值 | 無效值行為 | 意見 |
|---|---|---|---|---|---|
| RecoListName | 字串 | .是 | 修剪值 | 移至 ListNames 資料表，取得支援的清單名稱。 | |
| ItemId | 字串 (16) | .是 | 置放項目 | 如需項目識別碼，請移至每個建議案例所需的資料實體。 | |
| ItemVariantId | 字串 (16) | 無 | 置放項目 | 如需項目變體識別碼，請移至每個建議案例所需的資料實體。 | |
| EnrichmentAction | 字串 | .是 | 置放項目 | 目前僅支援包含或排除。 | |
| 階層 | int | 無 | 置放項目 | 對於排除擴充動作，將會忽略此值。 |
指導方針：
ListNames、AlgoTypes 和 Refinements
ListNames 的資料表
資料表中指定目前可用 ListNames 的清單：
| ListName | 帳單 (標準/進階) | 模型功能集 |
|---|---|---|
| BrowseLists | 標準 | 基本 |
| ExternalLists | 標準 | 基本 |
| PeopleAlso | 標準 | 基本 |
| NextBestAction (正式名稱為「購物車」) | 標準 | 基本 |
| Picks | 標準 | 標準 |
| ViewedInSession | 標準 | 標準 |
| VisualSimilarity | 進階 | 進階 |
| TextualSimilarity | 進階 | 進階 |
AlgoTypes 資料表
資料表中指定可用的 AlgoTypes 以及您可以與之搭配使用的不同 API：
| AlgoType | 描述 | 支援 API |
|---|---|---|
| RecentPurchases | 精選建議是根據使用者最近的購買項目 (或其他互動) 計算而來。 | 只能與使用者精選 API 搭配使用。 |
| RecentViews | 精選建議是根據使用者最近的檢視歷程記錄和喜好設定計算而來。 | 只能與使用者精選 API 搭配使用。 |
| FullHistory | 精選建議是根據使用者的完整購買 (或其他互動) 記錄計算而來。 | 只能與使用者精選 API 搭配使用。 |
| MF (矩陣分解) | 類似 API 的預設檢視表。 | 僅適用於類似 API |
| 視覺效果 | 項目相似性是根據目錄影像的視覺相似性計算而來。 | 僅適用於類似 API。 |
| 文字 | 專案相似性是根據目錄文字標題及描述的文字 (語言理解) 相似性來計算。 | 僅適用於類似 API。 |
| BringSimilarItems | 指定複合影像時，此 AlgoType 建議在外觀上與複合影像中所識別項目相似的項目。 | 僅適用於類似 API。 |
| CompleteSimilarStyles | 指定種子項目時，此 AlgoType 建議樣式與種子項目相似的其他複合影像。 | 僅適用於類似 API。 |
| CompleteSimilarItems | 指定種子項目時，此 AlgoType 建議其他與種子項目相似之複合影像中的項目。 | 僅適用於類似 API。 |
| DAS | 「DAS」代表直接關聯評分。 此 AlgoType 利用互動資料實體中項目的同現次數，根據相似性提供建議。 此 Algotype 是 NextBestAction API 的預設值。 | 只能與類似 API 及 NextBestAction API (正式名為「購物車」) 搭配使用。 |
Refinements 的資料表
資料表中指定可用的 Refinements 以及您可與之搭配使用的不同 API：您可以新增多個以逗號分隔的微調，只要不相互矛盾即可。
| 微調 | 定義 | 支援 API | 預設行為 |
|---|---|---|---|
| RemoveUserHistory | 移除使用者已購買的品項，以免再次向該使用者推薦這些品項。 | 所有 API | 預設僅對「取得使用者精選」API 啟用。 |
| KeepUserHistory | 保留使用者已購買品項的歷程記錄，建議服務可再次為同一個使用者考慮該品項。 | 所有 API | 預設為所有除了「取得使用者精選」以外的 API 啟用。 |
| EnableShuffling | 在不明顯影響相關性的情況下稍微變更品項的順序，避免使用者一再看到相同的建議。 | 所有 API | 預設僅對「取得使用者精選」API 啟用。 |
| DisableShuffling | 保留建議品項的順序，而不打亂結果。 | 所有 API | 預設為所有除了「取得使用者精選」以外的 API 啟用。 |
另請參閱
資料合約概觀
資料實體對應資料表
目錄資料實體
互動資料實體
Reco 設定資料實體
退出宣告使用者資料實體
外部清單資料實體
影像至項目對應資料實體
智慧建議 API
快速入門手冊：使用範例資料設定並執行智慧建議