實體屬性

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

Recommendations 會傳送演算法中所用的 productId 或 productPurchasedId (即程式碼中的 entity.id)。

多數預先定義的參數僅接受單一值，以新的值覆寫舊的值。對於包含該產品的每個類別，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

支援多個值 (以逗號分隔值的清單)。

目前頁面的類別。其中可能包括多個類別，例如子區段的子項 cardigans (即 womens、womens:sweaters、womens:sweaters:cardigans)。多個類別應該以逗號區隔。

categoryId 限定為 250 字元以內。

範例:

• 產品詳細資料頁面範例: womens, womens:sweaters, womens:sweaters:cardigans
• 類別頁面範例 Sweaters🚺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 Park'

'entity.secondary=Rockies'

自訂實體屬性支援多個值。若要瞭解字元和值限制，請參閱自訂實體屬性。

範例: 'entity.secondary=["band1", "band2"]'

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

相關主題:

• 自訂實體屬性