adobe.target.applyOffers(options) - at.js 2.x
此函數可讓您套用一個以上由 adobe.target.getOffers()
擷取的選件。
NOTE
此函式於at.js 2.x 使用供跨網域追蹤功能時。 此函式不適用於at.js版本1。x 版本不支援此函數。
索引鍵
類型
必要?
說明
selector
字串
無
HTML 元素或 CSS 選取器過去會識別 Target 應該放置選件內容的 HTML 元素。如果未提供選取器,Target會假設要使用的HTML元素為HTMLHEAD。
回應
物件
是
回應來自
請參閱下方的「要求」表格。
getOffers()
的物件。請參閱下方的「要求」表格。
回應
NOTE
請參閱傳送API檔案,取得下列所有欄位的可接受型別的相關資訊。
欄位名稱
說明
response > prefetch > views > options > content
請注意,「選項」的內容並無明確定義,且直接取決於選項類型/範本結構。
response > prefetch > views > options > type
選項類型。反映「內容」欄位的類型。支援的類型為動作。
response > prefetch > views > state
不透明的檢視狀態 Token,該 Token 應隨檢視的顯示通知轉送
response > prefetch > views > options > responseTokens
包含處理目前選項時已收集的
responseTokens
地圖。response > prefetch > views > analytics > payload
用於使用者端整合的Analytics裝載,套用檢視後應該傳送至Analytics。
response > prefetch > views > trace
包含所有追蹤資料的物件,這些資料為各檢視的預先擷取呼叫之追蹤資料。
追蹤物件也包含追蹤的版本。
追蹤物件也包含目前檢視的詳細資訊。
追蹤物件也包含追蹤的版本。
追蹤物件也包含目前檢視的詳細資訊。
response > prefetch > views > options > eventToken
系統會為每個選項執行事件記錄。應針對每個已套用的選項,將個別事件 Token 新增至通知 Token 清單中。請注意,一個檢視是由多個選項組成。如果所有選項均已套用並顯示,則需要將所有
eventTokens
納入通知中。response > prefetch > views > name
人類可讀的檢視名稱。
response > prefetch > views > metrics
應監看報告量度並向 Target 通知。目前僅支援點擊量度。當有使用者點擊元素,就應收集適當的
eventTokens
並傳送通知。response > prefetch > views > key
用於識別檢視的機碼或指紋。
response > prefetch > views > id
檢視的 ID。
response > notifications > id
通知 ID。
response > notifications > events > type
通知、點擊或顯示的類型。
response > notifications > events > trace
通知事件的追蹤。
response > notifications > events > token
隨通知事件傳送的 Token。
response > notifications > events > timestamp
隨通知事件傳送的時間戳記。
response > notifications > events > errorCode
如果通知失敗,錯誤碼會指出失敗的原因。
response > notifications > events
已記錄或無法記錄的目前通知事件。
response > notifications
指出已記錄或失敗的通知。
response > execute > mboxes > mbox > trace
包含個別 mbox 要求之所有追蹤資料的物件。
response > execute > mboxes > mbox > responseTokens
包含特定 mbox 要求執行的
responseTokens
地圖。response > execute > mboxes > mbox > option > content
請注意,「選項」的內容並無明確定義,且直接取決於選項類型/範本結構。
response > execute > mboxes > mbox > option > type
選項類型。反映「內容」欄位的類型。支援的類型為: html、重新導向 、JSON 和動態。
response > execute > mboxes > mbox > options
回應選項。
response > execute > mboxes > mbox > metrics > eventToken
點擊事件的 Token。
response > execute > mboxes > mbox > metrics > type
"click"
response > execute > mboxes > mbox > metrics
包含
clickThrough
量度清單。response > execute > mboxes > mbox > mbox
mbox 的名稱。
response > execute > mboxes > mbox >index
指出回應是針對要求中帶有此索引的 mbox。
response > execute > mboxes > mbox > analytics > payload
用於使用者端整合的Analytics裝載,套用mbox後應該傳送至Analytics。 (請參閱「啟用 A4T 的促銷活動」一節)。
response > execute > mboxes
已執行 mbox 的清單。
response > execute > pageLoad > options > content
請注意,「選項」的內容並無明確定義,且直接取決於選項類型/範本結構。
response > execute > pageLoad > options > type
選項類型。反映「內容」欄位的類型。支援的類型為: html、重新導向、JSON、動態和動作。
response > execute > pageLoad > options
未依檢視分組的選項 (target-global-mbox + 含有未依檢視分組的檢視之活動選項)。
response > execute > pageLoad > metrics
未設定為屬於特定檢視的點擊量度。
response > execute > pageLoad > trace
包含 PageLoad 要求之所有追蹤資料的物件。
response > execute > pageLoad > analytics > payload
用於使用者端整合的Analytics裝載,套用頁面載入內容後應該傳送至Analytics。 (請參閱「啟用 A4T 的促銷活動」一節)。
範例applyOffers()呼叫
adobe.target.applyOffers({response:{
"execute": {
"pageLoad": {
"options": [{
"type": "html",
"content": "page-load"
},
{
"type": "actions",
"content": [{
"type": "setHtml",
"content": "<h1>Container 1</h1>",
"selector": "#container1",
"cssSelector": "#container1"
},
{
"type": "setHtml",
"content": "<h3>Container 3</h3>",
"selector": "#container3",
"cssSelector": "#container3"
}]
}],
"metrics": [{
"type": "click",
"selector": "#container1",
"eventToken": "page-load-click-metric"
}]
}
}
}});
與getOffers()
和applyOffers()
鏈結的Promise呼叫範例,因為這些函式是以Promise為基底
adobe.target.getOffers({...})
.then(response => adobe.target.applyOffers({ response: response }))
.then(() => console.log("Success"))
.catch(error => console.log("Error", error));
如需如何使用getOffers()的更多範例,請參閱getOffers 檔案
頁面載入請求範例
adobe.target.getOffers({
request: {
execute: {
pageLoad: {}
}
}
}).
then(response => adobe.target.applyOffers({ response: response }))
.then(() => console.log("Success"))
.catch(error => console.log("Error", error));
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3