[Premium]{class="badge positive" title="檢視Target Premium包含的內容。"}

實體屬性

使用實體屬性將產品或內容資訊傳遞至Adobe Target Recommendations。

實體會參考您要建議的項目。 實體可包括產品、內容（文章、幻燈片、影像、電影和電視節目）、工作清單、餐廳等。

Recommendations會傳送演演算法中所使用的productId或productPurchasedId （在程式碼中稱為entity.id）。

考慮以下事項：

大部分預先定義的引數僅接受單一值，且新值會覆寫舊值。 對於包含該產品的每個類別，categoryId 參數都能接受值的逗號分隔清單。 新的 categoryId 值不會覆寫現有值，而是在實體更新期間附加 (250 個字元限制)。

一般而言，如果您使用at.js 1.x​搭配mboxCreate，顯示資訊mbox看起來會像下面的範例。 所有實體引數屬性都區分大小寫。

<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>

如果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可包含多個類別，例如羊毛衫子區段（例如，womens、womens:sweaters、womens:sweaters:cardigans）。 多個類別必須以逗號分隔。

categoryId值限製為250個字元。

範例:

若使用類別型建議，請使用逗號分隔類別值。 以逗號區隔的值都會成為類別。 您也可以使用不同的分隔符號來定義子類別，例如冒號 (:)，用以區隔類別值中的子類別。

例如，在以下程式碼中，女性類別分為幾個子類別：

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'

實體。自訂

支援多個值 (JSON 陣列)。

定義最多 100 個自訂變數，用以提供項目的額外資訊。 您可為各個自訂屬性指定任何未使用的屬性名稱。 例如，您可以建立名為entity.genre的自訂屬性，以定義書籍或電影。 票務廠商可為次要參與者的活動場地建立屬性，例如體育活動中的客隊或音樂會中的開場表演。

限制:

範例:

'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' )