[Alpha]{class="badge informative"}

與Web SDK的差異

伺服器SDK和Web SDK共用相同的核心,因此會以相同的格式傳送資料給相同的資料串流,並使用相同的Cookie。 因為一個檔案是在伺服器上執行,另一個檔案是在瀏覽器上執行,所以它們有幾種不同的方式。 使用此頁面來計畫移轉,或在瀏覽器和伺服器實作之間共用程式碼。

比較 comparison

區域圖
Web SDK
伺服器SDK
執行位置
訪客的瀏覽器
您的伺服器,位於Node.js或其他伺服器端JavaScript執行階段。 請參閱執行階段支援。
安裝
標籤延伸模組、JavaScript程式庫或@adobe/alloy npm套件
@adobe/alloy-node npm套件。 請參閱安裝。
如何稱呼它
alloy("sendEvent", { ... })
alloy.sendEvent({ ... }). 請參閱方法總覽。
執行個體
每個頁面載入一次,服務一位訪客
每個處理程式一個,加上每個訪客請求的forRequest控制代碼
Authentication
無
必填。 事件會前往已驗證的Edge Network伺服器API。 請參閱驗證。
身分識別
自動讀取及寫入瀏覽器Cookie
閱讀並寫入您提供的Cookie服務。 每個事件都需要主要身分。
同意
defaultConsent接受"in"、"out"和"pending"
defaultConsent只接受"in"和"out"
個人化
請求、呈現和追蹤主張的顯示
要求主張並傳回主張。 不會轉譯或追蹤其顯示。
上下文資料
瀏覽器的頁面、裝置、環境、地標和使用者端提示詳細資訊
實作詳細資料、訪客轉送的請求標頭,以及來自Referer標頭的頁面URL。 請參閱內容與轉送的標頭。
sendEvent個結果
propositions、inferences和destinations
propositions
除錯
debugEnabled、setDebug、alloy_debug查詢字串引數和Adobe Experience Platform Debugger
debugEnabled和setDebug,訊息已寫入主控台
監視鉤點
monitors選項和__alloyMonitors全域變數
createInstance的monitors選項

方法 methods

伺服器SDK新增forRequest方法,該方法不存在於Web SDK中。

它支援下列Web SDK命令做為方法: appendIdentityToUrl、applyResponse、configure、getIdentity、getLibraryInfo、sendEvent、setConsent和setDebug。

下列Web SDK命令無法使用,因為這些命令相依於瀏覽器或「伺服器SDK」未包含的元件:

  • applyPropositions
  • createMediaSession
  • getMediaAnalyticsTracker
  • sendMediaEvent
  • sendPushSubscription
  • subscribeRulesetItems

設定選項 configuration

sendEvent選項 sendevent

常見問題 faq

我可以在相同網站上使用伺服器SDK和Web SDK嗎? same-site

有。 常見的模式是在伺服器上要求個人化,並在瀏覽器中呈現。 請參閱混合式個人化。 如果資料流的​ 存取型別 ​是​混合驗證,則兩個資料庫都可以傳送資料至相同的資料流。 兩者使用相同的Cookie名稱來表示身分和同意。

為何每個事件都需要主要身分? primary-identity

伺服器SDK會將事件傳送至已驗證的Edge Network伺服器API。 由於請求來自您的伺服器,Edge Network無法使用訪客的瀏覽器Cookie來識別他們。 而是需要事件中的主要身分。 請參閱xdm。

我可以在無伺服器功能中使用伺服器SDK嗎? serverless

是,如果函式的執行階段符合需求。 在函式處理常式之外,於模組的頂層建立及設定執行個體。 如此一來,熱啟動會重複使用已設定的執行個體及其快取的存取權杖。 在每次呼叫的處理常式中呼叫forRequest。

我可以使用Adobe Experience Platform Debugger嗎? debugger

沒有。 Adobe Experience Platform Debugger是瀏覽器擴充功能,可檢查頁面。 若要偵錯伺服器SDK,請將debugEnabled設定為true或呼叫setDebug,並檢閱伺服器的主控台輸出。

recommendation-more-help
experience-platform-help-collection