PREMIUM 實體屬性

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

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

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

考慮以下事項:

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

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

一般而言,如果您使用at.js 1,顯示資訊mbox看起來與下列範例類似。** xwith mboxCreate。所有實體參數屬性都區分大小寫。

注意

如果您使用at.js 2。x, mboxCreate (如下例所用)不再受支援。使用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>
注意

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可包含多個類別,例如子子分段的羊毛衫(例如womens、womens:sweaters、womens:sweaters:cardigans)。 多個類別必須以逗號分隔。

categoryId值限制為250個字元。

注意

若要根據「類別」頁面顯示建議,只能將一個 categoryId 傳遞至用於顯示該特定建議的 mbox。categoryId 的值必須與「產品詳細資料」頁面上傳遞之 entity.categoryId 的值完全相符。

範例:

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

entity.custom

支援多個值 (JSON 陣列)。

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

限制:

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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now