常見Web SDK外掛程式擴充功能概觀

本文介紹如何設定Web SDK外掛程式標籤擴充功能，並用來增強Adobe Experience Platform Web SDK擴充功能。

設定常見Web SDK外掛程式擴充功能

本節提供設定Web SDK外掛程式擴充功能時可用選項的參考資料。

將外掛程式新增至Adobe Experience Platform Web SDK擴充功能

除了使用「常用Web SDK外掛程式」擴充功能提供的下列原生資料元素之外，不需要進行設定即可初始化或新增外掛程式至您的程式庫：

getAndPersistValue

可讓您設定getAndPersistValue Analytics外掛程式。 getAndPersistValue資料元素會將值儲存在Cookie中，以便稍後造訪時擷取。

getAndPersistValue資料元素提供下列引數：

如果vtp引數中的變數已設定，則資料元素會設定Cookie，然後傳回Cookie值。 如果vtp引數中的變數未設定，則資料元素只會傳回Cookie值。

getGeoCoordinates

可讓您設定getGeoCoordinates Analytics外掛程式。 getGeoCoordinates資料元素會擷取訪客裝置的經緯度。

getGeoCoordinates資料元素未使用任何引數。 它會傳回以下其中一個值：

getNewRepeat

可讓您設定getNewRepeat Analytics外掛程式。 getNewRepeat資料元素會判斷網站訪客是新訪客還是在指定天數內回訪的重複訪客。

getNewRepeat資料元素使用以下引數：

如果資料元素設定的Cookie不存在或已過期，則此資料元素會傳回"New"的值。 如果資料元素設定的Cookie存在，且自目前點選以來的時間量及Cookie中設定的時間超過30分鐘，則會傳回"Repeat"值。 此方法會為整個造訪傳回相同值。

getPageName

可讓您設定getPageName Analytics外掛程式。 getPageName資料元素可為目前的URL建立易讀、好記的格式化版本。

getPageName資料元素使用以下引數：

資料元素會傳回包含易記格式化版URL的字串。 此字串通常會指派給pageName變數，但也可用於其他變數。

getPreviousValue

可讓您設定getPreviousValue Analytics外掛程式。 getPreviousValue資料元素會將變數設定為先前點選上設定的值。

getPreviousValue資料元素使用以下引數：

當您呼叫此資料元素時，它會傳回Cookie中包含的字串值。 此外掛程式會重設Cookie有效期，並從v引數指派變數值。 Cookie會在閒置30分鐘後過期。

getQueryParam

可讓您設定getQueryParam Analytics外掛程式。 getQueryParam資料元素會擷取URL中所含任何查詢字串引數的值。 若要從登陸頁面URL擷取內部和外部促銷活動程式碼，此外掛程式非常有用。 擷取搜尋詞或其他查詢字串引數時，它也很有用。 此資料元素提供完善的功能，可剖析複雜的URL，包括雜湊和包含多個查詢字串引數的URL。

getQueryParam資料元素使用以下引數：

若呼叫此資料元素，系統會根據上述引數和URL傳回值：

getTimeParting

可讓您設定getTimeParting Analytics外掛程式。 getTimeParting資料元素會擷取網站上發生任何可測量活動的時間詳細資訊。 如果您想要依指定日期範圍內任何可重複的時間區隔來劃分量度，此資料元素就十分實用。 例如，您可以比較一週內兩天之間的轉換率，例如所有週日比較所有週四。 您也可以比較一天中的時段，例如所有早上比較所有晚上。

getTimeParting資料元素使用下列引數：

t （選用但建議使用，字串）：將訪客的當地時間轉換為該時區的時區名稱。 預設為UTC/GMT時間。 如需有效值的完整清單，請參閱Wikipedia上的TZ資料庫時區清單。

常見的有效值包括：

呼叫此資料元素會傳回包含下列內容的字串，並以縱線字元(|)分隔：

getTimeSinceLastVisit

可讓您設定getTimeSinceLastVisit Analytics外掛程式。 getTimeSinceLastVisit資料元素會追蹤訪客從上次造訪到下次回訪您網站經過的時間長度。

getTimeSinceLastVisit資料元素未使用任何引數。 它會傳回自訪客上次造訪網站以來經過的時間長度，並以下列格式分組：

getValOnce

可讓您設定getValOnce Analytics外掛程式。 getValOnce資料元素可防止變數多次設為等於相同值。

getValOnce資料元素使用以下引數：

如果vtc引數與Cookie值相符，此方法會傳回空字串。 如果vtc引數與Cookie值不符，方法會將vtc引數傳回為字串。

getVisitDuration

可讓您設定getVisitDuration Analytics外掛程式。 getVisitDuration資料元素會追蹤訪客截至該時間點為止在網站上逗留的時間長度，以分鐘為單位。

getVisitDuration資料元素未使用任何引數。 它會傳回以下其中一個值：

getVisitNum

可讓您設定getVisitNum Analytics外掛程式。 getVisitNum資料元素會傳回在指定天數內造訪過網站的所有訪客造訪次數。

getVisitNum資料元素使用以下引數：

訪客閒置30分鐘後再返回您的網站時，造訪次數會增加。 呼叫此方法會傳回一個整數，代表訪客目前的造訪次數。

p_fo （僅限頁面優先）

可讓您設定p_fo Analytics外掛程式。 p_fo資料元素是公用程式，可檢查特定JavaScript物件是否存在。 如果物件不存在，則外掛程式會建立該物件並傳回true。 如果頁面上已存在JavaScript物件，則會傳回false。 若要在頁面上執行一次程式碼，此資料元素相當實用。

p_fo資料元素使用以下引數：

如果物件尚不存在，則此方法會傳回true並建立該物件。 如果物件已存在，則此方法會傳回false。