外部清單資料實體

智慧建議可讓您彙整手動製作的項目清單。此清單非常有用，例如，在冷啟動案例中，您沒有足夠的使用者互動資料來產生有意義的建議。另一種案例是建立促銷名單，例如「返校」或「編輯推薦」。

在任何情況下，一律都會考慮項目可用性。任何沒有在呼叫建議 API 時視為可用的項目都不會傳回做為回覆的一部分。

下列資料實體是外部清單資料實體的一部分：

外部建議清單

資料實體名稱：Reco_ExternalRecommendationsLists

描述：外部建議清單

屬性：

姓名	資料類型	必要	預設值	無效值行為	意見
ListName	字串 (64)	.是		修剪值	唯一清單識別碼，也會在查詢清單時使用。長度限制為 64 個字元。
名稱	字串 (256)	.是		修剪值	長度限制為 256 個字元。
ListAvailabilityStartDate	日期時間	無	0001-01-01T00:00:00.000Z	置放項目	如需日期時間值，請參閱每個建議案例所需的資料實體。
ListAvailabilityEndDate	日期時間	無	9999-12-31T23:59:59.999Z	置放項目	如需日期時間值，請參閱每個建議案例所需的資料實體。

指導方針：

此資料實體供未來使用。
ListName 屬性有下列限制：
- 允許的字元集：A-Z、a-z、0-9、_、-、~、.。
- 不區分大小寫。
- 現有的 RecoListName值是保留值，並不能做為 ListName 值。請在資料擴充實體頁面上查看保留名稱的完整清單。
- 您可以使用清單可用性開始和結束日期來判斷清單的可用性，智慧建議只能在這些指定日期之間提供此清單。

範例資料：

標題只是為了方便起見而出現，不應成為實際資料的一部分。

ListName	名稱	ListAvailabilityStartDate	ListAvailabilityEndDate
SummerSale2020	2020 年最佳夏季項目	2020-07-01T00:00:00.000Z	2020-08-31T23:59:59.999Z

資料實體名稱：Reco_ExternalRecommendationsItems

描述：外部建議清單的項目

屬性：

姓名	資料類型	必要	無效值行為	意見
ListName	字串 (64)	.是	修剪值	唯一清單識別碼，也會在查詢清單時使用。長度限制為 64 個字元。您可以在這裡檢視 ListNames 表格。
ItemId	字串 (16)	.是	置放項目	如需 `itemId`，請參閱每個建議案例所需的資料實體。
ItemVariantId	字串 (16)	無	置放項目	如需 `itemVariantId`，請參閱每個建議案例所需的資料實體。
階層	Int	.是	置放項目	您希望每個項目出現的位置順序。

指導方針：

此資料實體供未來使用。
請參閱資料實體 Reco_ExternalRecommendationsLists 中的 ListName 指導方針。
智慧建議無法保證多個在同一清單中受指派相同排名的項目之間的內部排序。
如果相同項目或項目變體多次出現在清單中，則使用其最高排名，並忽略所有其他項目。
對於此資料實體中的每個 ListName 值，Reco_ExternalRecommendationsLists 資料實體中都必須有包含相同 ListName 值的對應項目；否則，忽略該項目。

範例資料：

標題只是為了方便起見而出現，不應成為實際資料的一部分。

ListName	ItemId	ItemVariantId	階層
SummerSale2020	Item2		7
SummerSale2020	Item3	Item3Var1	2
SummerSale2020	Item1	Item1Var2	3