[Premium]{class="badge positive" title="檢視Target Premium包含的內容。"}
實體屬性
使用實體屬性將產品或內容資訊傳遞至 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看起來會像下面的範例。x 替換為 mboxCreate
. 所有實體引數屬性都區分大小寫。
mboxCreate
(如下列範例所使用)不再受支援。 若要將產品或內容資訊傳遞至 Recommendations 使用at.js 2.x,使用 targetPageParams. For an example, see Plan and implement 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>
pageUrl
和 thumbnailUrl
最好使用相對 URL 而非絕對 URL,因為建議會接收從您網站上所有環境傳出的資料。使用相對 URL 會避免硬式編碼連結至開發用伺服器或程式開發伺服器。如果 mbox 位於產品頁面,那麼,您可同時包括產品 ID 和類別 ID。所選的演算法決定了顯示方式。產品 ID 用於相關性演算法,類別 ID 用於類別演算法。
可用變數
以下清單說明可用的變數。
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
支援多個值 (以逗號分隔值的清單)。
目前頁面的類別。entity.categoryID可包含多個類別,例如cardigans子區段(例如 womens
, womens:sweaters
, womens:sweaters:cardigans
)。 多個類別必須以逗號分隔。
此 categoryId
值的限製為250個字元。
categoryId
可傳遞至用於顯示該特定建議的mbox。 的值 categoryId
必須完全符合的值 entity.categoryId
傳遞於 Product Detail 頁面。範例:
- 產品詳細資料頁面範例:
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'
實體。custom
支援多個值 (JSON 陣列)。
定義最多 100 個自訂變數,用以提供項目的額外資訊。您可為各個自訂屬性指定任何未使用的屬性名稱。例如,您可以建立自訂屬性,稱為 entity.genre
定義書籍或電影。 票務廠商可為次要參與者的活動場地建立屬性,例如體育活動中的客隊或音樂會中的開場表演。
限制:
- 您無法對自訂實體屬性使用預先定義的實體屬性名稱。
- 屬性 entity.environment 由系統保留,並且無法用於自訂實體屬性。嘗試使用targetPageParams、摘要或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' )