Adobe 外掛程式:inList
IMPORTANT
此外掛程式由 Adobe Consulting 提供,協助您從 Adobe Analytics 中獲得更多價值。Adobe 客戶服務不提供此外掛程式的支援,包括安裝或疑難排解在內。如果您需要與此外掛程式有關的協助,請聯絡貴組織的 Adobe 客戶團隊。他們可幫您安排顧問會議,以尋求協助。
inList
外掛程式可讓您檢查某值是否已存在於分隔字串或 JavaScript 陣列物件中。有其他多種外掛程式依賴 inList
外掛程式才能運作。此外掛程式可提供比 JavaScript 方法 indexOf()
更明顯的優點,其不會比對字串的一部分。例如,如果您使用此外掛程式來檢查 "event2"
,它將不會比對包含 "event25"
的字串。如果您不需要檢查分隔字串或陣列中的值,或您想要使用自己的 indexOf()
邏輯,就不需要此外掛程式。
使用Web SDK或Web SDK擴充功能安裝外掛程式
此外掛程式尚不支援在Web SDK中使用。
使用Adobe Analytics擴充功能安裝外掛程式
Adobe提供擴充功能,可讓您搭配Adobe Analytics使用最常用的外掛程式。
-
使用您的 AdobeID 認證登入 Adobe Experience Platform 資料彙集。
-
按一下所需的標籤屬性。
-
前往擴充功能標記,然後按一下「目錄」按鈕
-
安裝並發佈常用 Analytics 外掛程式擴充功能
-
如果您尚未執行上述步驟,請使用下列設定建立標示為「初始化外掛程式」的規則:
- 條件:無
- 事件:核心 - 已載入資料庫 (頁面頂端)
-
使用下列設定將動作新增至上述規則:
- 擴充功能:常用 Analytics 外掛程式
- 動作類型:初始化 inList
-
儲存並發佈規則的變更。
使用自訂程式碼編輯器安裝外掛程式
如果您不想使用常見Analytics外掛程式擴充功能,可以使用自訂程式碼編輯器。
- 使用您的 AdobeID 認證登入 Adobe Experience Platform 資料彙集。
- 按一下所需的屬性。
- 前往擴充功能索引標籤,然後按一下 Adobe Analytics 擴充功能底下的 「設定」 按鈕。
- 展開使用自訂程式碼設定追蹤摺疊式功能表,便會顯示「開啟編輯器」按鈕。
- 開啟自訂程式碼編輯器,並將下方提供的外掛程式程式碼貼入編輯視窗中。
- 儲存並發佈 Analytics 擴充功能的變更。
使用 AppMeasurement 安裝外掛程式
Analytics 追蹤物件實例化 (使用 s_gi
) 後,將下列程式碼複製並貼到 AppMeasurement 檔案中的任何位置。保留您實作中的程式碼備註和版本號碼,有助於 Adobe 疑難排解任何可能問題。
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: inList v3.0 */
function inList(lv,vtc,d,cc){var b=lv,e=vtc,c=d,f=cc;if("-v"===b)return{plugin:"inList",version:"3.0"};a:{if("undefined"!==typeof window.s_c_il){var a=0;for(var d;a<window.s_c_il.length;a++)if(d=window.s_c_il[a],d._c&&"s_c"===d._c){a=d;break a}}a=void 0}"undefined"!==typeof a&&(a.contextData.inList="3.0");if("string"!==typeof e)return!1;if("string"===typeof b)b=b.split(c||",");else if("object"!==typeof b)return!1;c=0;for(a=b.length;c<a;c++)if(1==f&&e===b[c]||e.toLowerCase()===b[c].toLowerCase())return!0;return!1};
/******************************************** END CODE TO DEPLOY ********************************************/
使用外掛程式
inList
函數會依據其輸入傳回布林值。 它會使用以下引數:
lv
(必要,字串或陣列):要搜尋的分隔值清單或 JavaScript 陣列物件vtc
(必要,字串):要搜尋的值d
(選用,字串):用於分隔lv
引數中個別值的分隔字元。若未設定,則預設為逗號 (,
)。cc
(選用,布林值):如果設為true
或1
,則會進行區分大小寫的檢查。 如果設為false
或省略,則會進行不區分大小寫的檢查。預設為false
。
如果找到相符項目,呼叫此函數會傳回 true
,若找不到相符項目則會傳回 false
。
範例
// Returns true
s.events = "event22,event24";
if(inList(s.events,"event22")) {
// Code will execute
}
// Returns false because event2 is not an exact match in the string
s.events = "event22,event24";
if(inList(s.events,"event2")) {
// Code will not execute
}
// Returns true because of the NOT operator
s.events = "event22,event24";
if(!inList(s.events,"event23")) {
// Code will execute
}
// Returns false because of the case-sensitive check
s.events = "event22,event23";
if(inList(s.events,"EVenT23","",true)) {
// Code will not execute
}
// Returns false because of a mismatched delimiter, treating "events,eVar1" as a single value
s.linkTrackVars = "events,eVar1";
if(inList(s.linkTrackVars,"eVar1","|")) {
// Code will not execute
}
版本記錄
3.0 (2021 年 3 月 19 日)
- 將版本編號加入為內容資料。
v2.1 (2019 年 9 月 26 日)
- 新增非布林值的
cc
引數選項。例如,1
是有效的大小寫檢查值。
v2.0 (2018 年 4 月 17 日)
- 單點發行 (重新編譯,程式碼大小較小)。
v1.01 (2017 年 9 月 27 日)
- 最佳化程式碼以縮小大小
v1.0 (2009 年)
- 首次發行。
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690