實體屬性

使用實體屬性來傳遞產品或內容資訊至 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看起來與下列範例類似。** xwith mboxCreate。所有實體參數屬性都區分大小寫。

<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個字元。

範例:

• 產品詳細資料頁面範例: 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'

entity.custom

支援多個值 (JSON 陣列)。

定義最多 100 個自訂變數，用以提供項目的額外資訊。您可為各個自訂屬性指定任何未使用的屬性名稱。例如，您可以建立名為entity.genre的自訂屬性來定義書籍或影片。 票務供應商可以建立輔助表演者的活動場地屬性，例如體育賽事中的訪問團隊或音樂會中的開幕表演。

限制:

• 您無法對自訂實體屬性使用預先定義的實體屬性名稱。
• 屬性 entity.environment 由系統保留，並且無法用於自訂實體屬性。會忽略使用targetPageParams、feed或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' )