Adobe 外掛程式:pt

IMPORTANT
此外掛程式由 Adobe Consulting 提供,協助您從 Adobe Analytics 中獲得更多價值。Adobe 客戶服務不提供此外掛程式的支援,包括安裝或疑難排解在內。如果您需要與此外掛程式有關的協助,請聯絡貴組織的 Adobe 客戶團隊。他們可幫您安排顧問會議,以尋求協助。

pt 外掛程式會對 Analytics 變數清單執行函數或方法。例如,您可以選擇性地對多個變數執行 clearVars 函數,而不需每次都手動呼叫該函數。 其他多個外掛程式依賴此程式碼才能正確運作。如果您不需要一次對多個 Analytics 變數執行特定函數,或者您未使用任何相依外掛程式,就不需要此外掛程式。

使用Web SDK或Web SDK擴充功能安裝外掛程式

此外掛程式尚不支援在Web SDK中使用。

使用Adobe Analytics擴充功能安裝外掛程式

Adobe提供擴充功能,可讓您搭配Adobe Analytics使用最常用的外掛程式。

  1. 使用您的 AdobeID 認證登入 Adobe Experience Platform 資料彙集

  2. 按一下所需的標籤屬性。

  3. 前往擴充功能標記,然後按一下「目錄」按鈕

  4. 安裝並發佈常用 Analytics 外掛程式擴充功能

  5. 如果您尚未執行上述步驟,請使用下列設定建立標示為「初始化外掛程式」的規則:

    • 條件:無
    • 事件:核心 - 已載入資料庫 (頁面頂端)
  6. 使用下列設定將動作新增至上述規則:

    • 擴充功能:常用 Analytics 外掛程式
    • 動作類型:初始化 pt
  7. 儲存並發佈規則的變更。

使用自訂程式碼編輯器安裝外掛程式

如果您不想使用常見Analytics外掛程式擴充功能,可以使用自訂程式碼編輯器。

  1. 使用您的 AdobeID 認證登入 Adobe Experience Platform 資料彙集
  2. 按一下所需的屬性。
  3. 前往擴充功能索引標籤,然後按一下 Adobe Analytics 擴充功能底下的​ 「設定」 ​按鈕。
  4. 展開使用自訂程式碼設定追蹤摺疊式功能表,便會顯示「開啟編輯器」按鈕。
  5. 開啟自訂程式碼編輯器,並將下方提供的外掛程式程式碼貼入編輯視窗中。
  6. 儲存並發佈 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 日)

  • 首次發行。
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690