互動資料實體
本文提供有關如何在智慧建議資料合約中設定互動資料實體的指引。
資料實體檢閱
資料實體是一組有一個或多個資料文字檔的集合，每個檔案都有欄 (也稱為屬性) 和包含實際資料值之列的清單。
智慧建議定義資料實體的邏輯群組，每個群組都各有本身用途。
注意
資料實體為選擇性實體 (除非明確指出)，這表示其資料可以空白或遺失。
如需資料實體的完整清單，請參閱資料實體。
互動資料實體簡介
互動代表使用者與目錄項目所有互動方式的集合。 一些常見的圖層互動包括交易性互動 (購買)、檢視 (點閱)、評等，或任何在使用者與項目或項目變體之間發生的其他動作。
下列資料實體是互動資料實體的一部分：
互動
資料實體名稱：Reco_Interactions。
描述：所有與項目及項目變體之間的使用者互動。
屬性：
| 名稱 | 資料類型 | 必要 | 預設值 | 無效值行為 | 意見 |
|---|---|---|---|---|---|
| InteractionGroupingId | 字串 (256) | .是 | 置放項目 | 數個互動的群組識別碼。 長度限制為 256 個字元。 | |
| ItemId | 字串 (16) | .是 | 置放項目 | 如需項目識別碼，請參閱每個建議案例所需的資料實體。 | |
| ItemVariantId | 字串 (16) | 無 | 置放項目 | 如需項目變體識別碼，請參閱每個建議案例所需的資料實體。 | |
| UserId | 字串 (256) | 無 | 置放項目 | 空值表示匿名互動。 長度限制為 256 個字元。 | |
| InteractionType | 字串 | 無 | 交易 | 置放項目 | 交易是此屬性唯一的有效值，並不會影響建議的結果。 |
| TimeStamp | 日期時間 | 無 | 1970-01-01T00:00:00.000Z | 置放項目 | 如需日期時間值，請參閱每個建議案例所需的資料實體。 |
| 字串屬性 | 字串 (64) | 無 | 置放項目 | 長度限制為 64 個字元。 可根據業務需求使用且不影響模型建立程序的字串屬性。 | |
| 雙重屬性 | 雙精確度 | 無 | 置放項目 | 可以根據業務需求使用且不影響建立模型程序的雙重屬性。 | |
| 通道 | 字串 (64) | 無 | 0 | 修剪值 | 長度限制為 64 個字元。 |
| 目錄 | 字串 (64) | 無 | 12 | 修剪值 | 長度限制為 64 個字元。 |
| 優勢 | 雙精確度 | 無 | 1.0 | 置放項目 | 表示互動的顯著性 (與其他互動相比)。 此屬性有助於改善交易處理和效能，但資料的透明度以及合乎道德的使用資料也是重要考慮因素。 在 Next Best Action、User Picks 和 Similar (AlgoType=MF) 中可支援。 |
| IsPositive | Bool | 無 | 確判為真 | 如需布林值，請參閱每個建議案例所需的資料實體。 |
指導方針：
InteractionGroupingId 是在單一多項目互動中將項目群組在一起的主要共同作業指標。 這可以是您業務範圍內任何在項目之間建立關聯性的指標。 例如，相同互動 (購物籃) 中購買的項目可能相連接/相關，因此購物籃/交易識別碼可能非常適合此欄位。 如果共同作業因素是與項目互動的使用者 (人員)，您可能需要將 UserId 複製到此欄位，同時也將其放在 UserId 欄位中。
請確定互動資料實體包含相同類型的互動 (類型可以是 [讚]、[交易]、[檢視] 等)。 為了獲得有關各種互動類型的建議，建議建模型讀取相同類型的互動。 將不同類型的交易合併至同一個模型中會傳回混合建議，與使用單獨的模型/IR 帳戶相比，這些建議有不同的意義，且不一定是期望的含義。
系統會忽略不支援的互動類型。
所有表示相同作業的資料列 (例如，多個項目的交易) 必須有相同的唯一群組識別碼。
負面互動 (例如項目退回或倒讚次數) 由 IsPositive=False 表示。
所列的 [雙重屬性]、[字串屬性] 和 [互動類型] 欄現在可以保留空白。
使用 "0" 做為「管道」或「目錄」屬性的值會導致處理錯誤。
在 Next Best Action 案例中，[強度] 屬性上限為 10。 10 以上的值會取代為 10。
何時使用強度的範例如下：
- 優先考慮更有可能與之互動 (即檢視、觀看等) 的產品。 如果您希望把最近購買商品的優先順序調高，請考慮使用 RecentPurchases Algo 類型嘗試 Picks API，其已經將使用者最近的互動調至最高優先順序。
- 可透過將相關交易的強度設定為使用者對該商品的評分，來反映 1-5 級的商品評分。
- 賦予觀看時長較短的次數較高的強度，使之大於觀看影片較久次數的強度，藉此優先考慮觀看影片的持續時間。
範例資料：
標題只是為了方便起見而出現，不應成為實際資料的一部分。
| InteractionGroupingId | ItemId | ItemVariantId | UserId | InteractionType | TimeStamp | 字串屬性 | 雙重屬性 | 通道 | 目錄 | 優勢 | IsPositive |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Interaction100 | Item1 | Item1Var1 | 交易 | 2020-04-01T10:00:00.000Z | |||||||
| Interaction100 | Item2 | 交易 | 2020-04-01T10:00:00.000Z | 2.0 | |||||||
| Interaction101 | Item2 | User1 | 按讚 | 2020-05-01T13:25:00.000Z | Interaction-101-RT | False | |||||
| Interaction101 | Item3 | User2 | 評等 | 2020-07-12T08:45:00.000Z | 歐洲 | MySale | 4.0 | 誤判為真 |
如需資料實體的完整清單，請參閱資料實體。
另請參閱
資料合約概觀資料實體對應資料表目錄資料實體Reco 設定資料實體外部清單資料實體退出宣告使用者資料實體建議擴充資料實體影像至項目對應資料實體智慧建議 API快速入門手冊：使用範例資料設定並執行智慧建議