[Premium]{class="badge positive" title="檢視Target Premium包含的內容。"}
實體屬性
使用實體屬性將產品或內容資訊傳遞至 Adobe Target Recommendations.
實體會參考您要建議的項目。實體可包括產品、內容（文章、幻燈片、影像、電影和電視節目）、工作清單、餐廳等。
Recommendations 傳送 productId 或 productPurchasedId (稱為 entity.id （位於程式碼中），此專案會在演演算法中使用。
考慮以下事項：
entity.id必須符合productPurchasedId已傳送至訂購確認頁面，而且productId使用位置 Adobe Analytics 產品報表。- 您傳遞給的實體屬性值 Recommendations 會在61天後過期。 Adobe建議您將每個實體屬性的最新值傳遞至 Recommendations 目錄中每個專案每月至少執行一次。
大部分預先定義的引數僅接受單一值，且新值會覆寫舊值。 對於包含該產品的每個類別，categoryId 參數都能接受值的逗號分隔清單。新的 categoryId 值不會覆寫現有值，而是在實體更新期間附加 (250 個字元限制)。
一般而言，如果您使用at.js 1，顯示資訊mbox看起來會像下面的範例。x 替換為 mboxCreate. 所有實體引數屬性都區分大小寫。
mboxCreate （如下列範例所使用）不再受支援。 若要將產品或內容資訊傳遞至 Recommendations 使用at.js 2.x，使用 targetPageParams. For an example, see Plan and implement Recommendations.<div class="mboxDefault"></div><script language="JavaScript1.2">
mboxCreate('productPage',
'entity.id=67833',
'entity.name=GIANTS VS ROCKIES 5/12',
'entity.categoryId=BASEBALL, GIANTS, SF BAY AREA',
'entity.pageUrl=/help/baseball/giants-tix/giantsvrockies5.12.2000-67833',
'entity.venue=AT&T PARK',
'entity.secondary=ROCKIES',
'entity.thumbnailUrl=/help/baseball/giants-tix/giants-136px.gif',
'entity.message=FAMILY SPECIAL',
'entity.value=15.99',
'entity.inventory=1'
);
</script>
pageUrl 和 thumbnailUrl 最好使用相對 URL 而非絕對 URL，因為建議會接收從您網站上所有環境傳出的資料。使用相對 URL 會避免硬式編碼連結至開發用伺服器或程式開發伺服器。如果 mbox 位於產品頁面，那麼，您可同時包括產品 ID 和類別 ID。所選的演算法決定了顯示方式。產品 ID 用於相關性演算法，類別 ID 用於類別演算法。
可用變數
以下清單說明可用的變數。
entity.id
僅限單一值。
該必需的參數用於識別產品。該英數字元 ID 必須在所有使用的 Adobe Experience Cloud 產品中保持一致 (包括 Analytics)，以便各種產品識別項目並共用相關資料。
此 entity.id 值必須 非 包含空格、斜線、&符號、問號、百分比符號、逗號，或其他在REST API呼叫中傳送時需要URL編碼的標點符號字元。 允許連字型大小和底線。 entity.idRecommendations 值包含無效標點符號，會造成部分 功能無法使用。
範例: 'entity.id=67833'
entity.name
僅限單一值。
建議產品時，網站上顯示的產品名稱。
範例: 'entity.name=Giants& vs& Rockies& 5/12'
entity.categoryId
支援多個值 (以逗號分隔值的清單)。
目前頁面的類別。entity.categoryID可包含多個類別，例如cardigans子區段(例如 womens， womens:sweaters， womens:sweaters:cardigans)。 多個類別必須以逗號分隔。
此 categoryId 值的限製為250個字元。
categoryId 可傳遞至用於顯示該特定建議的mbox。 的值 categoryId 必須完全符合的值 entity.categoryId 傳遞於 Product Detail 頁面。範例:
- 產品詳細資料頁面範例：
womens，womens:sweaters，womens:sweaters:cardigans - 類別頁面範例Sweaters：
womens:sweaters - 類別頁面Cardigans範例：
womens:sweaters:cardigans
若使用類別型建議，請使用逗號分隔類別值。 以逗號區隔的值都會成為類別。您也可以使用不同的分隔符號來定義子類別，例如冒號 (:)，用以區隔類別值中的子類別。
例如，在以下程式碼中，女性類別分為幾個子類別：
mboxCreate('mboxName', 'entity.id=343942-32', 'entity.categoryId= Womens, Womens:Outerwear, Womens:Outerwear:Jackets, Womens:Outerwear:Jackets:Parka, Womens:Outerwear:Jackets:Caban', 'entity.thumbnailUrl=...', 'entity.message=...', );
針對 mbox 傳送，將使用最長的屬性名稱做為索引鍵。如果出現平手狀況，將使用最後一個屬性。在上述範例中，類別索引鍵為 Womens:Outerwear:Jackets:Caban.
entity.brand
僅限單一值。
顯示項目的品牌名稱。
範例: 'entity.brand=brandxyz'
entity.pageUrl
僅限單一值。
定義了可購買項目的頁面的相對 URL。
範例: 'entity.pageUrl=baseball/giants-tix/giantsvrockies5.12.2000-67833'
entity.thumbnailUrl
僅限單一值。
定義了與項目一同顯示的縮圖影像的相對 URL。
範例: 'entity.thumbnailUrl=baseball/giants-tix/giants-136px.gif'
entity.message
僅限單一值。
關於建議中所顯示產品的訊息，例如「特價」或「出清」。訊息通常較產品名稱更詳細。使用entity.message定義要在範本中與產品一起顯示的其他資訊。
範例: 'entity.message=Family special'
entity.inventory
僅限單一值。需要整數或 Long 值。
顯示項目的庫存水平。
範例: 'entity.inventory=1'
空的存貨屬性處理： 對於傳送，如果您有包含規則、集合規則或條件設定，其中 entity.inventory > 0或 entity.inventory = 0且產品未設定詳細目錄， Target 會將此值評估為TRUE，並包含未設定詳細目錄的產品。 因此，含有未設定庫存的產品會顯示在建議結果中。
同樣地，如果您有一個全域排除規則，其中 entity.inventory = 0 且未設定 entity.inventory，則 Target 會將此規則評估為 TRUE，並排除該產品。
已知問題： 產品搜尋與未設定的存貨值屬性的傳送不一致。 例如，針對具有「 」的規則 entity.inventory = 0 ，產品搜尋不會顯示未設定庫存值的產品。
entity.value
僅限單一值。
定義項目的價格或價值。
範例: 'entity.value=15.99'
entity.value僅支援十進位格式（例如15.99）。 不支援逗號格式(15,99)。
entity.margin
僅限單一值。
項目的利潤率或其他值。
範例: 'entity.margin=1.00'
實體。custom
支援多個值 (JSON 陣列)。
定義最多 100 個自訂變數，用以提供項目的額外資訊。您可為各個自訂屬性指定任何未使用的屬性名稱。例如，您可以建立自訂屬性，稱為 entity.genre 定義書籍或電影。 票務廠商可為次要參與者的活動場地建立屬性，例如體育活動中的客隊或音樂會中的開場表演。
限制:
- 您無法對自訂實體屬性使用預先定義的實體屬性名稱。
- 屬性 entity.environment 由系統保留，並且無法用於自訂實體屬性。嘗試使用targetPageParams、摘要或API來傳遞entity.environment會被忽略。
範例:
'entity.venue=AT&T Park'
'entity.secondary=Rockies'
自訂實體屬性支援多個值。若要瞭解字元和值限制，請參閱自訂實體屬性。
範例: 'entity.secondary=["band1", "band2"]'
多值自訂實體屬性需要有效的 JSON 陣列。如需正確語法資訊，請參閱 自訂實體屬性.
entity.event.detailsOnly
僅限單一值。
用來防止 mbox 呼叫遞增演算法的行為資料計數器。
範例: 'entity.event.detailsOnly=true'
在以下範例中，第一個mbox呼叫會更新目錄和行為資料。 第二個mbox呼叫只會更新目錄。
mboxCreate('myMbox', 'profile.geo.city = new york', 'profile.geo.state = new york', 'entity.id = 'entity.inventory = 4' )
mboxCreate('myMbox', 'profile.geo.city = new york', 'profile.geo.state = new york', 'entity.id = 123', 'entity.inventory = 4' 'entity.event.detailsOnly=true' )