Adobe 外掛程式：rfl (從清單中刪除)

rfl 外掛程式可讓您「安全地」從分隔字串中移除值，例如 events、products、list 等。如果您想從分隔字串中移除特定值，而不想顧慮分隔字元，此外掛程式非常實用。其他多個外掛程式依賴此程式碼才能正確運作。如果您不需要一次對多個 Analytics 變數執行特定函數，或者您未使用任何相依外掛程式，就不需要此外掛程式。

此外掛程式使用下列邏輯：

• 如果您要移除的值存在，外掛程式會保留變數中除了待移除值以外的所有內容。
• 如果您要移除的值不存在，外掛程式會將原始字串維持原狀。

使用 Adobe Experience Platform 中的標記安裝外掛程式

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

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

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

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

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

使用 AppMeasurement 安裝外掛程式

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

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: rfl (removeFromList) v2.1  */
function rfl(lv,vr,d1,d2,df){var b=lv,f=vr,e=d1,h=d2,g=df;if("-v"===b)return{plugin:"rfl",version:"2.1"};a:{if("undefined"!==typeof window.s_c_il){var c=0;for(var a;c<window.s_c_il.length;c++)if(a=window.s_c_il[c],a._c&&"s_c"===a._c){c=a;break a}}c=void 0}"undefined"!==typeof c&&(c.contextData.rfl="2.1");if(!b||!f)return"";c=[];a="";e=e||",";h=h||e;g=g||!1;b=b.split(e);e=b.length;for(var d=0;d<e;d++)-1<b[d].indexOf(":")&&(a=b[d].split(":"),a[1]=a[0]+":"+a[1],b[d]=a[0]),-1<b[d].indexOf("=")&&(a=b[d].split("="),a[1]=a[0]+"="+a[1],b[d]=a[0]),b[d]!==f&&a?c.push(a[1]):b[d]!==f?c.push(b[d]):b[d]===f&&g&&(a?c.push(a[1]):c.push(b[d]),g=!1),a="";return c.join(h)};
/******************************************** END CODE TO DEPLOY ********************************************/

使用外掛程式

rfl 函數會使用以下引數：

• lv (必要，字串)：包含分隔值清單的變數 (或字串)
• vr (必要，字串)：您要從 lv 引數中移除的值。Adobe 建議您不要在 rfl 單一呼叫期間移除多個值。
• d1 (選用，字串)：lv 引數使用的分隔字元。預設為逗號 (,)。
• d2 (選用，字串)：您要讓傳回字串使用的分隔字元。預設為與 d1 引數相同的值。
• df (選用，布林值)：如果為 true，則僅強制從 lv 引數中複製 vr 引數的例項，而非所有例項。若未設定，則預設為 false。

呼叫此函數會傳回包含 lv 引數的修改字串，但字串中不包含 vr 引數中所指定值的任何實例 (或重複實例)。

呼叫範例

範例 #1

若…

s.events = "event22,event24,event25";

…且下列程式碼執行…

s.events = rfl(s.events,"event24");

…s.events 的最終值將為：

s.events = "event22,event25";

範例 #2

若…

s.events = "event22,event24,event25";

…且下列程式碼執行…

s.events = rfl(s.events,"event26");

…s.events 的最終值將為：

s.events = "event22,event24,event25";

在此範例中，rfl 呼叫沒有對 s.events 做任何變更，因為 s.events 中不包含「event26」

範例 #3

若…

s.events = "event22,event24,event25";

…且下列程式碼執行…

s.events = rfl(s.events);

…s.events 的最終值將為：

s.events = "";

如果 rfl 呼叫中的 lv 引數或 vr 引數為空白，則外掛程式將不會傳回任何內容。

範例 #4

若…

s.prop4 = "hello|people|today";

…且下列程式碼執行…

s.eVar5 = rfl(s.prop4,"people","|");

…s.prop4 的最終值仍會是…

s.prop4 = "hello|people|today";

…但 s.eVar5 的最終值將為：

s.eVar5 = "hello|today";

請記得，外掛程式只會傳回值，實際上並不會「重設」透過 lv 引數傳入的變數。

範例 #5

若…

s.prop4 = "hello|people|today";

…且下列程式碼執行…

s.prop4 = rfl(s.prop4,"people");

…s.prop4 的最終值仍會是…

s.prop4 = "hello|people|today";

若 lv 引數值包含與預設值不同的分隔字元 (即逗號)，請務必設定 d1 引數。

範例 #6

若…

s.events = "event22,event23,event25";

…且下列程式碼執行…

s.events = rfl(s.events,"EVenT23");

…s.events 的最終值將為：

s.events = "event22,event23,event25";

雖然此範例並不實際，但呈現出傳入區分大小寫值的必要性。

範例 #7

若…

s.events = "event22,event23:12345,event25";

…且下列程式碼執行…

s.events = rfl(s.events,"event23");

…s.events 的最終值將為：

s.events = "event22,event25";

範例 #8

若…

s.events = "event22,event23:12345,event25";

…且下列程式碼執行…

s.events = rfl(s.events,"event23:12345");

…s.events 的最終值將為：

s.events = "event22,event23:12345,event25";

當您需要移除使用序列化及/或數值/貨幣語法的事件時，應該在 rfl 呼叫中僅指定事件本身 (亦即不含序列化/數值/貨幣值)。

範例 #9

若…

s.events = "event22,event23,event23,event23,event24,event25";

…且下列程式碼執行…

s.events = rfl(s.events,"event23");

…s.events 的最終值將為：

s.events = "event22,event24,event25");

範例 #10

若…

s.events = "event22,event23,event23,event23,event24,event25";

…且下列程式碼執行…

s.events = rfl(s.events,"event23", "", "",true);

…s.events 的最終值將為：

s.events = "event22,event23,event24,event25");

範例 #11

若…

s.events = "event22,event23,event23,event23,event24,event25";

…且下列程式碼執行…

s.events = rfl(s.events,"event23", "", "|",true);

…s.events 的最終值將為：

s.events = "event22|event23|event24|event25");

範例 #12

若…

s.events = "event22,event23,event24,event25";

…且下列程式碼執行…

s.events = rfl(s.events,"event23,event24");

…s.events 的最終值將為：

s.events = "event22,event23,event24,event25";

不支援在 vr 引數中設定多個值。 上述範例中，rfl 邏輯會先分割 lv 引數 (即 s.events) 中的值，然後嘗試比對每個分隔值與完整 vr 引數值 (即 "event23,event24")。

範例 #13

若…

s.events = "event22,event23,event24,event25";

…且下列程式碼執行…

s.events = rfl(s.events,"event23");
s.events = rfl(s.events,"event24");

…s.events 的最終值將為：

s.events = "event22,event25");

從清單中移除的每個值都應該包含在其自己的 rfl 呼叫中。

範例 #14

若…

s.linkTrackVars = "events,eVar1,eVar2,eVar3";

…且下列程式碼執行…

s.linkTrackVars = rfl(s.linkTrackVars,"eVar2", ",", ",", false);

…s.linkTrackVars 的最終值將為：

s.linkTrackVars = "events,eVar1,eVar3";

此 rfl 呼叫結尾的最後三個引數 (即「,」、「,」、false) 並非必要，但是也不會因為存在而「影響任何項目」，因為它們符合預設設定。

範例 #15

若…

s.events = "event22,event23,event24";

…且下列程式碼執行…

rfl(s.events,"event23");

…s.events 的最終值仍會是：

s.events = "event22,event23,event24";

再次強調，請記得外掛程式只會傳回值，實際上並不會「重設」透過 lv 引數傳入的變數。

版本記錄

2.1 (2021 年 3 月 19 日)

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

2.01 (2019 年 9 月 17 日)

• 預設分隔字元值的微幅錯誤修正

2.0 (2018 年 4 月 16 日)

• 單點發行 (重新編譯，程式碼大小較小)。
• 移除 join 外掛程式的必要性。

1.0 (2016 年 7 月 18 日)

• 首次發行。