Show Menu
主題×

實體屬性

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

可用變數

以下清單說明可用的變數。

entity.id

僅限單一值。
該必需的參數用於識別產品。該英數字元 ID 必須在所有使用的 Adobe Experience Cloud 產品中保持一致 (包括 Analytics),以便各種產品識別項目並共用相關資料。
entity.id 值不得包含斜線、& 符號、問號、百分比符號、逗號,或其他在 REST API 呼叫中傳送時需要 URL 編碼的標點符號字元。但可使用連字號和底線。 entity.id Recommendations 值包含無效標點符號,會造成部分 功能無法使用。
範例: 'entity.id=67833'

entity.name

僅限單一值。
建議產品時,網站上顯示的產品名稱。
範例: 'entity.name=Giants& vs& Rockies& 5/12'

entity.categoryId

支援多個值 (以逗號分隔值的清單)。
目前頁面的類別。其中可能包括多個類別,例如子區段的子項 cardigans (即 womens、womens:sweaters、womens:sweaters:cardigans)。多個類別應該以逗號區隔。
categoryId 限定為 250 字元以內。
若要根據「類別」頁面顯示建議,只能將一個 categoryId 傳遞至用於顯示該特定建議的 mbox。 categoryId 的值必須與「產品詳細資料」頁面上傳遞之 entity.categoryId 的值完全相符。
範例:
  • 產品詳細資料頁面範例: womens, womens:sweaters, womens:sweaters:cardigans
  • 類別頁面範例 Sweaters:womens:sweaters
  • 類別頁面範例 Cardigans: womens:sweaters:cardigans
若使用類別型建議,請使用逗號來區隔類別值。以逗號區隔的值都會成為類別。您也可以使用不同的分隔符號來定義子類別,例如冒號 (:),用以區隔類別值中的子類別。
例如,在下列程式碼中,Womens 類別又區分為數個子類別:
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=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.margin

僅限單一值。
項目的利潤率或其他值。
範例: 'entity.margin=1.00'

entity.<custom>

支援多個值 (JSON 陣列)。
定義最多 100 個自訂變數,用以提供項目的額外資訊。您可為各個自訂屬性指定任何未使用的屬性名稱。例如,您可以建立稱為 entity.genre 的自訂屬性,以定義書籍或電影。或者,票務公司可就次要參與者的活動地點來建立屬性,包括體育賽事中的客隊或音樂會中的開幕表演。
限制:
  • 您無法對自訂實體屬性使用預先定義的實體屬性名稱。
  • 屬性 entity.environment 由系統保留,並且無法用於自訂實體屬性。嘗試使用 targetPageParams、摘要或 API 來傳遞 entity.environment 將被忽略。
範例:
'entity.venue=AT&T&nbsp;Park'
'entity.secondary=Rockies'
自訂實體屬性支援多個值。若要瞭解字元和值限制,請參閱 自訂實體屬性
範例: 'entity.secondary=["band1",&nbsp;"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' )

使用實體屬性

提供的實體屬性值會在 61 天後過期。這表示您應確實針對目錄中的每個項目,每個月至少傳送一次每個實體屬性的最新值至 Target Recommendations。
Recommendations 會傳送演算法中所用的 productId productPurchasedId (即程式碼中的 entity.id )。
entity.id 必須與傳送至訂購確認頁面的 productPurchasedId 和 Adobe Analytics 產品報表中所用的 productId 相符)。
多數預先定義的參數僅接受單一值,以新的值覆寫舊的值。對於包含該產品的每個類別, categoryId 參數都能接受值的逗號分隔清單。新的 categoryId 值不會覆寫現有值,而是在實體更新期間附加 (250 個字元限制)。
一般來說,顯示資訊 mbox 可能類似於下例: 依自身產品變更以粗體顯示的詳情。
所有實體參數屬性均區分大小寫。
<div class="mboxDefault"></div><script language="JavaScript1.2"> 
 
mboxCreate('productPage', 
 
'entity.id= 
<b>67833</b>', 
 
'entity.name= 
<b>GIANTS VS ROCKIES 5/12</b>', 
 
'entity.categoryId= 
<b>BASEBALL, GIANTS, SF BAY AREA</b>', 
 
'entity.pageUrl= 
<b>../baseball/giants-tix/giantsvrockies5.12.2000-67833</b>', 
 
'entity.venue= 
<b>AT&T PARK</b>', 
 
'entity.secondary= 
<b>ROCKIES</b>', 
 
'entity.thumbnailUrl= 
<b>../baseball/giants-tix/giants-136px.gif</b>', 
 
'entity.message= 
<b>FAMILY SPECIAL</b>', 
 
'entity.value= 
<b>15.99</b>', 
 
'entity.inventory= 
<b>1</b>' 
 
); 
 
</script>

pageUrl thumbnailUrl 最好使用相對 URL 而非絕對 URL,因為建議會接收從您網站上所有環境傳出的資料。使用相對 URL 會避免硬式編碼連結至開發用伺服器或程式開發伺服器。
如果 mbox 位於產品頁面,那麼,您可同時包括產品 ID 和類別 ID。所選的演算法決定了顯示方式。產品 ID 用於相關性演算法,類別 ID 用於類別演算法。

相關主題: