Adobe 外掛程式：getPageName

getPageName 外掛程式可為目前的 URL 建立易讀、好記的格式化版本。如果您想要在報表中輕鬆設定且理解的 pageName 值，Adobe 建議使用此外掛程式。如果您已有 pageName 變數的命名結構 (例如透過資料層)，就不需要此外掛程式。若您沒有其他解決方案可設定 pageName 變數，最好使用此外掛程式。

使用 Adobe Experience Platform Launch 擴充功能安裝外掛程式

Adobe 提供一個擴充功能，可讓您使用最常用的外掛程式。

1. 使用您的 AdobeID 憑證登入 launch.adobe.com。
2. 按一下所需的屬性。
3. 前往擴充功能標籤，然後按一下「目錄」按鈕
4. 安裝並發佈常用 Analytics 外掛程式擴充功能
5. 如果您尚未執行上述步驟，請使用下列設定建立標示為「初始化外掛程式」的規則：
   • 條件：無
   • 事件：核心 - 已載入程式庫 (頁面頂端)
6. 使用下列設定將動作新增至上述規則：
   • 擴充功能：常用 Analytics 外掛程式
   • 動作類型：初始化 getPageName
7. 儲存並發佈規則的變更。

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

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

1. 使用您的 AdobeID 憑證登入 launch.adobe.com。
2. 按一下所需的屬性。
3. 前往擴充功能標籤，然後按一下 Adobe Analytics 擴充功能底下的「設定」按鈕。
4. 展開使用自訂程式碼設定追蹤摺疊式功能表，便會顯示「開啟編輯器」按鈕。
5. 開啟自訂程式碼編輯器，並將下方提供的外掛程式程式碼貼入編輯視窗中。
6. 儲存並發佈 Analytics 擴充功能的變更。

使用 AppMeasurement 安裝外掛程式

Analytics 追蹤物件實例化 (使用 s_gi) 後，將下列程式碼複製並貼到 AppMeasurement 檔案中的任何位置。保留您實施中的程式碼備註和版本號碼，有助於 Adobe 疑難排解任何可能問題。

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getPageName v4.2 */
var getPageName=function(si,qv,hv,de){var a=si,b=qv,f=hv,e=de;if("-v"===a)return{plugin:"getPageName",version:"4.2"};a:{if("undefined"!==typeof window.s_c_il){var d=0;for(var g;d<window.s_c_il.length;d++)if(g=window.s_c_il[d],g._c&&"s_c"===g._c){d=g;break a}}d=void 0}"undefined"!==typeof d&&(d.contextData.getPageName="4.2");var c=location.hostname,h=location.pathname.substring(1).split("/"),l=h.length,k=location.search.substring(1).split("&"),m=k.length;d=location.hash.substring(1).split("&");g=d.length;e=e?e:"|";a=a?a:c;b=b?b:"";f=f?f:"";if(1===l&&""===h[0])a=a+e+"home";else for(c=0;c<l;c++)a=a+e+decodeURIComponent(h[c]);if(b&&(1!==m||""!==k[0]))for(h=b.split(","),l=h.length,c=0;c<l;c++)for(b=0;b<m;b++)if(h[c]===k[b].split("=")[0]){a=a+e+decodeURIComponent(k[b]);break}if(f&&(1!==g||""!==d[0]))for(f=f.split(","),k=f.length,c=0;c<k;c++)for(b=0;b<g;b++)if(f[c]===d[b].split("=")[0]){a=a+e+decodeURIComponent(d[b]);break}return a.substring(a.length-e.length)===e?a.substring(0,a.length-e.length):a};
/******************************************** END CODE TO DEPLOY ********************************************/

使用外掛程式

getPageName 方法使用以下引數：

• si (選用，字串)：在代表網站 ID 的字串開頭插入的 ID。此值可以是數值 ID 或好記的名稱。未設定時，其預設值為目前的網域。
• qv (選用，字串)：以逗號分隔的查詢字串參數清單，若在 URL 中找到，便會新增至字串
• hv (選用，字串)：在 URL 雜湊中找到的逗號分隔參數清單，若在 URL 中找到，則會新增至字串
• de (選用，字串)：分割字串個別部分的分隔字元。預設為縱線字元 (|)。

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

呼叫範例

範例 #1

如果目前的 URL 是…

https://mail.google.com/mail/u/0/#inbox

…且下列程式碼執行…

s.pageName = getPageName()

…s.pageName 的最終值將為：

s.pageName = "mail.google.com|mail|u|0";

範例 #2

如果目前的 URL 是…

https://mail.google.com/mail/u/0/#inbox

…且下列程式碼執行…

s.pageName = getPageName("gmail")

…s.pageName 的最終值將為：

s.pageName = "gmail|mail|u|0";

範例 #3

如果目前的 URL 是…

https://www.google.com/

…且下列程式碼執行…

s.pageName = getPageName()

…s.pageName 的最終值將為：

s.pageName = "www.google.com|home"

注意：程式碼在不含路徑的 URL 上執行時，一律會將 "home" 值新增至傳回值的結尾

範例 #4

如果目前的 URL 是…

https://www.google.com/

…且下列程式碼執行…

s.pageName = getPageName("google","","","|")

…s.pageName 的最終值將為：

s.pageName = "google|home"

範例 #5

如果目前的 URL 是…

https://www.hotelrooms.com/en/booking/room-booking.html?cid=1235#/step2&arrive=2018-05-26&depart=2018-05-27&numGuests=2

…且下列程式碼執行…

s.pageName = getPageName()

…s.pageName 的最終值將為：

s.pageName = "www.hotelrooms.com|en|booking|room-booking.html"

不過，如果改成下列程式碼執行…

s.pageName = getPageName("hotelrooms","cid","arrive,numGuests",": ")

…s.pageName 的最終值將為：

s.pageName = "hotelrooms: en: booking: room-booking.html: cid=1235: arrive=2018-05-26: numGuests=2"

從舊版升級

getPageName 外掛程式的 4.0+ 版不依存於要執行的 Adobe Analytics AppMeasurement 物件 (即「s」物件) 之存在。如果您選擇升級為此版本，請務必移除呼叫中「s」物件的任何例項，以變更呼叫該外掛程式的程式碼。例如，請變更下列項目：

s.pageName = s.getPageName();

…變更為這個：

s.pageName = getPageName();

版本記錄

4.2 (2021 年 3 月 19 日)

• 將版本編號加入為內容資料。

4.1 (2019 年 9 月 17 日)

• 將預設分隔字元值變更為縱線字元 (原為冒號 + 空格)。

4.0 (2018 年 5 月 22 日)

• 外掛程式全面重新分析/重寫