使用實體屬性來傳遞產品或內容資訊至 Adobe Target Recommendations.
實體會參考您要建議的項目。實體可以包括產品、內容(文章、幻燈片、影像、電影和電視節目)、工作清單、餐廳等。
Recommendations 會傳送演算法中所用的 productId
或 productPurchasedId
(即程式碼中的 entity.id
)。
考慮以下事項:
entity.id
必須匹配 productPurchasedId
發送到訂單確認頁和 productId
用於 Adobe Analytics 產品報告。大多數預定義參數只接受單個值,新值覆蓋舊值。 對於包含該產品的每個類別,categoryId
參數都能接受值的逗號分隔清單。新的 categoryId
值不會覆寫現有值,而是在實體更新期間附加 (250 個字元限制)。
通常,如果您使用at.js 1,則顯示資訊框與以下示例類似。x 與 mboxCreate
。 所有實體參數屬性都區分大小寫。
如果您使用at.js 2。x。 mboxCreate
(如下例所用)不再受支援。 將產品或內容資訊傳遞到 Recommendations 使用at.js 2。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>
pageUrl
和 thumbnailUrl
最好使用相對 URL 而非絕對 URL,因為建議會接收從您網站上所有環境傳出的資料。使用相對 URL 會避免硬式編碼連結至開發用伺服器或程式開發伺服器。
如果 mbox 位於產品頁面,那麼,您可同時包括產品 ID 和類別 ID。所選的演算法決定了顯示方式。產品 ID 用於相關性演算法,類別 ID 用於類別演算法。
以下清單說明可用的變數。
僅限單一值。
該必需的參數用於識別產品。該英數字元 ID 必須在所有使用的 Adobe Experience Cloud 產品中保持一致 (包括 Analytics),以便各種產品識別項目並共用相關資料。
的 entity.id
值 不 包含斜槓、和號、問號、百分比符號、逗號或其他標點字元,在REST API調用中傳遞時需要URL編碼。 允許使用連字元和下划線。 entity.id
Recommendations 值包含無效標點符號,會造成部分 功能無法使用。
範例: 'entity.id=67833'
僅限單一值。
建議產品時,網站上顯示的產品名稱。
範例: 'entity.name=Giants& vs& Rockies& 5/12'
支援多個值 (以逗號分隔值的清單)。
目前頁面的類別。entity.categoryID可以包括多個類別,如羊毛衫子子子小節(例如,女人、女人:毛衣、女人:sweaters:羊毛衫)。 多個類別必須用逗號分隔。
的 categoryId
值限制為250個字元。
若要根據「類別」頁面顯示建議,只能將一個 categoryId
傳遞至用於顯示該特定建議的 mbox。categoryId
的值必須與「產品詳細資料」頁面上傳遞之 entity.categoryId
的值完全相符。
範例:
對於基於類別的建議,用逗號分隔類別值。 以逗號區隔的值都會成為類別。您也可以使用不同的分隔符號來定義子類別,例如冒號 (:),用以區隔類別值中的子類別。
例如,在以下代碼中,婦女類別分為幾個子類別:
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:夾克:卡班。
僅限單一值。
顯示項目的品牌名稱。
範例: 'entity.brand=brandxyz'
僅限單一值。
定義了可購買項目的頁面的相對 URL。
範例: 'entity.pageUrl=baseball/giants-tix/giantsvrockies5.12.2000-67833'
僅限單一值。
定義了與項目一同顯示的縮圖影像的相對 URL。
範例: 'entity.thumbnailUrl=baseball/giants-tix/giants-136px.gif'
僅限單一值。
關於建議中所顯示產品的訊息,例如「特價」或「出清」。訊息通常較產品名稱更詳細。使用entity.message定義要與模板中的產品一起顯示的附加資訊。
範例: 'entity.message=Family special'
僅限單一值。需要整數或 Long 值。
顯示項目的庫存水平。
範例: 'entity.inventory=1'
空庫存屬性處理: 對於交貨,如果您具有包含規則、收集規則或條件設定 entity.inventory
> 0或 entity.inventory
= 0,產品未設定庫存, Target 將此值評估為TRUE,並包括未設定庫存的產品。 因此,未設定庫存的產品將顯示在建議結果中。
同樣地,如果您有一個全域排除規則,其中 entity.inventory
= 0 且未設定 entity.inventory
,則 Target 會將此規則評估為 TRUE,並排除該產品。
已知問題: 產品搜索與未設定的庫存值屬性的交貨不一致。 例如,對於具有 entity.inventory
= 0,「產品搜索」不顯示未設定庫存值的產品。
僅限單一值。
定義項目的價格或價值。
範例: 'entity.value=15.99'
entity.value僅支援小數格式(例如15.99)。 不支援逗號格式(15,99)。
僅限單一值。
項目的利潤率或其他值。
範例: 'entity.margin=1.00'
支援多個值 (JSON 陣列)。
定義最多 100 個自訂變數,用以提供項目的額外資訊。您可為各個自訂屬性指定任何未使用的屬性名稱。例如,可以建立名為 entity.genre
定義書籍或電影。 票證供應商可以為輔助表演者的活動場所建立屬性,例如體育賽事中的訪問團隊或音樂會的開幕活動。
限制:
範例:
'entity.venue=AT&T Park'
'entity.secondary=Rockies'
自訂實體屬性支援多個值。若要瞭解字元和值限制,請參閱自訂實體屬性。
範例: 'entity.secondary=["band1", "band2"]'
多值自訂實體屬性需要有效的 JSON 陣列。有關正確的語法資訊,請參見 自定義實體屬性。
僅限單一值。
用來防止 mbox 呼叫遞增演算法的行為資料計數器。
範例: 'entity.event.detailsOnly=true'
在下面的示例中,第一個框調用更新目錄和行為資料。 第二個框調用僅更新目錄。
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' )