常見問題
本指南提供經常詢問關於Adobe Experience Platform Web SDK問題的回答。
什麼是Adobe Experience Platform Web SDK？
Adobe Experience Platform Web SDK是使用者端的JavaScript資料庫，可讓您與Adobe Experience Cloud中的各種服務互動。
網頁SDK會以與解決方案無關的方式(XDM)傳送資料至Experience Platform Edge Network，接著將資料對應至解決方案特定的格式和目的地，並即時傳送。
請參閱下列影片以取得有關網頁SDK的詳細資訊： Meet Alloy.js and Never Tag for an eVar or Mbox Agree。
Adobe Experience Platform Web SDK與先前的解決方案有何不同？
Experience Platform Web SDK之前
目前，您必須根據各個解決方案來部署不同的JavaScript程式庫。
- 每個解決方案都有自己的JavaScript資料庫、結構描述和網域。
- 這些程式庫都不是為了彼此搭配使用而建置的。
- 跨解決方案和Adobe Experience Platform使用案例需要這些不同的程式庫相互依存，導致部署上的摩擦。
雖然Experience Platform中的標籤可讓您儘可能輕鬆部署及管理這些程式庫，但下列專案仍有問題：
- 程式庫大小(頁面上的Adobe程式碼過多)
- 效能（網站載入時間太長）
- 單一使用案例的多次呼叫
- 在個人化呼叫之前等候ECID傳回（導致延遲）
- 分離式資料收集（什麼是evar？）
- 解決方案(A4T)之間的結構描述混淆
- 許多其他不太理想的事物
此外，目前沒有直接將資料傳送至Adobe Experience Platform的JavaScript資料庫。
使用Experience Platform Web SDK
新的網頁SDK可將下列解決方案的資料傳送到單一目的地(Experience Platform Edge Network)，並解決上述最常見的解決方案使用案例。
- Adobe Analytics
- Adobe Audience Manager
- Adobe Target
- 訪客 ID
- Adobe Experience Platform
其他解決方案亦將陸續推出。
Adobe Experience Platform Web SDK也可以直接將資料傳送至Adobe Experience Platform。 此資料為XDM格式，並對應至伺服器端解決方案架構。
這個全新的網頁SDK有何價值？
效能： 網頁SDK比使用所有目前的Adobe資料庫還小，而且頁面載入速度更快。
簡單性： XDM、Web SDK、標籤、Edge Network、Adobe Experience Cloud解決方案和Adobe Experience Platform的組合可建立容易理解且易於遵循的資料收集故事。
- XDM： 您用來傳送資料給Adobe的解決方案無關結構描述。 不再為evar或mbox加上標籤。
- 網頁SDK： 可讓您輕鬆傳送及接收資料至Adobe Experience Platform Edge Network。
- 標籤： 簡化網站Web SDK (以及任何其他JavaScript標籤)的部署和設定。
- Edge Network： 以資料所需的格式，輕鬆將資料路由至Adobe Experience Platform和解決方案。
- Adobe Experience Platform和Adobe解決方案： 啟用其價值主張。
控制項： 因為所有資料都使用單一且連線的資料流，所以您可以邏輯地追蹤並控制資料在往返應用程式的每毫秒歷程中看起來的樣子。
現代且準備好迎接未來： 網頁SDK及其與Edge Network的連線已讓Adobe大幅更新Adobe處理資料收集、個人化、同意和未來第三方Cookie的方式。 (這會啟用第一方網域，由Adobe管理。)
實現價值時間： Adobe已努力工作（並將繼續），以便透過標籤輕鬆部署Web SDK並將使用者端資料對應至XDM。 完成上述工作後，您就可以在伺服器端開啟或關閉所有其他Adobe解決方案和Adobe Experience Platform服務。 例如，如果您將此用於Adobe Analytics，並且想要開啟Target或Experience Platform，您只需在資料流設定上翻轉切換即可開啟這些使用案例。
什麼是 alloy.js？
alloy.js是Web SDK JavaScript資料庫的名稱。 SDK原始程式碼和檔案名稱會參照此值。
客戶是否需要購買Adobe Experience Platform才能使用Web SDK？
不可以。 任何Adobe數位體驗客戶都可以免費使用Adobe Experience Platform Web SDK。
- 不 可以存取Experience Platform或Real-time CDP並希望使用Web SDK的客戶將需要設定適當的許可權，才能在資料收集UI或Experience Platform UI中建立結構描述和資料串流。
- 有權存取Experience Platform或Real-time CDP並希望使用Web SDK的客戶將需要設定適當的許可權，才能在資料收集UI或Experience Platform UI中建立結構描述、資料集、身分名稱空間和資料串流。
如需設定這些許可權的詳細資訊，請參閱我們關於資料彙集許可權管理的檔案。
哪些人應該使用網路SDK？
Adobe Experience Platform Web SDK是為下列客戶所開發：
-
Adobe Experience Platform使用者
- 如果您需要直接從裝置傳送資料至Adobe Experience Platform，建議您採取此正式方式。
- Adobe瞭解，如果您已有Adobe Analytics，使用Adobe Analytics聯結器會更快一些，但並非資料收集的長期策略。
-
Adobe Experience Cloud解決方案客戶
- Adobe Analytics、Adobe Audience Manager和Adobe Target的新客戶應該從新的Web SDK開始，而不是使用舊版程式庫。
- 現有客戶若想儘可能獲得最佳化的實施，應使用新的Web SDK。
如何存取網頁SDK？
Web SDK目前可供一般公眾使用，並可用來將資料傳送至Adobe Experience Cloud產品。 近期即將推出傳送資料給協力廠商解決方案的功能。
SDK免費，並由Adobe免費代管。 如有需要，您可以免費下載並在您自己的伺服器上託管。
Web SDK需要存取資料流設定和Experience Platform XDM結構描述產生器，以便Adobe的伺服器能夠正確處理來自SDK的傳入資料。 如果您想要取得存取權，請聯絡您的Adobe客戶團隊以開始請求流程。
網頁SDK目前支援哪些使用案例？
網路SDK正快速演化。 正在處理更多使用案例。 您可以在這裡找到目前支援的使用案例清單。
目前的客戶必須重新標籤其網站嗎？
視情況而定。 Adobe Experience Platform Web SDK可部署為兩種不同的樣式。 未來的移轉檔案將提供更多詳細資訊。
-
只有另一個標籤： 如果網站已針對解決方案加上標籤，而您又無法重新加上標籤，但您想要將資料傳送至Adobe Experience Platform Edge Network以供Experience Platform使用案例或即將推出的事件轉送功能（請參閱下文），您可以將
alloy.js標籤新增至網站，其作用就像是「其他標籤」。 -
唯一標籤： 如果您想要將Web SDK用於Experience Cloud解決方案，您必須將其用於該頁面上的 所有 解決方案。 例如，如果您的網站已針對Adobe Analytics進行標籤，而您想要將其用於Target，則您需要將其用於兩者，以及未來的任何其他網站。
換言之，如果您決定將Adobe Experience Platform Web SDK用於非解決方案使用案例，則可以使用alloy.js標籤網站並繼續進行，就像它是一個新的解決方案一樣。 如果您想要將其用於Adobe Analytics、Target、Audience Manager或應用程式使用案例，您可能需要移除頁面上的任何舊版程式碼。
我可以在開始使用Web SDK時移轉ECID，讓我的網站訪客不會開始顯示為新訪客嗎？
是，Adobe Experience Platform Web SDK提供身分移轉功能。 如需詳細資訊，請依照Experience Platform Web SDK身分識別檔案中有關ID移轉的指示操作。
網頁SDK與標籤有何不同？
-
Experience Platform 中的 標籤可管理裝置代碼。 使用這些變數可更輕鬆部署程式碼。 它們是自由且強大的。
-
Adobe Experience Platform Web SDK 是標籤針對Adobe使用案例部署的新程式碼的正式名稱。 此外，它也是免費且功能強大。
-
alloy.js是Adobe Experience Platform Web SDK程式碼的檔案名稱。
我是否必須使用標籤來部署網路SDK？
不可以。 您可以自行下載alloy.js檔案。
但是：
-
Adobe Experience Platform Web SDK需要資料流ID，讓Edge Network可以識別資料流，並決定如何處理資料。 此ID是在Experience Platform中建立。 這並不表示您必須使用UI來建立屬性或部署JavaScript程式碼，但您確實需要使用標籤來建立設定ID。
-
標籤不僅是最佳的可用標籤和SDK管理員，可讓您輕鬆部署
alloy.js並將資料對應至XDM結構描述。 如果您決定不使用標籤，則必須先管理部署alloy.js、事件並將資料對應至XDM，才能進行傳送。 這個 程式比使用標籤要困難得多。 -
建議您使用標籤來部署
alloy.js，即使這是您使用標籤的唯一專案。
什麼是事件轉送？
如果您使用我們的SDK並將XDM傳送至Edge Network，這些新功能事件轉送可讓您安裝新的伺服器端擴充功能，並將資料對應至邊緣網路上的任何專案，並可將其傳送至任何地方。 將其視為「資料收集即服務」。 這將需要付費，並會隨Adobe Experience Platform提供。
什麼是CNAME或第一方網域，這為什麼重要？
有關CNAME的詳細資訊，請參閱Adobe檔案
Adobe Experience Platform Web SDK是否使用Cookie？ 若是如此，會使用哪些Cookie？
可以，根據您的實作，目前網路SDK會使用介於一至七個Cookie之間的任何地方。 以下是您在Web SDK中可能會看到的Cookie清單及其使用方式：
idMigrationEnabled。使用Web SDK時，Edge Network會設定上方的一或多個Cookie。 Edge Network會設定具有secure和sameSite="none"屬性的所有Cookie。
如果您的網站上目前同時有安全和非安全區段，這可能會干擾使用者識別。 當使用者從網站的安全區段導覽到不安全的區段時，Edge Network會使用請求產生新的ECID。
Adobe Experience Platform Web SDK支援哪些瀏覽器？
Adobe Experience Platform Web SDK的設計可在最新版Google Chrome、Safari、Firefox和Microsoft Edge Chromium中以最佳方式運作。 在舊版瀏覽器或已棄用的瀏覽器（例如Internet Explorer）上使用某些功能時，可能會發生問題。