設定Web SDK標籤擴充功能

Web SDK標籤擴充功能會透過Experience PlatformEdge Network,從網頁屬性傳送資料至Adobe Experience Cloud。

擴充功能可讓您將資料串流至Platform、同步身分、處理客戶同意訊號,以及自動收集內容資料。

本檔案說明如何在標籤UI中設定標籤擴充功能。

安裝Web SDK標籤擴充功能 install

Web SDK標籤擴充功能需要安裝屬性。 如果您尚未這樣做,請參閱有關建立標籤屬性的檔案。

建立屬性之後,請開啟屬性並選取左側列的​ 擴充功能 ​標籤。

選取​ 目錄 ​索引標籤。 從可用的擴充功能清單中,尋找Web SDK擴充功能,然後選取​ 安裝

影像顯示已選取Web SDK擴充功能的Tags UI

選取​ 安裝 ​之後,您必須設定Web SDK標籤延伸並儲存設定。

NOTE
標籤擴充功能只會在儲存設定後安裝。 請參閱下一節以瞭解如何設定標籤擴充功能。

設定執行個體設定 general

頁面頂端的設定選項可告知Adobe Experience Platform將資料路由到何處,以及要在伺服器上使用哪些設定。

此影像顯示標籤UI中Web SDK標籤擴充功能的一般設定

  • 名稱: Adobe Experience Platform Web SDK擴充功能支援頁面上的多個執行個體。 此名稱可用來透過標籤設定,將資料傳送至多個組織。 執行個體名稱預設為alloy。 不過,您可將執行個體名稱變更為任何有效的JavaScript物件名稱。
  • IMS組織ID:您要在Adobe傳送資料的組織ID。 大部分時間都會使用自動填入的預設值。 頁面上有多個例項時,請找到您要傳送資料的第二個組織,以該組織的值填入此欄位。
  • Edge網域:擴充功能傳送及接收資料的網域。 Adobe建議對此擴充功能使用第一方網域(CNAME)。 預設的第三方網域適用於開發環境,但不適用於生產環境。若需設定第一方 CNAME 的相關說明,請參閱此處

設定資料流設定 datastreams

此段落可讓您選取三個可用環境(生產、測試和開發)中每一個都應該使用的資料串流。

當請求傳送至Edge Network時,會使用資料串流ID來參考伺服器端設定。 您可以更新設定,而無須在網站上變更程式碼。

請參閱資料串流指南,瞭解如何設定資料串流。

您可以從可用的下拉式功能表中選擇資料流,或選取​ 輸入值 ​並為每個環境輸入自訂資料流ID。

此影像顯示標籤UI中Web SDK標籤擴充功能的資料流設定

設定隱私權設定 privacy

本節可讓您設定Web SDK如何處理來自您網站的使用者同意訊號。 具體來說,如果沒有提供其他明確的同意偏好設定,這可讓您選取使用者假設的預設同意等級。

預設同意層級不會儲存到使用者設定檔。

此影像顯示標籤UI中Web SDK標籤擴充功能的隱私設定

預設同意層級
說明
收集在使用者提供同意偏好設定之前發生的事件。
捨棄在使用者提供同意偏好設定之前發生的事件。
擱置中
在使用者提供同意偏好設定之前發生的佇列事件。 提供同意偏好設定時,系統會根據提供的偏好設定收集或捨棄事件。
由資料元素提供
預設同意層級是由您定義的個別資料元素所決定。 使用此選項時,您必須使用提供的下拉式選單指定資料元素。
TIP
如果您需要明確的使用者同意才能進行業務操作,請使用​ Out ​或​ Pending

設定身分設定 identity

本節可讓您定義Web SDK在處理使用者身分識別時的行為。

此影像顯示標籤UI中Web SDK標籤擴充功能的身分設定

  • 從VisitorAPI移轉ECID:此選項預設為啟用。 啟用此功能後,SDK可以讀取AMCVs_ecid Cookie,並設定Visitor.js使用的AMCV Cookie。 移轉至Web SDK時,此功能很重要,因為有些頁面可能仍在使用Visitor.js。 此選項可讓SDK繼續使用相同的ECID,這樣就不會將使用者識別為兩個不同的使用者。

  • 使用第三方Cookie:啟用此選項時,Web SDK會嘗試將使用者識別碼儲存在第三方Cookie中。 如果成功,則會在使用者瀏覽多個網域時將其識別為單一使用者,而不是在每個網域上將其識別為個別使用者。 如果已啟用此選項,如果瀏覽器不支援第三方Cookie或使用者已設定不允許第三方Cookie,SDK仍可能無法將使用者識別碼儲存在第三方Cookie中。 在此情況下,SDK只會將識別碼儲存在第一方網域中。

    note important
    IMPORTANT
    ​>第三方Cookie與Web SDK中的第一方裝置識別碼功能不相容。

您可以使用第一方裝置識別碼,或使用第三方Cookie,但無法同時使用這兩項功能。

設定個人化設定 personalization

此區段可讓您設定在載入個人化內容時如何隱藏頁面的某些部分。 這可確保您的訪客只會看到個人化頁面。

此影像顯示標籤UI中Web SDK標籤擴充功能的個人化設定

  • 將Target從at.js移轉至Web SDK:使用此選項可讓Web SDK讀取及寫入at.js 1.x2.x資料庫所使用的舊版mboxmboxEdgeCluster Cookie。 這可協助您在從使用Web SDK的頁面移至使用at.js 1.x2.x資料庫的頁面時保留訪客設定檔,反之亦然。

預先隱藏樣式 prehiding-style

預先隱藏樣式編輯器可讓您定義自訂CSS規則,以隱藏頁面的特定區段。 載入頁面時,Web SDK會使用此樣式來隱藏需要個人化的區段,擷取個人化,然後取消隱藏個人化的頁面區段。 如此一來,您的訪客便能看見已個人化的頁面,而不需看見個人化擷取程式。

預先隱藏程式碼片段 prehiding-snippet

非同步載入Web SDK程式庫時,預先隱藏程式碼片段相當實用。 在此情況下,為避免忽隱忽現的情形,我們建議在載入Web SDK程式庫之前隱藏內容。

若要使用預先隱藏的程式碼片段,請複製該程式碼片段,並貼到頁面的<head>元素中。

IMPORTANT
使用預先隱藏程式碼片段時,Adobe建議使用與預先隱藏樣式所用的規則相同的CSS規則。

設定資料收集設定 data-collection

管理資料收集組態設定。 使用configure命令可在JavaScript資料庫中使用類似的設定。

此影像顯示標籤UI中Web SDK標籤擴充功能的資料收集設定。

  • 在事件傳送回呼之前:回呼函式,用於評估及修改傳送給Adobe的裝載。 在回呼函式中使用content變數來修改裝載。 此回呼的標籤相當於JavaScript資料庫中的onBeforeEventSend

  • 收集內部連結點按次數:啟用收集網站或屬性內部連結追蹤資料的核取方塊。 啟用此核取方塊時,會顯示事件分組選項:

    • 沒有事件分組:連結追蹤資料會以個別事件傳送給Adobe。 在個別事件中傳送的連結點選可能會增加傳送至Adobe Experience Platform的資料的合約使用量。
    • 使用工作階段存放區進行事件分組:將連結追蹤資料儲存在工作階段存放區中,直到發生下一頁事件為止。 在以下頁面中,儲存的連結追蹤資料和頁面檢視資料會同時傳送給Adobe。 Adobe建議在追蹤內部連結時啟用此設定。
    • 使用本機物件進行事件分組:將連結追蹤資料儲存在本機物件中,直到下一頁事件為止。 如果訪客導覽至新頁面,連結追蹤資料會遺失。 此設定在單頁應用程式環境中最為有利。
  • 收集外部連結點按次數:啟用外部連結收集的核取方塊。

  • 收集下載連結點按次數:啟用收集下載連結的核取方塊。

  • 下載連結限定詞:將連結URL限定為下載連結的規則運算式。

  • 篩選點選屬性:回呼函式,可在集合前評估及修改點選相關屬性。 此函式在事件傳送callback前的On之前執行。

  • 內容設定:自動收集訪客資訊,這些資訊會為您填入特定XDM欄位。 您可以選擇​ 所有預設內容資訊 ​或​ 特定內容資訊。 它等同於JavaScript資料庫中的context標籤。

    • 網頁:收集目前頁面的相關資訊。
    • 裝置:收集使用者裝置的相關資訊。
    • 環境:收集使用者瀏覽器的相關資訊。
    • 放置內容:收集有關使用者位置的資訊。
    • 高平均資訊量使用者代理程式提示:收集有關使用者裝置的詳細資訊。
TIP
在連結點選前開啟 ​欄位是已棄用的回呼,只對已設定它的屬性可見。 它等同於JavaScript資料庫中的onBeforeLinkClickSend標籤。 使用​ 篩選點選屬性 ​回呼來篩選或調整點選資料,或使用​ 在事件傳送回呼前開啟 ​來篩選或調整傳送給Adobe的整體承載。 如果​ 篩選點選屬性 ​回呼和​ 在連結點選前開啟 ​回呼都已設定,則只有​ 篩選點選屬性 ​回呼執行。

設定媒體收集設定 media-collection

媒體收集功能可協助您收集與網站上媒體工作階段相關的資料。

收集的資料可包括關於媒體播放、暫停、完成和其他相關事件的資訊。 收集後,您可以將此資料傳送至Adobe Experience Platform和/或Adobe Analytics以產生報表。 此功能提供全方位的解決方案,可追蹤及瞭解您網站上的媒體使用行為。

此影像顯示標籤UI中Web SDK標籤擴充功能的媒體收集設定

  • 頻道:媒體收集發生所在頻道的名稱。 範例:Video channel
  • 播放器名稱:媒體播放器的名稱。
  • 應用程式版本:媒體播放器應用程式的版本。
  • 主要Ping間隔:主要內容的Ping頻率(秒)。 預設值為 10。值範圍從1050秒。 如果未指定值,則使用自動追蹤的工作階段時使用預設值。
  • 廣告Ping間隔:廣告內容的Ping頻率(秒)。 預設值為 10。值範圍從110秒。 如果未指定值,則使用自動追蹤的工作階段時使用預設值

設定資料流覆寫 datastream-overrides

資料流覆寫可讓您定義資料流的額外設定,這些設定會透過 Web SDK 傳遞到 Edge Network。

這可協助您觸發和預設行為不同的資料流行為,且無須建立新的資料流或修改現有設定。

資料流設定覆寫的流程包含兩個步驟:

  1. 首先,您必須在資料流設定頁面中定義您的資料流設定覆寫。
  2. 然後,您必須透過Web SDK命令或使用Web SDK標籤擴充功能,將覆寫傳送給Edge Network。

如需如何覆寫資料流設定的詳細說明,請參閱資料流設定覆寫檔案

除了透過Web SDK命令傳遞覆寫之外,您也可以在下面顯示的標籤擴充功能畫面中設定覆寫。

IMPORTANT
資料流覆寫必須根據環境進行設定。 開發、測試和生產環境都有不同的覆寫。 您可以使用下方畫面中顯示的專用選項,複製設定值。

影像顯示使用Web SDK標籤延伸功能頁面的資料流設定覆寫。

預設會停用資料流設定覆寫。 預設會選取​ 符合資料流組態 ​選項。

顯示資料流設定的Web SDK標籤延伸使用者介面會覆寫預設設定。

若要在標籤延伸中啟用資料流覆寫,請從下拉式功能表中選取​ 已啟用

顯示資料流組態覆寫[已啟用]設定的Web SDK標籤延伸使用者介面。

啟用資料流設定覆寫後,您可以為每個服務設定覆寫,如下所述。

以下資料流覆寫設定將覆寫所選環境的任何伺服器端資料流設定和規則。

Adobe Analytics analytics

使用此區段中的設定覆寫路由傳送至Adobe Analytics服務的資料。

顯示Adobe Analytics資料流覆寫設定的Web SDK標籤延伸使用者介面影像。

  • 已啟用 / 已停用:使用此下拉式功能表來啟用或停用傳送至Adobe Analytics服務的資料。
  • 報表套裝: Adobe Analytics中目標報表套裝的ID。 該值必須是來自您的資料流設定的預先設定覆寫報告套裝(或以逗號分隔的報告套裝清單)。 此設定會覆寫主要報表套裝。
  • 新增報表套裝:選取此選項即可新增其他報表套裝。

Adobe Audience Manager audience-manager

使用此區段中的設定覆寫路由傳送至Adobe Audience Manager服務的資料。

顯示Adobe Audience Manager資料流覆寫設定的Web SDK標籤延伸使用者介面影像。

  • 已啟用 / 已停用:使用此下拉式功能表來啟用或停用傳送至Adobe Audience Manager服務的資料。
  • 協力廠商ID同步容器:Audience Manager中目的地協力廠商ID同步容器的識別碼。 值必須是來自資料流設定的預先設定次要容器,並覆寫主要容器。

Adobe Experience Platform experience-platform

使用此區段中的設定覆寫路由傳送至Adobe Experience Platform服務的資料。

顯示Adobe Experience Platform資料流覆寫設定的Web SDK標籤延伸使用者介面影像。

  • 已啟用 / 已停用:使用此下拉式功能表來啟用或停用傳送至Adobe Experience Platform服務的資料。
  • 事件資料集: Adobe Experience Platform中目的地事件資料集的識別碼。 該值必須是來自您的資料流設定的預先設定次要資料集。
  • Offer decisioning:使用此下拉式功能表來啟用或停用到Offer Decisioning服務的資料路由。
  • Edge Segmentation:使用此下拉式功能表來啟用或停用到Edge Segmentation服務的資料路由。
  • Personalization目的地:使用此下拉式功能表來啟用或停用個人化目的地的資料路由。
  • Adobe Journey Optimizer:使用此下拉式功能表來啟用或停用到Adobe Journey Optimizer服務的資料路由。

Adobe伺服器端事件轉送 ssf

使用此區段中的設定覆寫路由傳送至Adobe伺服器端事件轉送服務的資料。

顯示Adobe伺服器端事件轉送資料流覆寫設定的Web SDK標籤延伸使用者介面影像。

  • 已啟用 / 已停用:使用此下拉式功能表來啟用或停用傳送至Adobe伺服器端事件轉送服務的資料。

Adobe Target target

使用此區段中的設定覆寫路由傳送至Adobe Target服務的資料。

顯示Adobe Target資料流覆寫設定的Web SDK標籤延伸使用者介面影像。

  • 已啟用 / 已停用:使用此下拉式功能表來啟用或停用傳送至Adobe Target服務的資料。

設定進階設定

如果您需要變更與Edge Network互動所用的基底路徑,請使用​ Edge基底路徑 ​欄位。 這應該不需要更新,但在您參與Beta或Alpha的情況下,Adobe可能會要求您變更此欄位。

顯示使用Web SDK標籤延伸頁面之進階設定的影像。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743