Adobe 外掛程式:pt
pt
外掛程式會對 Analytics 變數清單執行函數或方法。例如,您可以選擇性地對多個變數執行 clearVars
函數,而不需每次都手動呼叫該函數。 其他多個外掛程式依賴此程式碼才能正確運作。如果您不需要一次對多個 Analytics 變數執行特定函數,或者您未使用任何相依外掛程式,就不需要此外掛程式。
使用Web SDK或Web SDK擴充功能安裝外掛程式
此外掛程式尚不支援在Web SDK中使用。
使用Adobe Analytics擴充功能安裝外掛程式
Adobe提供擴充功能,可讓您搭配Adobe Analytics使用最常用的外掛程式。
-
使用您的 AdobeID 認證登入 Adobe Experience Platform 資料彙集。
-
按一下所需的標籤屬性。
-
前往擴充功能標記,然後按一下「目錄」按鈕
-
安裝並發佈常用 Analytics 外掛程式擴充功能
-
如果您尚未執行上述步驟,請使用下列設定建立標示為「初始化外掛程式」的規則:
- 條件:無
- 事件:核心 - 已載入資料庫 (頁面頂端)
-
使用下列設定將動作新增至上述規則:
- 擴充功能:常用 Analytics 外掛程式
- 動作類型:初始化 pt
-
儲存並發佈規則的變更。
使用自訂程式碼編輯器安裝外掛程式
如果您不想使用常見Analytics外掛程式擴充功能,可以使用自訂程式碼編輯器。
- 使用您的 AdobeID 認證登入 Adobe Experience Platform 資料彙集。
- 按一下所需的屬性。
- 前往擴充功能索引標籤,然後按一下 Adobe Analytics 擴充功能底下的 「設定」 按鈕。
- 展開使用自訂程式碼設定追蹤摺疊式功能表,便會顯示「開啟編輯器」按鈕。
- 開啟自訂程式碼編輯器,並將下方提供的外掛程式程式碼貼入編輯視窗中。
- 儲存並發佈 Analytics 擴充功能的變更。
使用 AppMeasurement 安裝外掛程式
Analytics 追蹤物件實例化 (使用 s_gi
) 後,將下列程式碼複製並貼到 AppMeasurement 檔案中的任何位置。保留您實作中的程式碼備註和版本號碼,有助於 Adobe 疑難排解任何可能問題。
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: pt v3.0 */
function pt(l,de,cf,fa){var b=l,d=de,f=cf,g=fa;if("-v"===b)return{plugin:"pt",version:"3.0"};a:{if("undefined"!==typeof window.s_c_il){var a=0;for(var c;a<window.s_c_il.length;a++)if(c=window.s_c_il[a],c._c&&"s_c"===c._c){a=c;break a}}a=void 0}if("undefined"!==typeof a&&(a.contextData.pt="3.0",b&&a[f])){b=b.split(d||",");d=b.length;for(var e=0;e<d;e++)if(c=a[f](b[e],g))return c}};
/******************************************** END CODE TO DEPLOY ********************************************/
使用外掛程式
pt
函數會使用以下引數:
l
(必要,字串):變數清單,包含cf
引數的函數可針對此清單執行。de
(選用,字串):區分l
引數中變數清單的分隔字元。預設為逗號 (,
)。cf
(必要,字串):要針對l
引數中包含的每個變數呼叫的 AppMeasurement 物件中,所包含的回呼函數名稱。fa
(選用,字串):如果cf
引數中的函數會在執行時呼叫其他引數,請在此處納入它們。預設為undefined
。
如果回呼函數 (在 cf
引數中) 傳回值,呼叫此函數便會傳回值。
呼叫範例
範例 #1
下列程式碼是 getQueryParam 外掛程式的一部分。它會針對 URL 查詢字串 (fullQueryString) 中包含的每個鍵值組執行 getParameterValue 協助程式函數。若要擷取各個鍵值組,fullQueryString 必須以「&」字元分隔並分割。parameterKey 會參考外掛程式特別嘗試從查詢字串中擷取的查詢字串參數
returnValue = pt(fullQueryString, "&", "getParameterValue", parameterKey)
上一行是執行類似下列程式碼的捷徑:
var returnValue = "",
parameters = fullQueryString.split("&"),
parametersLength = parameters.length;
for(var i = 0; i < parametersLength; i++)
{
returnValue = getParameterValue(parameters[i], parameterKey);
if(returnValue !== "") break;
}
版本記錄
3.0 (2021 年 3 月 19 日)
- 將版本編號加入為內容資料。
2.01 (2019 年 9 月 24 日)
- 小幅變更程式碼以縮小整體大小
2.0 (2018 年 4 月 17 日)
- 單點發行 (重新編譯,程式碼大小較小)。
- 新增對 H-Code 和 AppMeasurement 的支援。
1.0 (2013 年 9 月 23 日)
- 首次發行。