設定Web SDK標籤擴充功能
此 Web SDK 標籤擴充功能會透過Experience PlatformEdge Network,從Web屬性傳送資料至Adobe Experience Cloud。
擴充功能可讓您將資料串流至Platform、同步身分、處理客戶同意訊號,以及自動收集內容資料。
本檔案說明如何在標籤UI中設定標籤擴充功能。
安裝Web SDK標籤擴充功能 install
Web SDK標籤擴充功能需要安裝屬性。 如果您尚未這麼做,請參閱以下檔案: 建立標籤屬性.
建立屬性後,請開啟屬性並選取 擴充功能 標籤。
選取 目錄 標籤。 從可用擴充功能的清單中,找到 Web SDK 擴充功能並選取 安裝.
選取後 安裝,您必須設定Web SDK標籤擴充功能並儲存設定。
設定執行個體設定 general
頁面頂端的設定選項可告知Adobe Experience Platform將資料路由到何處,以及要在伺服器上使用哪些設定。
- 名稱:Adobe Experience Platform Web SDK擴充功能支援頁面上的多個例項。 此名稱可用來透過標籤設定,將資料傳送至多個組織。 執行個體名稱預設為
alloy
. 不過,您可將執行個體名稱變更為任何有效的JavaScript物件名稱。 - IMS組織ID:您要在Adobe傳送資料的組織ID。 大部分時間都會使用自動填入的預設值。 頁面上有多個例項時,請找到您要傳送資料的第二個組織,以該組織的值填入此欄位。
- Edge網域:擴充功能傳送及接收資料的網域。 Adobe建議對此擴充功能使用第一方網域(CNAME)。 預設的第三方網域適用於開發環境,但不適用於生產環境。若需設定第一方 CNAME 的相關說明,請參閱此處。
設定資料流設定 datastreams
此段落可讓您選取三個可用環境(生產、測試和開發)中每一個都應該使用的資料串流。
當請求傳送至Edge Network時,會使用資料串流ID來參考伺服器端設定。 您可以更新設定,而無須在網站上變更程式碼。
請參閱以下指南: 資料串流 以瞭解如何設定資料串流。
您可以從可用的下拉式功能表中選擇資料串流,或選取 輸入值 並輸入每個環境的自訂資料串流ID。
設定隱私權設定 privacy
本節可讓您設定Web SDK如何處理來自您網站的使用者同意訊號。 具體來說,如果沒有提供其他明確的同意偏好設定,這可讓您選取使用者假設的預設同意等級。
預設同意層級不會儲存到使用者設定檔。
設定身分設定 identity
本節可讓您定義Web SDK在處理使用者身分識別時的行為。
-
從VisitorAPI移轉ECID:此選項預設為啟用。 啟用此功能後,SDK可讀取
AMCV
和s_ecid
Cookie並設定AMCV
使用的Cookie Visitor.js. 移轉至Web SDK時,此功能很重要,因為有些頁面可能仍使用 Visitor.js. 此選項可讓SDK繼續使用相同程式碼 ECID 因此不會將使用者識別為兩個不同的使用者。 -
使用第三方Cookie:啟用此選項後,Web SDK會嘗試將使用者識別碼儲存在第三方Cookie中。 如果成功,則會在使用者瀏覽多個網域時將其識別為單一使用者,而不是在每個網域上將其識別為個別使用者。 如果已啟用此選項,如果瀏覽器不支援第三方Cookie或使用者已設定不允許第三方Cookie,SDK仍可能無法將使用者識別碼儲存在第三方Cookie中。 在此情況下,SDK只會將識別碼儲存在第一方網域中。
note important IMPORTANT >協力廠商Cookie與 第一方裝置ID Web SDK的功能。
您可以使用第一方裝置識別碼,或使用第三方Cookie,但無法同時使用這兩項功能。
設定個人化設定 personalization
此區段可讓您設定在載入個人化內容時如何隱藏頁面的某些部分。 這可確保您的訪客只會看到個人化頁面。
- 將Target從at.js移轉至Web SDK:使用此選項來啟用 Web SDK 以讀取及寫入舊版
mbox
和mboxEdgeCluster
at.js使用的Cookie1.x
或2.x
程式庫。 這可協助您在從使用Web SDK的頁面移至使用at.js的頁面時,保留訪客設定檔1.x
或2.x
資料庫或反之。
預先隱藏樣式 prehiding-style
預先隱藏樣式編輯器可讓您定義自訂CSS規則,以隱藏頁面的特定區段。 載入頁面時,Web SDK會使用此樣式來隱藏需要個人化的區段,擷取個人化,然後取消隱藏個人化的頁面區段。 如此一來,您的訪客便能看見已個人化的頁面,而不需看見個人化擷取程式。
預先隱藏程式碼片段 prehiding-snippet
非同步載入Web SDK程式庫時,預先隱藏程式碼片段相當實用。 在此情況下,為避免忽隱忽現的情形,我們建議在載入Web SDK程式庫之前隱藏內容。
若要使用預先隱藏程式碼片段,請複製該程式碼片段,並貼到 <head>
個頁面元素。
設定資料收集設定 data-collection
管理資料收集組態設定。 JavaScript資料庫中的類似設定可使用 configure
命令。
-
在事件傳送回撥前開啟:回呼函式,用於評估及修改傳送至Adobe的裝載。 使用
content
變數來修改裝載。 此回呼的標籤相當於onBeforeEventSend
在JavaScript資料庫中。 -
收集內部連結點按次數:可讓您收集網站或屬性內部連結追蹤資料的核取方塊。 啟用此核取方塊時,會顯示事件分組選項:
- 無事件分組:連結追蹤資料會以個別事件傳送至Adobe。 在個別事件中傳送的連結點選可能會增加傳送至Adobe Experience Platform的資料的合約使用量。
- 使用工作階段存放區進行事件分組:將連結追蹤資料儲存在工作階段存放區中,直到下一頁事件為止。 在以下頁面中,儲存的連結追蹤資料和頁面檢視資料會同時傳送給Adobe。 Adobe建議在追蹤內部連結時啟用此設定。
- 使用本機物件進行事件分組:將連結追蹤資料儲存在本機物件中,直到下一個頁面事件為止。 如果訪客導覽至新頁面,連結追蹤資料會遺失。 此設定在單頁應用程式環境中最為有利。
-
收集外部連結點按次數:啟用收集外部連結的核取方塊。
-
收集下載連結點按次數:啟用收集下載連結的核取方塊。
-
下載連結限定詞:限定連結URL為下載連結的規則運算式。
-
篩選點按屬性:回呼函式,可在集合前評估及修改點按相關屬性。 此函式在 在事件傳送回撥前開啟.
-
內容設定:自動收集訪客資訊,這會為您填入特定XDM欄位。 您可以選擇 所有預設內容資訊 或 特定內容資訊. 此標籤等同於
context
在JavaScript資料庫中。- Web:收集目前頁面的相關資訊。
- 裝置:收集使用者裝置的相關資訊。
- 環境:收集有關使用者瀏覽器的資訊。
- 地標內容:收集有關使用者位置的資訊。
- 高平均資訊量使用者代理提示:收集有關使用者裝置的詳細資訊。
onBeforeLinkClickSend
在JavaScript資料庫中。 使用 篩選點按屬性 回撥以篩選或調整點選資料,或使用 在事件傳送回撥前開啟 以篩選或調整傳送至Adobe的整體裝載。 如果兩者 篩選點按屬性 回呼與 在連結前按一下傳送 已設定回呼,只有 篩選點按屬性 回呼執行。設定媒體收集設定 media-collection
媒體收集功能可協助您收集與網站上媒體工作階段相關的資料。
收集的資料可包括關於媒體播放、暫停、完成和其他相關事件的資訊。 收集後,您可以將此資料傳送至Adobe Experience Platform和/或Adobe Analytics以產生報表。 此功能提供全方位的解決方案,可追蹤及瞭解您網站上的媒體使用行為。
設定資料流覆寫 datastream-overrides
資料流覆寫可讓您定義資料流的額外設定,這些設定會透過 Web SDK 傳遞到 Edge Network。
這可協助您觸發和預設行為不同的資料流行為,且無須建立新的資料流或修改現有設定。
資料流設定覆寫的流程包含兩個步驟:
- 首先,您必須在資料流設定頁面中定義您的資料流設定覆寫。
- 然後,您必須透過Web SDK命令或使用Web SDK標籤擴充功能,將覆寫傳送給Edge Network。
檢視資料流 設定覆寫檔案 以取得有關如何覆寫資料流設定的詳細說明。
除了透過Web SDK命令傳遞覆寫之外,您也可以在下面顯示的標籤擴充功能畫面中設定覆寫。
設定進階設定
使用 Edge基本路徑 Edge Network欄位。 這應該不需要更新,但在您參與Beta或Alpha的情況下,Adobe可能會要求您變更此欄位。