文件Experience Platform將Target從at.js 2.x移轉至Web SDK

at.js與Platform Web SDK的比較

Last update: Thu Oct 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 中繼
  • 經驗豐富
  • 開發人員

獨立Adobe Target at.js程式庫與Platform Web SDK有顯著不同。 下表為參考資料，可協助您評估在移轉程式期間可能需要著重的實作領域。

檢閱下列資訊並評估您目前的技術at.js實作後，您應該能夠瞭解下列內容：

  • Platform Web SDK支援哪些目標功能
  • 哪些at.js函式有同等的Platform Web SDK
  • 如何套用Target設定與Platform Web SDK
  • at.js和Platform Web SDK的資料流程有何不同

如果您是初次使用Platform Web SDK，別擔心，本教學課程將更詳細地介紹以下專案。

功能比較

Target at.js 2.x
Platform Web SDK
更新Target設定檔
支援
支援
觸發SPA的檢視
支援
支援
鎖定Recommendations
支援
支援
擷取表單式選件
支援
支援
追蹤事件
支援
支援
A4T：單頁應用程式
支援
支援
A4T：點選追蹤
支援
支援
A4T：使用者端記錄
支援
支援
A4T：伺服器端記錄
支援
支援
套用優惠方案
支援
支援
在SPA中重新呈現檢視，而不另行通知
支援
支援
混合式應用程式
支援
支援
QA URL
支援
支援
Mbox第三方ID
支援
支援
客戶屬性
支援
支援
遠端選件
支援
支援
重新導向選件
支援
支援。 不過，不支援從具有Platform Web SDK的頁面重新導向至具有at.js的頁面（且方向相反）。
裝置上決策
支援
目前不支援
預先擷取Mbox
支援自訂範圍和SPA VEC
預先擷取是Web SDK的預設模式
自訂事件
支援
不支援。 檢視公開藍圖目前的狀態。
回應Token
支援
支援。 如需at.js和Platform Web SDK之間的程式碼範例和差異，請參閱專屬的回應Token檔案
資料提供者
支援
不支援。 自訂程式碼可在從其他提供者擷取資料後，用來觸發Platform Web SDK sendEvent命令。

值得注意的圖說文字

Target at.js 2.x
Platform Web SDK
減少忽隱忽現情形
非同步實施的預先隱藏程式碼片段使用樣式ID at-body-style。 at.js會在收到回應後尋找此元素ID以移除樣式。
預設預先隱藏程式碼片段使用alloy-prehiding的樣式識別碼。 Web SDK與at.js預先隱藏程式碼片段不相容，因此必須在移轉程式期間加以變更。
頁面載入時自動轉譯內容
使用Target全域設定控制。 當pageLoadEnabled設定為true時啟用。
已在Platform Web SDK sendEvent命令中指定。 將renderDecisions選項設定為true以啟用。
手動呈現內容
applyOffer()和applyOffers()函式僅支援設定HTML
applyPropositions命令支援設定、取代或附加HTML以增加彈性
追蹤自訂事件
支援trackEvent()和sendNotifications()函式。 這些函式專用於Target，不會影響Adobe Analytics量度。
Platform Web SDK sendEvent呼叫的所有資料都會轉送到Target。 Target特別需要的補充資料應包含在具有decisioning.propositionDisplay或decisioning.propositionInteracteventType的sendEvent命令中，以確保Adobe Analytics量度不受影響。
目標CNAME
支援。 這與用於Analytics和Experience CloudID服務的CNAME不同。
不再相關。 單一CNAME可用於所有Platform Web SDK呼叫。
偵錯
mboxDisable、mboxDebug和mboxTrace URL引數可用來使用瀏覽器的開發人員工具進行偵錯。

此Adobe Experience Platform Debugger也是支援的偵錯工具。
不支援mboxDisable、mboxDebug和mboxTrace URL引數。

您可以將alloy_debug=true新增至查詢字串或在開發人員主控台中執行alloy("setDebug", { "enabled": true });，以開啟Web SDK偵錯。

Adobe Experience Platform Debugger瀏覽器延伸功能可用來啟動邊緣追蹤以進行偵錯。

如需詳細資訊，請參閱偵錯Platform Web SDK檔案。
Analytics for Target (A4T)
使用SDID值來拼接Target和Analytics呼叫
原生支援，無需拼接
NOTE
不支援將Target移轉至Platform Web SDK，同時保留指定頁面的現有AppMeasurementAdobe Analytics實施。
您可將您的at.js (和AppMeasurement.js)實作一次移轉一頁至Platform Web SDK。 如果您採取這個方法，最好使用configure命令將idMigrationEnabled和targetMigrationEnabled選項設定為true。

at.js函式和平台Web SDK的對等專案

許多at.js函式都有使用Platform Web SDK的同等方法，如下表所述。 如需at.js函式的詳細資訊，請參閱Adobe Target開發人員指南。

at.js 2.x函式
Platform Web SDK對等函式
getOffer() 和 getOffers()
若要要求並自動轉譯目標的VEC型體驗，請使用sendEvent命令並將renderDecisions選項設定為true。

若要要求表單式體驗或手動轉譯內容，請使用sendEvent命令指定decisionScopes (mbox)的陣列。
applyOffer() 和 applyOffers()
使用applyPropositions命令套用內容。 您可以選擇設定、取代HTML或將其附加至特定選取器。
triggerView()
如果web.webPageDetails.viewName屬性設定在sendEvent命令的xdm選項下，則Platform Web SDK會自動觸發針對SPA VEC的檢視變更。
trackEvent() 和 sendNotifications()
使用包含特定eventType集合的sendEvent命令：

decisioning.propositionDisplay代表活動的轉譯

decisioning.propositionInteract代表使用者與活動的互動，例如滑鼠點按。
targetGlobalSettings()
沒有直接的對等方法。 如需其他詳細資訊，請參閱目標設定比較。
targetPageParams() 和 targetPageParamsAll()
在sendEvent命令的xdm選項中傳遞的所有資料都會對應至Target mbox引數。 由於mbox引數是以序列化的點標籤法來命名，若移轉至Platform Web SDK，您可能需要更新現有的對象和活動，才能使用新的mbox引數名稱。

作為sendEvent命令的data.__adobe.target的一部分傳遞的資料對應到目標設定檔和Recommendations特定引數。
at.js自訂事件
不支援。 檢視公開藍圖目前的狀態。 回應Token在sendEvent呼叫的回應中公開為propositions的一部分。

at.js設定和平台Web SDK的對等專案

at.js程式庫可使用Target UI中的各種設定進行設定和下載。 也可以使用targetGlobalSettings()函式更新這些設定。 下表將這些設定與Platform Web SDK提供的設定進行比較。

at.js設定
Platform Web SDK對等函式
bodyHiddenStyle
使用configure命令設定prehidingStyle
bodyHidingEnabled
如果使用configure命令定義prehidingStyle，則會啟用此功能。 如果未定義樣式，則Platform Web SDK不會嘗試隱藏任何內容。
clientCode
自動設定
cookieDomain
不適用
crossDomain
使用configure命令將thirdPartyCookiesEnabled選項設為true，以啟用跨網域使用案例的第一方和第三方Cookie
cspScriptNonce 和 cspStyleNonce
請參閱設定CSP的檔案
dataProviders
不支援
decisioningMethod
所有Platform Web SDK sendEvent命令都使用伺服器端決策。 不支援混合式決策和裝置上決策。
defaultContentHiddenStyle 和 defaultContentVisibleStyle
僅適用於at.js 1.x。與at.js 2.x類似，使用自訂程式碼即可緩解表單式體驗的忽隱忽現問題。
deviceIdLifetime
不支援。 如果使用configure命令將targetMigrationEnabled設為true，則會將mbox Cookie設定為裝置存留期設為2年。 此值無法設定。
enabled
資料流設定可啟用或停用Target功能
globalMboxAutoCreate
使用sendEvent命令將renderDecisions選項設為true，以自動擷取及轉譯VEC型體驗。如果您偏好手動轉譯VEC型體驗，請

要求__view__的decisionScope。
imsOrgId
使用configure命令設定orgId
optinEnabled 和 optoutEnabled
請參閱Platform Web SDK 隱私權選項。 defaultConsent選項適用於Platform Web SDK支援的所有Adobe解決方案。
overrideMboxEdgeServer 和 overrideMboxEdgeServerTimeout
不適用。 所有Platform Web SDK請求都使用Adobe Experience Platform Edge網路。
pageLoadEnabled
使用sendEvent命令將renderDecisions選項設為true
secureOnly
不支援。 Platform Web SDK會設定具有secure和sameSite="none"屬性的所有Cookie。
selectorsPollingTimeout
不支援。 Platform Web SDK使用5秒的值。 如有必要，可以使用自訂程式碼來手動轉譯內容。
serverDomain
將edgeDomain設定與configure命令搭配使用
telemetryEnabled
不適用
timeout
不支援。 建議您將任何忽隱忽現的緩解程式碼都納入適當的逾時。
viewsEnabled
不支援。 若renderDecisions設為true或請求中包含__view__ decisionScope，則一律會在第一個sendEvent()呼叫上擷取Target檢視的內容。
visitorApiTimeout
不適用

系統圖表比較

下列圖表應可協助您瞭解使用at.js的Target實作與使用Platform Web SDK的實作之間的資料流程差異。

at.js 2.x系統圖表

at.js 2.0在頁面載入時的行為 {modal="regular"}

呼叫
詳細資料
1
呼叫會傳回Experience CloudID (ECID)。 如果使用者已通過驗證，則另一個呼叫會同步客戶ID。
2
at.js程式庫會同步載入並隱藏檔案本文（也可使用將頁面上實作的程式碼片段預先隱藏的選項，以非同步方式載入at.js）。
3
提出頁面載入請求，包含所有已設定的引數、ECID、SDID和客戶ID。
4
個人資料指令碼執行並注入個人資料存放區。 存放區會從受眾資料庫中要求合格受眾(例如從Analytics、Audience Manager等共用的受眾)。 客戶屬性會透過批次程式傳送至設定檔存放區。
5
Target會根據URL、請求引數和設定檔資料，決定可針對目前頁面和未來檢視傳回哪些活動和體驗給訪客。
6
目標內容會傳回至頁面，選擇性地包括其他個人化的設定檔值。

目前頁面上的目標內容會儘快出現，不會有忽隱忽現的預設內容。

單一頁面應用程式未來檢視的目標內容會快取在瀏覽器中，因此當檢視觸發時，可以立即套用，而不需要額外的伺服器呼叫。
7
從頁面傳送至資料收集伺服器的Analytics資料。
8
Target資料會透過SDID來比對Analytics資料，然後經過處理放入Analytics報表儲存體中。 然後就可以在Analytics與Target中，透過A4T報表來檢視Analytics資料。

請參閱開發人員指南，以取得如何針對單頁應用程式使用at.js實作Target的詳細資訊。

Platform Web SDK系統圖表

使用Platform Web SDK的Adobe Target Edge Decisioning圖表

呼叫
詳細資料
1
裝置載入Platform Web SDK。 Platform Web SDK會傳送要求至Edge Network，其中包含XDM資料、資料串流環境ID、傳入引數和客戶ID （選用）。 頁面（或容器）會預先隱藏。
2
Edge Network會傳送要求給Edge Services，以使用訪客ID、同意和其他訪客內容資訊（例如地理位置和方便使用的裝置名稱）來擴充要求。
3
邊緣網路會使用訪客ID和傳入的引數將擴充的個人化請求傳送至Target邊緣。
4
設定檔指令碼執行，然後注入到Target設定檔儲存空間。 設定檔儲存空間會從對象庫擷取區段(例如從Adobe Analytics、Adobe Audience Manager、Adobe Experience Platform共用的區段)。
5
Target會根據URL要求引數和設定檔資料，決定要針對目前頁面檢視和未來預先擷取檢視顯示的訪客活動和體驗。 然後Target會將此傳送回邊緣網路。
6
a. Edge網路會將個人化回應傳送回頁面，選擇性地包括其他個人化的設定檔值。 目前頁面上的個人化內容會儘快出現，不會有忽隱忽現的預設內容。

b。作為使用者在單頁應用程式(SPA)中的動作結果而顯示的檢視個人化內容，會快取以供立即呈現，而不需要額外的伺服器呼叫。

c。邊緣網路會傳送訪客ID和Cookie中的其他值（例如同意、工作階段ID、身分、Cookie檢查、個人化等）。
7
邊緣網路將Analytics for Target (A4T)詳細資料（活動、體驗和轉換中繼資料）轉送給Analytics邊緣。

請參閱開發人員指南，以取得如何使用適用於單頁應用程式的Platform Web SDK實作Target的詳細資訊。

在您對目前的Target實作和您使用的功能有良好的技術瞭解後，下一步就是執行初始設定。

NOTE
我們致力協助您成功將Target從at.js移轉至Web SDK。 如果您在移轉時遇到問題，或覺得本指南中缺少重要資訊，請在此社群討論中張貼以告知我們。
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110