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

實體屬性

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

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

Recommendations會傳送演演算法中所使用的productIdproductPurchasedId (在程式碼中稱為entity.id)。

考慮以下事項:

  • entity.id必須符合傳送至訂購確認頁面的productPurchasedId以及在Adobe Analytics產品報告中使用的productId
  • 您傳遞至Recommendations的實體屬性值會在61天後過期。 Adobe建議您針對目錄中的每個專案,每個月至少傳送一次每個實體屬性的最新值至Recommendations。

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

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

NOTE
如果您使用at.js 2.不再支援​ xmboxCreate (如下列範例所使用)。 若要使用at.js 2.Recommendations x,使用targetPageParams。 如需範例,請參閱計畫和實作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>
NOTE
pageUrlthumbnailUrl 最好使用相對 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可包含多個類別,例如羊毛衫子區段(例如,womenswomens:sweaterswomens:sweaters:cardigans)。 多個類別必須以逗號分隔。

categoryId值限製為250個字元。

NOTE
若要根據Category頁面中的類別顯示建議,只能將一個categoryId傳遞至用於顯示該特定建議的mbox。 categoryId的值必須與Product Detail頁面上傳遞之entity.categoryId的值完全相符。

範例:

  • 產品詳細資料頁面範例: womenswomens:sweaterswomens:sweaters:cardigans
  • 類別頁面毛衣範例: 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&nbsp;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&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' )
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654