Show Menu
主題×

核心擴充功能

核心擴充功能是隨 Launch 發行的預設擴充功能。
使用本參考文件,瞭解使用此擴充功能建立規則時可用的選項。

核心擴充功能事件類型

本主題說明核心擴充功能中可用的事件類型。
如需可針對多種不同事件類型設定的選項相關資訊,請參閱 選項

瀏覽器

標籤模糊

標籤失焦時觸發此動作。
此事件類型沒有設定。

標籤聚焦

標籤聚焦時觸發此動作。
此事件類型沒有設定。

表單

失焦

表單失焦時觸發此動作。
請參閱下方的 選項

聚焦

表單聚焦時觸發此動作。
請參閱下方的 選項

提交

表單提交時觸發此動作。
請參閱下方的 選項

鍵盤

按鍵點按

按下按鍵時觸發此事件。
請參閱下方的 選項

媒體

媒體已結束

媒體結束時觸發此動作。
請參閱下方的 選項

媒體已載入資料

媒體載入資料時觸發此動作。
請參閱下方的 選項

媒體暫停

媒體暫停時觸發此動作。
請參閱下方的 選項

媒體播放

媒體播放時觸發此動作。
請參閱下方的 選項

媒體已中止

媒體中止時觸發此事件。
請參閱下方的 選項

媒體已播放時間

若媒體播放了指定的時間長度,則觸發此事件。
請參閱下方的 選項
此外,可指定一段時間過後觸發此事件。

媒體音量變更

若音量提高或降低,則觸發此事件。
請參閱下方的 選項

行動

方向變更

若裝置的方向變更,則觸發此事件。
此事件類型沒有設定。
此外,可指定一段時間過後觸發此事件。

縮放變更

若使用者放大或縮小,則觸發此事件。
此事件類型沒有設定。

滑鼠

按一下

若點按指定的元素,則觸發此事件。
或者,您可以為元素指定在事件引發之前必須為 true 的屬性值。
如果元素為連結,您也可以指定是否要延遲導覽,直到規則執行。當您按一下核取方塊時,會開啟一個欄位,您可以在其中輸入所要的延遲時間 (毫秒)。這會指定在移到下一個頁面之前,Launch 等待標籤在已點擊連結上引發的時間長度。預設值為 100 毫秒。較長的延遲可改善追蹤準確性。Adobe 建議使用 500 毫秒或以內的延遲,使用者對此時間長度不會有感覺。Launch 將等待至指定的時間,但如果信標引發的速度更快,則會將延遲縮短。(也就是說,使用者不會一律等候到延遲的完整時間長度。)
此外,可指定一段時間過後觸發此事件。
如需進階選項,請參閱下方的 選項

游標暫留

若使用者將游標暫留在指定的元素上,則觸發此事件。
請參閱下方的 選項
此外,也可設定要立即觸發規則,還是在指定的毫秒數之後觸發。

其他

自訂事件

若自訂事件類型發生,則觸發此事件。
您可以為已在其他地方定義的 JavaScript 函數命名,並將其用於事件。
指定自訂事件類型的名稱,然後如下文 選項 中所述配置其他設定。

資料元素變更

若指定的資料元素變更,則觸發此事件。
輸入資料元素名稱。您可以按一下圖示,然後選取資料元素,從清單中選取資料元素。

直接呼叫

專為略過事件偵測和查閱系統而設計。
若要直接告訴 Launch 確切發生的狀況,直接呼叫規則是理想的選擇。另外,這類規則也非常適用於 Launch 無法偵測 DOM 中事件的情況 (例如使用 Adobe Flash 時)。
指定 _satellite.track 字串。

元素存在

若指定的元素存在,則觸發此事件。
請參閱下方的 選項

進入檢視區

若使用者進入指定的檢視區,則觸發此事件。
請參閱下方的 選項
此外,也可設定要立即觸發規則,還是在指定的毫秒數之後觸發。

歷史記錄變更

如果發生 pushState 或 hashchange,則觸發事件。
此事件類型沒有設定。

頁面逗留時間

若使用者在頁面上停留指定的秒數,則觸發此事件。
指定觸發事件之前須經過的秒數。

頁面載入

DOM 已就緒

當 DOM 就緒時觸發,使用者便可與頁面互動
此事件類型沒有設定。

程式庫已載入 (頁面頂端)

載入 Launch 程式庫後即觸發事件。
此事件類型沒有設定。

頁面底部

_satellite.pageBottom(); 一經呼叫,便觸發事件。以非同步方式載入 Launch 程式庫時,不應使用此事件類型。
此事件類型沒有設定。

視窗已載入

當瀏覽器呼叫 onLoad 且頁面載入完成時觸發事件。
此事件類型沒有設定。

選項

每個表單事件類型均使用下列設定:

特定元素 \| 任何元素

  • 如果選擇​ 「Specific Elements」 ,則會顯示選取元素和屬性值的選項。
  • 如果選擇​ 「Any Element」 ,則不需要進階選項來縮小元素。

符合 CSS 選擇器的元素

輸入可識別會觸發事件的元素之 CSS 選擇器。

且具有特定屬性值

若選取此選項,便可使用下列參數:
  • property=value
    指定屬性的值
  • Regex
    如果 property=value 為規則運算式,則啟用。
  • 新增
    新增另 property=value 組。

進階選項 (事件反昇)

  • 即使事件源自子系元素,仍執行此規則
  • 即使事件已觸發以子系元素為目標的規則,仍可執行此規則
  • 規則執行後,防止事件觸發以上階元素為目標的規則

核心擴充功能條件類型

本節說明核心擴充功能中可用的條件類型。

資料

自訂程式碼

指定必須存在作為事件條件的任何自訂程式碼。使用內建程式碼編輯器輸入自訂程式碼。
  1. 按一下 Open Editor
  2. 輸入自訂程式碼。
  3. 按一下 Save
名為 event 的變數會自動開放使用,以便您在自訂程式碼中參照。 event 物件將包含觸發規則之事件的實用資訊。要判斷哪些資料事件可供使用,最簡單的方式是將自訂程式碼中的 event 登錄到控制台:
console.log(event);
return true;

在瀏覽器中執行規則,並在瀏覽器控制台中檢查您所登錄的事件物件。了解哪些資訊可供使用後,就能在自訂程式碼時適度參考,做出程式設計決策。

值比較

比較兩個值以判斷此條件是否傳回 true。
如果規則具有多個條件,則可能因為其他條件評估為 false,或有一個例外評估為 true,造成此條件會傳回 true,但規則仍不會引發。
  1. 提供一個值。
  2. 選取運算子。請參閱下方的值比較運算子清單,以瞭解詳細資訊。
  3. (必要時) 選取比較是否應區分大小寫。
  4. 提供另一個值作為比較對象。
可使用下列的值比較運算子:
等於: 如果使用非嚴格 (non-strict) 比較,且兩值相等 (在 JavaScript 中為「==」運算子),則條件會傳回 true。值可為任何類型。在值欄位中輸入 true false null undefined 時,系統會將該字詞當成字串進行比較,且不會轉換為其 JavaScript 相等值。
不等於: 如果使用非嚴格 (non-strict) 比較,且兩值不相等 (在 JavaScript 中為「! =」運算子),則條件會傳回 true。值可為任何類型。在值欄位中輸入 true false null undefined 時,系統會將該字詞當成字串進行比較,且不會轉換為其 JavaScript 相等值。
包含: 如果第一個值包含第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 false。
不包含: 如果第一個值不包含第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值都會導致條件傳回 true。
開頭為: 如果第一個值開頭為第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 false。
開頭非為: 如果第一個值的開頭不是第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 true。
結尾為: 如果第一個值的結尾是第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 false。
結尾非為: 如果第一個值的結尾不是第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 true。
符合 Regex: 如果第一個值符合規則運算式,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 false。
不符合 Regex: 如果第一個值不符合規則運算式,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 true。
小於: 如果第一個值小於第二個值,則條件會傳回 true。代表數字的字串會轉換為數字。數字或可轉換字串以外的任何值都會導致條件傳回 false。
小於或等於: 如果第一個值小於或等於第二個值,則條件會傳回 true。代表數字的字串會轉換為數字。數字或可轉換字串以外的任何值都會導致條件傳回 false。
大於: 如果第一個值大於第二個值,則條件會傳回 true。代表數字的字串會轉換為數字。數字或可轉換字串以外的任何值都會導致條件傳回 false。
大於或等於: 如果第一個值大於或等於第二個值,則條件會傳回 true。代表數字的字串會轉換為數字。數字或可轉換字串以外的任何值都會導致條件傳回 false。
為 True: 如果值是布林值且為 true,則條件會傳回 true。若提供的值是任何其他類型,則不會轉換為布林值。帶有 true 值的布林值以外的任何值都會導致條件傳回 false。
為 Truthy: 如果值在轉換為布林值後為 true,條件會傳回 true。如需 Truthy 值的範例 ,請參閱 MDN 的 Truthy 文件
為 False: 如果值是布林值且為 false,則條件會傳回 true。若提供的值是任何其他類型,則不會轉換為布林值。帶有 false 值的布林值以外的任何值都會導致條件傳回 false。
為 Falsy: 如果值轉換為布林值後為 false,條件會傳回 true。如需 Falsy 值的範例 ,請參閱 MDN 的 Falsy 文件

變數

指定 JavaScript 變數名稱和哪個值必須存在,事件才會觸發動作。
  1. 指定 JavaScript 變數名稱。
  2. 指定必須存在作為事件條件的變數值。
  3. (選用) 若這是規則運算式,請啟用 Regex。

參與

登陸頁面

指定使用者必須在哪個頁面登陸才會觸發事件。
  1. 指定登陸頁面。
  2. (選用) 若這是規則運算式,請啟用 Regex。

新訪客/回訪訪客

指定訪客須為新訪客或舊訪客,事件才會觸發動作。
選取下列其中一項:
  • 新訪客
  • 回訪訪客

頁面檢視

設定觸發動作之前訪客必須檢視頁面幾次。
  1. 選擇頁面檢視次數必須大於、等於或小於指定值。
  2. 指定決定是否符合條件的頁面檢視次數。
  3. 選擇下列其中一項,設定計入頁面檢視次數的時間:
    • 期限
    • 目前的工作階段

工作階段

若使用者的工作階段數符合指定準則,則觸發動作。
  1. 選擇工作階段數必須大於、等於或小於指定值。
  2. 指定決定是否符合條件的工作階段數。

網站逗留時間

若使用者的工作階段數符合指定準則,則觸發動作。
設定訪客必須在網站上逗留多久才會觸發動作。
  1. 選取訪客在網站上逗留的分鐘數必須大於、等於或小於指定值。
  2. 指定決定是否符合條件的分鐘數。

流量來源

若使用者的工作階段數符合指定準則,則觸發動作。
指定訪客流量的來源必須為何才會觸發動作。
  1. 指定流量來源。
  2. (選用) 若這是規則運算式,請啟用 Regex。

其他

日期範圍

指定日期範圍。選擇事件發生之後的日期和時間、事件發生之前的日期,以及時區。

最大頻率

指定條件傳回 true 的次數上限。您可選取下列選項:
  • 頁面檢視
  • 工作階段
  • 訪客
  • 分鐘

取樣

指定條件傳回 true 的時間百分比。

技術

瀏覽器

選取訪客必須使用哪個瀏覽器才會觸發動作。
選取下列一或多個瀏覽器:
  • Chrome
  • Firefox
  • Internet Explorer/Edge
  • Internet Explorer Mobile
  • Mobile Safari
  • OmniWeb
  • Opera
  • Opera Mini
  • Opera Mobile
  • Safari

裝置類型

選取訪客必須使用哪種裝置類型才會觸發動作。
選取下列一或多種裝置類型:
  • Android
  • Blackberry
  • 桌面
  • iPad
  • iPhone
  • iPod
  • Nokia
  • Windows Phone

作業系統

選取訪客必須使用哪個作業系統才會觸發動作。
選取下列一或多個作業系統:
  • Android
  • Blackberry
  • iOS
  • Linux
  • MacOS
  • Maemo
  • Symbian OS
  • Unix
  • Windows

螢幕解析度

選取訪客必須在其裝置上使用哪種螢幕解析度才會觸發動作。
  1. 選取訪客裝置的螢幕解析度寬度必須大於、等於或小於指定值。
  2. 指定要求的螢幕解析度寬度像素。
  3. 選取訪客裝置的螢幕解析度高度必須大於、等於或小於指定值。
  4. 指定要求的螢幕解析度高度像素。

視窗大小

選取訪客必須在其裝置上使用多大的視窗才會觸發動作。
  1. 選取訪客裝置的視窗大小寬度是否必須大於、等於或小於指定值。
  2. 指定要求的視窗大小寬度像素。
  3. 選取訪客裝置的視窗大小高度必須大於、等於或小於指定值。
  4. 指定要求的視窗大小高度像素。

URL

網域

指定訪客的網域。

雜湊

指定 URL 中必須存在的一或多個雜湊模式。
您可使用 OR 聯結多個雜湊模式。
  1. 指定雜湊模式。
  2. (選用) 若這是規則運算式,請啟用 Regex。
  3. 新增任何其他雜湊模式。

路徑

指定 URL 中必須存在的一或多個路徑。
您可使用 OR 聯結多個路徑。
  1. 指定路徑。
  2. (選用) 若這是規則運算式,請啟用 Regex。
  3. 新增任何其他路徑。

通訊協定

指定 URL 中使用的通訊協定。
選取下列其中一項:
  • HTTP
  • HTTPS

子網域

指定 URL 中必須存在的一或多個子網域。
您可使用 OR 聯結多個子網域。
  1. 指定子網域。
  2. (選用) 若這是規則運算式,請啟用 Regex。
  3. 新增任何其他子網域。

URL 參數

指定 URL 中使用的 URL 參數。
  1. 指定 URL 參數名稱。
  2. 指定用於 URL 參數的值。
  3. (選用) 若這是規則運算式,請啟用 Regex。

核心擴充功能例外狀況類型

本節說明核心擴充功能中可用的例外狀況類型。

資料

自訂程式碼

指定必須存在作為事件條件的任何自訂程式碼。使用內建程式碼編輯器輸入自訂程式碼。
  1. 按一下 Open Editor
  2. 輸入自訂程式碼。
  3. 按一下 Save
名為 event 的變數會自動開放使用,以便您在自訂程式碼中參照。 event 物件將包含觸發規則之事件的實用資訊。要判斷哪些資料事件可供使用,最簡單的方式是將自訂程式碼中的 event 登錄到控制台:
console.log(event);
return true;

在瀏覽器中執行規則,並在瀏覽器控制台中檢查您所登錄的事件物件。了解哪些資訊可供使用後,就能在自訂程式碼時適度參考,做出程式設計決策。

值比較

比較兩個值以判斷此例外是否傳回 true。
如果規則具有多個條件,則可能因為其他條件評估為 false,或有一個例外評估為 true,造成此條件會傳回 true,但規則仍不會引發。
  1. 提供一個值。
  2. 選取運算子。請參閱下方的值比較運算子清單,以瞭解詳細資訊。
  3. (必要時) 選取比較是否應區分大小寫。
  4. 提供另一個值作為比較對象。
可使用下列的值比較運算子:
等於: 如果使用非嚴格 (non-strict) 比較,且兩值相等 (在 JavaScript 中為「==」運算子),則條件會傳回 true。值可為任何類型。在值欄位中輸入 true false null undefined 時,系統會將該字詞當成字串進行比較,且不會轉換為其 JavaScript 相等值。
不等於: 如果使用非嚴格 (non-strict) 比較,且兩值不相等 (在 JavaScript 中為「! =」運算子),則條件會傳回 true。值可為任何類型。在值欄位中輸入 true false null undefined 時,系統會將該字詞當成字串進行比較,且不會轉換為其 JavaScript 相等值。
包含: 如果第一個值包含第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 false。
不包含: 如果第一個值不包含第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值都會導致條件傳回 true。
開頭為: 如果第一個值開頭為第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 false。
開頭非為: 如果第一個值的開頭不是第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 true。
結尾為: 如果第一個值的結尾是第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 false。
結尾非為: 如果第一個值的結尾不是第二個值,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 true。
符合 Regex: 如果第一個值符合規則運算式,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 false。
不符合 Regex: 如果第一個值不符合規則運算式,則條件會傳回 true。數字會轉換為字串。數字或字串以外的任何值會都導致條件傳回 true。
小於: 如果第一個值小於第二個值,則條件會傳回 true。代表數字的字串會轉換為數字。數字或可轉換字串以外的任何值都會導致條件傳回 false。
小於或等於: 如果第一個值小於或等於第二個值,則條件會傳回 true。代表數字的字串會轉換為數字。數字或可轉換字串以外的任何值都會導致條件傳回 false。
大於: 如果第一個值大於第二個值,則條件會傳回 true。代表數字的字串會轉換為數字。數字或可轉換字串以外的任何值都會導致條件傳回 false。
大於或等於: 如果第一個值大於或等於第二個值,則條件會傳回 true。代表數字的字串會轉換為數字。數字或可轉換字串以外的任何值都會導致條件傳回 false。
為 True: 如果值是布林值且為 true,則條件會傳回 true。若提供的值是任何其他類型,則不會轉換為布林值。帶有 true 值的布林值以外的任何值都會導致條件傳回 false。
為 Truthy: 如果值在轉換為布林值後為 true,條件會傳回 true。如需 Truthy 值的範例 ,請參閱 MDN 的 Truthy 文件
為 False: 如果值是布林值且為 false,則條件會傳回 true。若提供的值是任何其他類型,則不會轉換為布林值。帶有 false 值的布林值以外的任何值都會導致條件傳回 false。
為 Falsy: 如果值轉換為布林值後為 false,條件會傳回 true。如需 Falsy 值的範例 ,請參閱 MDN 的 Falsy 文件

變數

指定 JavaScript 變數名稱和哪個值不得存在,事件才會觸發動作。
  1. 指定 JavaScript 變數名稱。
  2. 指定不得存在作為事件條件的變數值。
  3. (選用) 若這是規則運算式,請啟用 Regex。

參與

登陸頁面

指定使用者不得在哪個頁面登陸才會觸發事件。
  1. 指定登陸頁面。
  2. (選用) 若這是規則運算式,請啟用 Regex。

新訪客/回訪訪客

指定訪客不得為新訪客或舊訪客,事件才會觸發動作。
選取下列其中一項:
  • 新訪客
  • 回訪訪客

頁面檢視

設定訪客必須檢視頁面幾次才會阻止動作觸發。
  1. 選擇頁面檢視次數必須大於、等於或小於指定值。
  2. 指定決定是否符合例外狀況的頁面檢視次數。
  3. 選擇下列其中一項,設定計入頁面檢視次數的時間:
    • 期限
    • 目前的工作階段

工作階段

若使用者的工作階段數符合指定準則,則不觸發動作。
  1. 選擇工作階段數必須大於、等於或小於指定值。
  2. 指定決定是否符合條件的工作階段數。

網站逗留時間

設定訪客必須在網站上逗留多久才會阻止動作觸發。
  1. 選取訪客在網站上逗留的分鐘數必須大於、等於或小於指定值。
  2. 指定決定是否符合條件的分鐘數。

流量來源

指定訪客流量的來源必須為何才會阻止動作觸發。
  1. 指定流量來源。
  2. (選用) 若這是規則運算式,請啟用 Regex。

其他

日期範圍

指定日期範圍。選擇事件發生之後的日期和時間、事件發生之前的日期,以及時區。

最大頻率

指定條件傳回 true 的次數上限。您可選取下列選項:
  • 頁面檢視
  • 工作階段
  • 訪客
  • 分鐘

取樣

指定條件傳回 true 的時間百分比。

技術

瀏覽器

選取訪客不得使用哪個瀏覽器才會觸發動作。
選取下列一或多個瀏覽器:
  • Chrome
  • Firefox
  • Internet Explorer/Edge
  • Internet Explorer Mobile
  • Mobile Safari
  • OmniWeb
  • Opera
  • Opera Mini
  • Opera Mobile
  • Safari

裝置類型

選取訪客不得使用哪種裝置類型才會觸發動作。
選取下列一或多種裝置類型:
  • Android
  • Blackberry
  • 桌面
  • iPad
  • iPhone
  • iPod
  • Nokia
  • Windows Phone

作業系統

選取訪客不得使用哪個作業系統才會觸發動作。
選取下列一或多個作業系統:
  • Android
  • Blackberry
  • iOS
  • Linux
  • MacOS
  • Maemo
  • Symbian OS
  • Unix
  • Windows

螢幕解析度

選取訪客不得在其裝置上使用哪種螢幕解析度才會觸發動作。
  1. 選取訪客裝置的螢幕解析度寬度必須大於、等於或小於指定值。
  2. 指定要求的螢幕解析度寬度像素。
  3. 選取訪客裝置的螢幕解析度高度必須大於、等於或小於指定值。
  4. 指定要求的螢幕解析度高度像素。

視窗大小

選取訪客不得在其裝置上使用多大的視窗才會觸發動作。
  1. 選取訪客裝置的視窗大小寬度是否必須大於、等於或小於指定值。
  2. 指定要求的視窗大小寬度像素。
  3. 選取訪客裝置的視窗大小高度必須大於、等於或小於指定值。
  4. 指定要求的視窗大小高度像素。

URL

網域

指定會阻止動作觸發的訪客網域。

雜湊

指定 URL 中不得存在的一或多個雜湊模式。
您可使用 OR 聯結多個雜湊模式。
  1. 指定雜湊模式。
  2. (選用) 若這是規則運算式,請啟用 Regex。
  3. 新增任何其他雜湊模式。

路徑

指定 URL 中不得存在的一或多個路徑。
您可使用 OR 聯結多個路徑。
  1. 指定路徑。
  2. (選用) 若這是規則運算式,請啟用 Regex。
  3. 新增任何其他路徑。

通訊協定

指定不得在 URL 中使用的通訊協定。
選取下列其中一項:
  • HTTP
  • HTTPS

子網域

指定 URL 中不得存在的一或多個子網域。
您可使用 OR 聯結多個子網域。
  1. 指定子網域。
  2. (選用) 若這是規則運算式,請啟用 Regex。
  3. 新增任何其他子網域。

URL 參數

指定不得在 URL 中使用的 URL 參數。
  1. 指定 URL 參數名稱。
  2. 指定用於 URL 參數的值。
  3. (選用) 若這是規則運算式,請啟用 Regex。

核心擴充功能動作類型

本節說明核心擴充功能中可用的動作類型。

自訂程式碼

提供觸發事件和評估條件後執行的程式碼。
  1. 為動作程式碼命名。
  2. 選取用來定義動作的語言:
    • JavaScript
    • HTML
  3. 選取是否要全域執行動作程式碼。
  4. 按一下「開啟編輯器」。
  5. 編輯程式碼,然後按一下 Save。
當您選取 JavaScript 作為程式語言時,名為 event 的變數會自動開放使用,以便您在自訂程式碼中參照。 event 物件將包含觸發規則之事件的實用資訊。要判斷哪些資料事件可供使用,最簡單的方式是將自訂程式碼中的 event 登錄到控制台:
console.log(event);

在瀏覽器中執行規則,並在瀏覽器控制台中檢查您所登錄的事件物件。了解哪些資訊可供使用後,就能在自訂程式碼時適度參考,以便做出程式設計決策、傳送 event 物件的片段到伺服器等等。

自訂程式碼動作處理

核心擴充功能適用於所有 Launch 使用者,其中包含用於執行使用者所提供 JavaScript 或 HTML 的自訂程式碼動作。通常可幫助使用者瞭解系統如何處理具有自訂程式碼動作的規則。

使用 page top 或 page bottom 事件的規則

自訂動作的程式碼內嵌於主要 Launch 程式庫中。需用 document.write 將程式碼寫入文件中。若規則中有多個自訂程式碼動作,則會按照規則中設定的順序寫入程式碼。

使用 page top 或 page bottom 以外任何事件的規則

自訂動作的程式碼會從伺服器載入,並使用 Postscribe 寫入文件中。若規則中有多個自訂程式碼動作,則會同時從伺服器載入程式碼,但按照規則設定的順序寫入。
雖然在頁面載入後使用 document.write 通常會出現問題,但這不是透過「自訂程式碼」動作提供的程式碼所造成的問題。無論程式碼執行的時機為何,您都可以在「自訂程式碼」動作中使用 document.write。

自訂程式碼驗證

Launch 程式碼編輯器中使用的驗證器,專門用於識別開發人員所編寫程式碼的問題。經過縮製程序的程式碼 (例如從程式碼管理員下載的 AppMeasurement.js 程式碼) 可能會被 Launch 驗證器誤判而標示為有問題,通常可予以忽略。

核心擴充功能資料元素類型

資料元素類型由擴充功能決定。可建立的類型沒有限制。
以下各節會說明核心擴充功能中可用的資料元素類型。其他擴充功能則使用其他類型的資料元素。

常數

之後可在動作或條件中參考的任何常數字串值。

範例:

string

自訂程式碼

在 UI 中可以按一下「開啟編輯器」,然後在編輯器視窗中插入代碼,來輸入自訂 JavaScript。
編輯器視窗中須有傳回陳述式,才能指出應該作為資料元素值使用的值。如果未包含傳回陳述式或傳回 null undefined 值,則資料元素的預設值會作為資料元素值使用。
範例:
var pageType = $('div.page-wrapper').attr('class').split('')[1];
if (window.location.pathname == '/') {
  return 'homepage';
} else {
  return pageType;
}

如果自訂程式碼資料元素是在執行規則期間所擷取,則名為 event 的變數會自動開放使用,以便您在自訂程式碼中參照。 event 物件將包含觸發規則之事件的實用資訊。要判斷哪些資料事件可供使用,最簡單的方式是將自訂程式碼中的 event 登錄到控制台:
console.log(event);
return true;

在瀏覽器中執行規則,並在瀏覽器控制台中檢查您所登錄的事件物件。了解可能會使用您資料元素的各種規則中,有哪些資訊可供使用之後,就能在自訂程式碼時參考,以便做出程式設計決策,或將 event 物件的片段作為資料元素的值傳回。

DOM 屬性

任何可擷取的元素值,例如 div 或 H1 標籤。

範例:

CSS 選擇器鏈結:
id#dc logo img
取得下列項目的值:
src

JavaScript 變數

任何可用的 JavaScript 物件或變數可使用下列路徑欄位參照。
當您的標記中有 JavaScript 變數或物件屬性,且希望將這些值收集到 Launch 以用於任何擴充功能或規則時,您可以在 Launch 中使用資料元素來擷取這些,這是其中一個方法。這樣的話,您可以在全部規則中參照資料元素,而如果資料來源有所變更,您只需在 Launch 的單一位置變更來源的參照 (資料元素) 即可。
例如,假設您的標記包含稱為 Page_Name 的 JavaScript 變數,如下所示:
<script>
  //data layer
  var Page_Name = "Homepage"
</script>

當您在 Launch 中建立資料元素時,只需提供該變數的路徑。
如果您使用資料收集器物件作為資料層的一方,只需在路徑中使用點記號來參照您要擷取到資料元素中的物件和屬性,如 _myData.pageName digitalData.pageName 等等。

範例:

window.document.title

本機儲存

在「本機儲存項目名稱」欄位中提供本機儲存項目的名稱。
本機儲存讓瀏覽器能在頁面之間儲存資訊 ( https://www.w3schools.com/html/html5_webstorage.asp )。本機儲存的運作方式與 Cookie 類似,但更大也更有彈性。
使用提供的欄位來指定您為本機儲存項目建立的值,例如 lastProductViewed.

頁面資訊

使用這些資料點來擷取頁面資訊,以便用於規則邏輯或者傳送資訊至 Analytics 或外部追蹤系統。
您可以選取下列其中一個頁面屬性以用於資料元素:
  • URL
  • 主機名稱
  • 路徑名稱
  • 通訊協定
  • 反向連結
  • 標題

查詢字串參數

在「URL 參數」欄位中指定單一 URL 參數。
只需指定名稱部分,任何特殊指示項 (如 "?"或 "=") 應加以省略

範例:

contentType

隨機數字

使用此資料元素產生隨機數字。它通常用於取樣資料或建立 ID,例如點擊 ID。隨機數字也可用來模糊化敏感性資料,或對其進行 Salt 處理。某些範例可能包括:
  • 產生點擊 ID
  • 將數字串聯至使用者代號或時間戳記以確保獨特性
  • 對 PII 資料執行單向雜湊
  • 隨機決定在網站上顯示調查請求的時機
指定隨機數字的最小值和最大值。
預設值:
最小: 0
最大: 1000000000

工作階段儲存

在「工作階段儲存項目名稱」欄位中提供工作階段儲存項目的名稱。
工作階段儲存與本機儲存類似,除了在工作階段結束後會捨棄資料,但本機儲存或 Cookie 可能會保留資料。

訪客行為

與「頁面資訊」類似,此資料元素使用一般行為類型,在規則或資料收集中擴充邏輯。
選取下列其中一個訪客行為屬性:
  • 登陸頁面
  • 流量來源
  • 網站逗留分鐘數
  • 工作階段計數
  • 工作階段頁面檢視計數
  • 期限頁面檢視計數
  • 新訪客身分
常見的使用案例包括:
  • 訪客在網站逗留 5 分鐘後顯示調查
  • 如果這是造訪的登陸頁面,請填入 Analytics 量度
  • 在 X 次工作階段計數後向訪客顯示新活動內容
  • 若為首次訪客,顯示電子報註冊