有關 Adobe Target at.js JavaScript 資料庫每個版本中的變更的詳細資料。
Target團隊同時支援at.js 1。x 與 at.js 2.x 之間的對應。請升級至任一主要版本的最新更新at.js,以確保您執行的是支援的版本。
Adobe Experience Platform Launch是升級at.js的偏好方法。擴充功能開發人員會持續在擴充功能中新增功能,並經常修正錯誤。 這些更新會封裝成新版擴充功能,並在Launch目錄中提供升級。 如需詳細資訊,請參閱Experience Platform Launch使用指南中的Extension Upgrade。
此版本的at.js是維護髮行,包含下列修正:
此版本的at.js是維護髮行,包含下列修正:
此版本的at.js是維護髮行,包含下列修正:
此版本的at.js是維護髮行,包含下列修正:
此 at.js 版本為維護版本,包含下列增強功能和修正:
deviceIdLifetime
設定設為可覆寫。 (TNT-36349)sendBeacon
呼叫的問題。 (TNT-36407、TNT-35990、TNT-36000)此 at.js 版本為維護版本,包含下列增強功能和修正:
targetGlobalSettings.cspScriptNonce
和targetGlobalSettings.cspStyleNonce
,如此at.js就可以在套用的選件上設定對應的指令碼和樣式標籤nonces。 如需詳細資訊,請參閱targetGlobalSettings。check
重新命名為at_check
,以避免與客戶實作衝突。此 at.js 版本為維護版本,包含下列增強功能和修正:
check
重新命名為at_check
,以避免與客戶實作衝突。此版本的at.js包含下列增強功能和修正:
已修正此問題:當Adobe Analytics代碼不存在於頁面元素時,點按追蹤不會報告Analytics for Target(A4T)中的轉換。
已改善在網頁上同時使用Experience Cloud ID Service(ECID)v4.4和at.js 2.2時的效能。
之前,ECID曾進行兩次封鎖呼叫,之後at.js才能擷取體驗。 這已簡化為單一呼叫,可大幅提升效能。
將您的ECID Launch Extension升級至v4.4,以運用此效能增強功能。
at.js 2.2版也提供名為serverState
的新設定。 當實作Target的混合整合時,此設定可用來最佳化頁面效能。 混合整合意指您在用戶端上同時使用at.js v2.2+和伺服器端的傳送API或Target SDK來傳送體驗。 serverState
讓at.js v2.2+能夠直接從伺服器端擷取並傳回至用戶端的內容套用體驗,做為所提供頁面的一部分。如需詳細資訊,請參閱targetGlobalSettings中的「serverState」。
此版本的at.js包含下列增強功能和修正:
將您的ECID Launch Extension升級至v4.4,以運用此效能增強功能。
此 at.js 版本為維護版本,包含下列增強功能和修正:
(括號內的問題編號供 Adobe 內部使用。)
triggerView()
無法多次呈現選件的問題。(TNT-32780)triggerView()
的問題,確保要求包含 Marketing Cloud ID (MCID) 資訊。(TNT-32776)triggerView()
通知引發的問題。(TNT-32614)Navigator.sendBeacon()
API 傳送的傳送要求內容中,指標標幟現已設定為「true」。(TNT-32683)targetPageParams
函數傳送 mboxThirdPartyId
時發生的問題,導致要求裝載無法出現於查詢參數或要求裝載中。(TNT-32613)此版本包含下列功能和增強功能:
Adobe 選擇加入支援: Adobe 選擇加入是簡化 Adobe 解決方案與同意管理平台整合的方法。如需 Adobe 選擇加入的詳細資訊,請參閱隱私權與一般資料保護規範 (GDPR)。
符合 CSP 產業標準: at.js 不再使用 eval() 執行 JavaScript。
用戶端 Analytics 記錄: 無論是在用戶端或伺服器端,皆可讓客戶完全掌控要以何種方式將分析資料傳送至 Adobe Analytics。
如需詳細資訊,請參閱實作之前中的用戶端 Analytics 記錄。
傳送通知: 可讓開發人員在透過體驗的程式碼 (而不是透過 applyOffer()
或 applyOffers()
) 呈現體驗時傳送通知。
如需詳細資訊,請參閱 adobe.target.sendNotifications(options)。
at.js 的大小約縮小了 24%: at.js 的大小約縮小了 24%。較小的檔案大小可改善頁面載入效能,並縮短在頁面上載入 at.js 的時間。
此為維護版本,包含下列增強功能和修正:
(括號內的問題編號供 Adobe 內部使用。)
此為維護版本,包含下列修正:
(括號內的問題編號供 Adobe 內部使用。)
at.js 2.x 提供豐富的功能組合,讓貴公司能以新世代用戶端技術為基礎進行個人化。本次的新版本著重於升級 at.js,進而與單一頁面應用程式 (SPA) 產生和諧互動。
以下是幾個使用 at.js 2.x 特有 (舊版未提供) 的優點:
at.js 2.x 引進以下新函數:
導入 at.js 2.x 後,以下函數已遭到淘汰:
如需詳細資訊,請參閱從 at.js 1.x 升級為 at.js 2.x 與 at.js 函數。
如果您需要一般資料保護規範 (GDPR) 的 Adobe 選擇加入支援,目前必須使用 at.js 1.7.0。
at.js 1.7.0 提供 Adobe 選擇加入支援。「Adobe 選擇加入」是簡化 Adobe 解決方案與同意管理平台整合的方法。
如需 Adobe 選擇加入的詳細資訊,請參閱隱私權與一般資料保護規範 (GDPR)。
此版本也修正 Target 可能將重新導向 URL 參數覆寫為來自重新導向 URL 之參數的問題。
如果您需要 GDPR 的 Adobe 選擇加入支援,目前必須使用 at.js 1.7.0 或 2.1.0。
如需所有版本的清單,請參閱 at.js 版本詳細資料。
at.js 1.6.4 維護版本解決下列問題:
at.js 1.6.3 包含下列修正和增強功能:
此維護版本解決下列問題:
此外,at.js 1.6.2 版也包含 1.6.1 和 1.6.0 版的所有增強功能和修正。這兩個版本已無法下載。如果使用 1.6.1 或 1.6.0,建議升級至 1.6.2 版
at.js 1.6.1 版包含下列增強功能和修正:
at.js 1.6.0 版包含下列增強功能和修正:
at.js 版本 1.5.0 現已可用。
at-request-succeeded
事件的詳細資訊內含重新導向旗標。這個旗標是用來判斷頁面是否會重新導向至其他 URL。如果您想知道該 URL,請訂閱 at-content-rendering-redirect
。(TNT-29834)
修正 window.targetGlobalSettings.enabled
在執行階段例外設為 false 時會失敗的問題。(TNT-29829)
修正使用自訂程式碼觸發全域 mbox 要求,以及使用主體隱藏時,造成頁面在可視化體驗撰寫器 (VEC) 載入失敗的問題。(TNT-29795)
新增對 screenOrientation
、devicePixelRatio
和 webGLRenderer
的支援。這些新 Target 要求參數可用於偵測 iPhone X 和其他新型裝置。如需詳細資訊,請參閱行動。(TNT-29781)
修正偶爾未傳送 Adobe Audience Manager (AAM) 位置提示的問題。(TNT-29695)
若瀏覽器支援 at.js 1.5.0,at.js 1.5.0 會切換為 MutationObserver 進行選取器輪詢。at.js 1.0.0 以前的版本使用 MutationObserver polyfill,已證實會造成問題。為避免 polyfill 問題,版本 1.5.0 使用下列虛擬程式碼,決定要使用哪個排程機制:
if MutationObserver is supported
scheduler = MutationObserver
else if document is visible
scheduler = requestAnimationFrame
else
scheduler = setTimeout
at.js 1.3.0 版現已可用。
下列新事件可協助追蹤、除錯和自訂與 at.js 的互動:
如需詳細資訊,請參閱 at.js 自訂事件。
您可以使用來自資料提供者的其他參數來擴大 at.js 要求。資料提供者應新增至 window.targetGlobalSettings
下的 dataProviders key
。
如需詳細資訊,請參閱資料提供者。
at.js 要求現在使用 GET,但是當 URL 大小超過 2048 字元時,它會切換為使用 POST。有一個名為 urlSizeLimit
的新屬性,您可以在必要時增加大小限制。此變更允許 Target 將 at.js 與使用相同技術的 AppMeasurement 結合。
Target 現在會強制使用 mbox
函數中的 adobe.target.applyOffer(options)
機碼。此機碼在過去為必要,但現在 Target 會強制使用它,以確保 Target 有正確的驗證,且客戶能正確使用函數。
at.js 已改善事件和點擊追蹤功能。at.js 使用 navigator.sendBeacon()
來傳送事件追蹤資料,並將在不支援 navigator.sendBeacon()
時退回同步 XHR。此次遞補主要影響 Internet Explorer 10 和 11 與一些版本的 Safari。Safari 將在近期的 iOS 11.3 版本中新增對 navigator.sendBeacon()
的支援。
at.js 現在可以呈現選件,即便頁面是在背景索引標籤中開啟亦然。部分 Target 客戶會在 requestAnimationFrame()
因背景標籤的瀏覽器節流行為而停用時遭遇問題。
此版本新增了許多效能改善,包括檢查 Chrome CPU 設定檔時較短的呼叫堆疊。
at.js 1.3.0 不再支援 Microsoft Internet Explorer 9 上的內容傳送如需詳細資訊,請參閱支援的瀏覽器。今後,所有要求會透過 XMLHttpRequest
執行,具有 CORS 支援而不沒有 JSONP 要求。此變更大幅改善安全性。
at.js 版本 1.2.3 現在已可用。
at.js 版本 1.2.2 現在已可用。
getOffer() params
傳回空白字串時,造成 targetPageParams()
失敗的問題。(TNT-28359)at.js 版本 1.2.1 現已可用。
at.js 版本 1.2 現在以包括多數錯誤修正的維護版本形式提供。
target="_blank"
的連結上點擊追蹤時,會阻止 Target 在新索引標籤中開啟連結的問題。(TNT-28072)sdidParamExpiry
已正確初始化,並傳遞至訪客 API。這是已新增至 at.js 1.1.0
的迴歸。先前的 at.js 版本不受影響。這只會影響使用重新導向選件和 A4T 的用戶端。(TNT-27791)SCRIPT
,而無論使用的類型屬性為何。(TNT-27865)日期: 2017 年 8 月 2 日
at.js 版本 1.1 中包括下列增強功能和修正:
document.currentScript polyfill
不會干預 Angular 1.X。at-element-click-tracking
CSS 類別標記,而非 at-element-marker
。日期: 2017 年 7 月 7 日
at.js 版本 1.0 中包括下列增強功能和修正:
getOffer()
函數在部分網站上發生錯誤的修正。日期: 2017 年 5 月 22 日
at.js 版本 0.9.7 中包括下列增強功能和修正:
insertAfter
和 insertBefore
動作遺漏資產金鑰相關的問題。這些問題與從視覺選件移轉至選件範本有關。日期: 2017 年 4 月 13 日
at.js 版本 0.9.6 中包括下列增強功能和修正:
重新導向選件支援 A4T。下載和安裝 at.js 版本 0.9.6 之後,您可以在使用 Adobe Analytics 做為 Target (A4T) 報表來源的活動中使用重新導向選件。除了 at.js 版本 0.9.6,還有您的實作必須符合以便使用重新導向選件和 A4T 的其他基本需求。如需詳細資訊和須知的其他重要資訊,請參閱重新導向選件 - A4T 常見問題集。
在 at.js 0.9.6 之前,當頁面上存在訪客 API,並且 visitorApiTimeout
設定太積極時, 可能會遇到 TargetTarget 要求中未傳送任何 MCID 資料的情況。這可能在使用 A4T 時導致 Analytics 中的問題,例如散亂的點擊。
在 at.js 0.9.6 中此行為已變更,即便 visitorApiTimeout
設為假設 1 毫秒,Target 將嘗試收集 SDID、追蹤伺服器和客戶 ID 資料,並在 Target 要求中傳送那些資料。
已新增 selectorsPollingTimeout
設定。如需詳細資訊,請參閱 targetGlobalSettings()。
來自 getOffer()
() 的回應格式已變更。如需詳細資訊,請參閱 adobe.target.getOffer(options)。
已針對不支援的 <!DOCTYPE>
宣告新增主控台記錄。
已修正在將多個預設選件傳遞至單一 mbox 時,Target Classic 外掛程式未正確套用的問題。(TGT-22664)
改善兩個字母上層網域 (TLD) 的 Cookie 設定,以確保為這些網域 (例如 autodrives.ca、test.no,以此類推) 正確設定 mbox Cookie。
用於擷取儲存 Cookie 時應該使用的上層網域的演算法在 at.js 版本 0.9.6 中已變更。因為此變更,無法將 Cookie 儲存至使用 IP 的位址。大部分時候,IP 位址是用於測試用途,但做為解決辦法,您可以使用 DNS 項目或調整本機機器上的主機檔案。
已修正當屬性為字串值而非整數時移動和重新排列動作的處理。
日期: 2017 年 1 月 19 日
mbox 名稱現在可以包含特殊字元,包括 & 符號,以與使用 mbox.js 的 mbox 名稱命名需求一致。
如需允許的特殊字元的清單,請參閱 at.js 設定。
已新增 secureOnly
設定,指出 at.js 是否應該僅使用 HTTPS 或根據頁面通訊協定,允許在 HTTP 與 HTTPS 之間切換。這是進階的設定,預設值為 False 並且可透過 targetGlobalSettings
覆寫。
「舊版瀏覽器支援」選項可在 at.js 版本 0.9.3 和更早版本中取得。此選項已在 at.js 版本 0.9.4 中移除。
日期: 2016 年 10 月 10 日
日期: 2016 年 9 月 21 日
optoutEnabled
設定,以啟用或停用裝置圖表選擇退出。如果此設定設為 true
,並且訪客選擇退出追蹤,訪客的瀏覽器將不會進行任何 mbox 呼叫。裝置圖表目前處於 Beta 版。此設定預設會設為 false
,但如果您使用裝置圖表,則必須設為 true
。類似的選項屬於 mbox.js v61。CustomEvent
支援。之前,您無法透過標準 DOM API (例如 document.addEventListener()
) ()) 來使用 at.js 事件通知機制。現在您可以使用 document.addEventListener()
來訂閱 at.js 事件,例如要求事件和內容呈現事件。日期: 2016 年 7 月 14 日
Target 版本: 16.6.1
日期: 2016 年 6 月 23 日
修正使用 VEC 選件時白色畫面的問題。使用 at.js 的任何人應該升級至這個新版本。
新 registerExtension
API。
這個新 API 可讓開發人員存取 at.js 中使用的某些 jQuery 模組,以為資料庫開發擴充功能 (亦稱為外掛程式)。此變更有一些隱含意義。這只會影響使用這些功能的使用者:
getSettings()
API 已移除,但使用 registerExtension()
可發揮相同的功能。
getTracking()
API 已移除,但使用 registerExtension()
可發揮相同的功能。
必須更新現有的擴充功能 (例如 AngularJS 擴充功能),才能使用 registerExtension()
方法。
新增at.js通知API。
此通知系統的目標是要對 at.js 正在頁面上執行的動作以及發生問題時提供更多深入分析。VEC 的常見問題是 IT 發行變更了頁面、VEC 選擇器中斷,以及測試停止正確傳送內容。此通知系統的一個目標是要讓頁面知道此傳送的問題,讓開發人員可以存取此資訊,將資訊傳遞至 Adobe Analytics 之類的系統,並且可將警示傳送至業務擁有者,通知其測試中斷的訊息。
新 targetGlobalSettings()
API 方法。
您可以覆寫 at.js 資料庫中的設定,而非在 Target Standard/Premium UI 中或使用 REST API 進行設定。
日期: 2016 年 5 月 5 日
這是 at.js 資料庫的第一個官方發行。
at.js 是新的 Target 實施程式庫,專為典型 Web 實施和單頁應用程式而設計。
針對 Adobe Target 實作以 at.js 取代 mbox.js。
雖然 at.js 已取代 mbox.js,但我們將持續支援 mbox.js。對於大多數人來說,at.js 的優點多於 mbox.js。因為您有時間可以測試 at.js,也能變更頁面上的實作。
除了眾多優點以外,at.js 還能改進 Web 實施的頁面載入時間、改進安全性,以及為單頁應用程式提供更好的實施選項。
at.js 包含 target.js 所附元件,因此不再需要呼叫 target.js。
實施 at.js 時,請注意以下事項: