常見問答

本指南提供經常詢問關於Adobe Experience Platform Web SDK問題的回答。

什麼是Adobe Experience Platform Web SDK?

Adobe Experience Platform Web SDK是使用者端的JavaScript資料庫,可讓您與Adobe Experience Cloud中的各種服務互動。

Web SDK會以與解決方案無關的方式(XDM)傳送資料至Experience PlatformEdge Network,接著將資料對應至解決方案特定的格式和目的地,並即時傳送。

請觀看以下影片,瞭解有關Web SDK的詳細資訊: 再次使用Alloy.js和永不標籤eVar或Mbox.

Adobe Experience Platform Web SDK和先前的解決方案有何不同?

Experience PlatformWeb SDK之前

目前,您必須根據各個解決方案來部署不同的JavaScript程式庫。

  • 每個解決方案都有自己的JavaScript程式庫、結構描述和網域。
  • 這些程式庫都不是為了彼此搭配使用而建置的。
  • 跨解決方案和Adobe Experience Platform使用案例需要這些不同的程式庫相互依存,導致部署上的摩擦。

雖然Platform中的標籤可讓您儘可能輕鬆部署及管理這些程式庫,但下列專案仍有問題:

  • 程式庫大小(頁面上的Adobe程式碼過多)
  • 效能(網站載入時間太長)
  • 單一使用案例的多次呼叫
  • 在個人化呼叫之前等候ECID傳回(導致延遲)
  • 分離式資料收集(什麼是evar?)
  • 解決方案(A4T)之間的結構描述混淆
  • 許多其他不太理想的事物

此外,目前沒有直接將資料傳送至Adobe Experience Platform的JavaScript資料庫。

使用Experience Platform Web SDK

新的Web SDK會將下列解決方案的資料傳送至單一目的地(Experience PlatformEdge Network),並解決上述最常見的解決方案使用案例。

  • Adobe Analytics
  • Adobe Audience Manager
  • Adobe Target
  • 訪客 ID
  • Adobe Experience Platform

其他解決方案亦將陸續推出。

Adobe Experience Platform Web SDK也可以直接傳送資料給Adobe Experience Platform。 此資料為XDM格式,並對應至伺服器端解決方案架構。

這個新Web SDK有何價值?

效能: Web SDK的體積比使用所有目前Adobe程式庫還小,而且頁面載入速度也快很多。

簡單性: XDM、Web SDK、標籤、Edge Network、Adobe Experience Cloud解決方案和Adobe Experience Platform的組合可建立簡單易懂且易於遵循的資料收集故事。

  • XDM: 用來將資料傳送至Adobe的解決方案無關結構描述。 不再為evar或mbox加上標籤。
  • Web SDK: 讓傳送和接收資料給Adobe Experience Platform Edge Network更容易。
  • 標籤: 簡化網站上Web SDK (以及任何其他JavaScript標籤)的部署和設定。
  • 邊緣網路: 以所需的格式輕鬆將資料路由至Adobe Experience Platform和解決方案。
  • Adobe Experience Platform和Adobe解決方案: 啟用他們的價值主張。

控制: 由於所有資料都使用單一且連線的資料流,因此您可以在邏輯上追蹤並控制資料在其往返應用程式的歷程中每一毫秒的外觀。

現代,為未來做好準備: Web 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 Digital Experience客戶都可以免費使用Adobe Experience Platform Web SDK。 希望使用 Web SDK 將需要設定適當的許可權,才能在資料收集UI或Experience Platform UI中建立結構描述、資料集、身分名稱空間和資料串流。

如需設定這些許可權的詳細資訊,請參閱我們的以下檔案: 資料彙集許可權管理.

哪些人應該使用Web 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。

如何存取Web SDK?

Web SDK目前可供一般公眾使用,並可用來將資料傳送至Adobe Experience Cloud產品。 近期即將推出傳送資料給協力廠商解決方案的功能。

SDK免費,並由Adobe免費託管。 如有需要,您可以免費下載並在您自己的伺服器上託管。

Web SDK需要下列存取權: 資料流設定 和Experience Platform XDM結構描述產生器,以便Adobe的伺服器可正確處理來自SDK的傳入資料。 如果您想要取得存取權,請聯絡您的Adobe客戶團隊,以開始請求流程。

Web SDK目前支援哪些使用案例?

Web SDK正在迅速發展。 正在處理更多使用案例。 您可找到 此處列出目前支援的使用案例。

目前的客戶必須重新標籤其網站嗎?

視情況而定。Adobe Experience Platform Web SDK可部署為兩種不同的樣式。 未來的移轉檔案將提供更多詳細資訊。

  • 只是另一個標籤: 如果網站已標籤為使用解決方案,且您無法重新標籤,但您想將資料傳送至Adobe Experience PlatformEdge 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提供身分移轉功能。 請依照以下說明進行ID移轉: Platform Web SDK身分檔案 以取得更多詳細資料。

Web SDK與標籤有何不同?

  • Experience Platform中的標籤 管理裝置程式碼。 使用這些變數可更輕鬆部署程式碼。 它們是自由且強大的。

  • Adobe Experience Platform Web SDK 是標籤將針對Adobe使用案例部署的新程式碼的正式名稱。 此外,它也是免費且功能強大。

  • alloy.js 是Adobe Experience Platform Web SDK程式碼的檔案名稱。

我是否必須使用標籤才能部署Web SDK?

不可以。 您可以下載 alloy.js 自行檔案。

但是:

  • Adobe Experience Platform Web SDK需要資料流ID,邊緣網路才能識別資料流,並決定如何處理資料。 此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?

是,根據您的實作,目前Web SDK會使用1到7個Cookie的任一處。 以下是您在Web SDK中可能會看到的Cookie清單,及其使用方式:

名稱
maxAge
友善年齡
說明
kndct_orgid_identity
34128000
395 天
身分Cookie會儲存ECID以及與ECID相關的其他資訊。
kndctr_orgid_consent_check
7200
2 小時
此工作階段型Cookie會傳送訊號給伺服器,讓伺服器查詢同意偏好設定伺服器端。
kndctr_orgid_consent
15552000
180 天
此Cookie會儲存使用者對網站的同意偏好設定。
kndctr_orgid_cluster
1800
30 分鐘
此Cookie會儲存為目前使用者的請求提供服務的Edge Network區域。 URL路徑會使用地區,這樣Edge Network就能將請求路由至正確的地區。 此Cookie具有30分鐘的存留期,因此如果使用者以不同的IP位址連線,則請求可以路由傳送到最接近的區域。
mbox
63072000
2 年
當Target移轉設定設為true時,就會顯示此Cookie。 這將允許Target mbox Cookie 將由Web SDK設定。
mboxEdgeCluster
1800
30 分鐘
當Target移轉設定設為true時,就會顯示此Cookie。 此Cookie可讓Web SDK將正確的邊緣叢集通訊至at.js,以便當使用者在網站上導覽時,Target設定檔可以保持同步。
AMCV_###@AdobeOrg
34128000
395 天
只有在Adobe Experience Platform Web SDK上啟用ID移轉功能時,此Cookie才會出現。 在網站的某些部分仍在使用visitor.js時,此Cookie有助於轉換至Web SDK。 另請參閱 idMigrationEnabled 以取得詳細資訊。

使用Web SDK時,Edge Network會設定上述一個或多個Cookie。 Edge Network會使用設定所有Cookie securesameSite="none" 屬性。

如果您的網站上目前同時有安全和非安全區段,這可能會干擾使用者識別。 當使用者從網站的安全區段導覽到不安全的區段時,Edge Network會產生新的 ECID 透過要求。

Adobe Experience Platform Web SDK支援哪些瀏覽器?

Adobe Experience Platform Web SDK的設計可在最新版Google Chrome、Safari、Firefox、Internet Explorer 11和Microsoft Edge Chromium中以最佳方式運作。 在舊版的瀏覽器上使用某些功能時,可能會發生問題。

我可以在哪裡取得有關Adobe Experience Platform Web SDK的詳細資訊?

支援Internet Explorer support-internet-explore

此SDK使用promise ,這是通訊非同步工作完成的方法。 此 Promise SDK使用的實作原生受到所有目標瀏覽器的支援,但 Internet Explorer. 若要在上使用SDK Internet Explorer,您必須擁有 window.Promise 多邊形.

若要確定您是否已 window.Promise polyfilled:

  1. 在中開啟您的網站 Internet Explorer.
  2. 開啟瀏覽器的偵錯主控台。
  3. 型別 window.Promise 進入主控台,然後按Enter。

如果是 undefined 出現,表示您可能已經填滿 window.Promise. 另一種判斷是否需要 window.Promise 是在完成上述安裝指示後,載入您的網站以進行polyfilled。 如果SDK擲回錯誤,提及Promise相關內容,表示您可能沒有填滿 window.Promise.

如果您已決定您必須進行多邊形填充 window.Promise,請在先前提供的基底程式碼上方加入下列指令碼標籤:

<script src="https://cdn.jsdelivr.net/npm/promise-polyfill@8/dist/polyfill.min.js"></script>

此標籤會載入指令碼,確保 window.Promise 是有效的Promise實作。

NOTE
如果您選擇載入不同的Promise實作,請確定它支援 Promise.prototype.finally.

支援Internet Explorer

Adobe Experience Platform SDK使用promise ,這是通訊非同步工作完成的方法。 此 Promise SDK使用的實作原生受到所有目標瀏覽器的支援,但 Internet Explorer. 若要在上使用SDK Internet Explorer,您必須擁有 window.Promise 多邊形.

有一個可用來聚合填滿Promise的資料庫是Promise-Polyfill。 請參閱 promise-polyfill檔案 以取得有關如何使用NPM安裝的詳細資訊。

NOTE
如果您選擇載入不同的Promise實作,請確定它支援 Promise.prototype.finally.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636