互動資料實體
本文提供有關如何在智慧建議資料合約中設定互動資料實體的指引。
資料實體檢閱
資料實體是一組有一個或多個資料文字檔的集合，每個檔案都有欄 (也稱為屬性) 和包含實際資料值之列的清單。
智慧建議定義資料實體的邏輯群組，每個群組都各有本身用途。
注意
資料實體為選擇性實體 (除非明確指出)，這表示其資料可以空白或遺失。
如需資料實體的完整清單，請參閱資料實體。
互動資料實體簡介
互動代表使用者與目錄項目所有互動方式的集合。 一些常見的圖層互動包括交易性互動 (購買)、檢視 (點閱)、評等，或任何在使用者與項目或項目變體之間發生的其他動作。
下列資料實體是互動資料實體的一部分：
互動
資料實體名稱：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
快速入門手冊：使用範例資料設定並執行智慧建議