Triggers

如需本資源的方法清單,請見本頁結尾。

資源表示法

代表 Google 代碼管理工具觸發條件

{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "triggerId": string,
  "name": string,
  "type": string,
  "customEventFilter": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ],
          "isWeakReference": boolean
        }
      ]
    }
  ],
  "filter": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ],
          "isWeakReference": boolean
        }
      ]
    }
  ],
  "autoEventFilter": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ],
          "isWeakReference": boolean
        }
      ]
    }
  ],
  "waitForTags": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "checkValidation": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "waitForTagsTimeout": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "uniqueTriggerId": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "eventName": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "interval": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "limit": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "fingerprint": string,
  "parentFolderId": string,
  "selector": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "intervalSeconds": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "maxTimerLengthSeconds": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "verticalScrollPercentageList": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "horizontalScrollPercentageList": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "visibilitySelector": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "visiblePercentageMin": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "visiblePercentageMax": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "continuousTimeMinMilliseconds": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "totalTimeMinMilliseconds": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "tagManagerUrl": string,
  "notes": string,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    }
  ]
}
資源名稱 說明 附註
accountId string GTM 帳戶 ID。
autoEventFilter[] list 用於自動事件追蹤。 可寫入
autoEventFilter[].parameter[] list 根據條件類型而定的已命名參數 (鍵/值) 清單。附註:
  • 針對二進位運算子,請加入名為 arg0arg1 的參數,分別指定左右運算元。
  • 目前,左運算元 (arg0) 必須是變數的參照。
  • 對於不區分大小寫的規則運算式比對,請加入名為 ignore_case 的布林值參數,並設為 true。如未指定或設為任何其他值,比對會區分大小寫。
  • 如要否定運算子,請加入名為 negate 布林參數的布林值參數,並設為 true
可寫入
autoEventFilter[].parameter[].isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
autoEventFilter[].parameter[].key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
autoEventFilter[].parameter[].list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
autoEventFilter[].parameter[].map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
autoEventFilter[].parameter[].type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
autoEventFilter[].parameter[].value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
autoEventFilter[].type string 此條件的運算子類型。

可接受的值為:
  • "conditionTypeUnspecified"
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
可寫入
checkValidation nested object 是否只有在其他事件處理常式 (例如驗證後) 未取消提交表單或連結點擊事件的情況下,才應觸發代碼。僅適用於「表單提交」和「連結點擊」觸發條件。 可寫入
checkValidation.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
checkValidation.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
checkValidation.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
checkValidation.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
checkValidation.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
checkValidation.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
containerId string GTM 容器 ID。
continuousTimeMinMilliseconds nested object 瀏覽權限觸發條件的連續顯示時間下限 (以毫秒為單位)。僅適用於 AMP 瀏覽權限觸發條件。 可寫入
continuousTimeMinMilliseconds.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
continuousTimeMinMilliseconds.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
continuousTimeMinMilliseconds.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
continuousTimeMinMilliseconds.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
continuousTimeMinMilliseconds.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
continuousTimeMinMilliseconds.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
customEventFilter[] list 用於自訂事件,在所有條件為 True 時觸發。 可寫入
customEventFilter[].parameter[] list 根據條件類型而定的已命名參數 (鍵/值) 清單。附註:
  • 針對二進位運算子,請加入名為 arg0arg1 的參數,分別指定左右運算元。
  • 目前,左運算元 (arg0) 必須是變數的參照。
  • 對於不區分大小寫的規則運算式比對,請加入名為 ignore_case 的布林值參數,並設為 true。如未指定或設為任何其他值,比對會區分大小寫。
  • 如要否定運算子,請加入名為 negate 布林參數的布林值參數,並設為 true
可寫入
customEventFilter[].parameter[].isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
customEventFilter[].parameter[].key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
customEventFilter[].parameter[].list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
customEventFilter[].parameter[].map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
customEventFilter[].parameter[].type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
customEventFilter[].parameter[].value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
customEventFilter[].type string 此條件的運算子類型。

可接受的值為:
  • "conditionTypeUnspecified"
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
可寫入
eventName nested object 所觸發 GTM 事件的名稱。僅適用於計時器觸發條件。 可寫入
eventName.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
eventName.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
eventName.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
eventName.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
eventName.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
eventName.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
filter[] list 只有在所有條件都符合時,觸發條件才會啟動。 可寫入
filter[].parameter[] list 根據條件類型而定的已命名參數 (鍵/值) 清單。附註:
  • 針對二進位運算子,請加入名為 arg0arg1 的參數,分別指定左右運算元。
  • 目前,左運算元 (arg0) 必須是變數的參照。
  • 對於不區分大小寫的規則運算式比對,請加入名為 ignore_case 的布林值參數,並設為 true。如未指定或設為任何其他值,比對會區分大小寫。
  • 如要否定運算子,請加入名為 negate 布林參數的布林值參數,並設為 true
可寫入
filter[].parameter[].isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
filter[].parameter[].key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
filter[].parameter[].list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
filter[].parameter[].map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
filter[].parameter[].type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
filter[].parameter[].value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
filter[].type string 此條件的運算子類型。

可接受的值為:
  • "conditionTypeUnspecified"
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
可寫入
fingerprint string 儲存時計算的 GTM 觸發條件指紋。每次修改觸發條件時,系統都會重新計算這個值。
horizontalScrollPercentageList nested object 捲動觸發條件的整數百分比值清單。水平捲動瀏覽各百分比時,觸發條件就會啟動。僅適用於 AMP 捲動觸發條件。 可寫入
horizontalScrollPercentageList.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
horizontalScrollPercentageList.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
horizontalScrollPercentageList.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
horizontalScrollPercentageList.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
horizontalScrollPercentageList.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
horizontalScrollPercentageList.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
interval nested object 觸發週期性計時器事件的間隔時間 (以毫秒為單位)。僅適用於計時器觸發條件。 可寫入
interval.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
interval.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
interval.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
interval.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
interval.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
interval.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
intervalSeconds nested object 觸發計時器事件的間隔時間 (以秒為單位)。僅適用於 AMP 計時器觸發條件。 可寫入
intervalSeconds.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
intervalSeconds.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
intervalSeconds.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
intervalSeconds.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
intervalSeconds.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
intervalSeconds.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
limit nested object 限制這個計時器觸發條件要觸發的 GTM 事件數量。如未設定限制,我們會繼續觸發 GTM 事件,直到使用者離開網頁為止。僅適用於計時器觸發條件。 可寫入
limit.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
limit.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
limit.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
limit.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
limit.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
limit.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
maxTimerLengthSeconds nested object 觸發計時器事件的最長時間 (以秒為單位)。僅適用於 AMP 計時器觸發條件。 可寫入
maxTimerLengthSeconds.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
maxTimerLengthSeconds.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
maxTimerLengthSeconds.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
maxTimerLengthSeconds.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
maxTimerLengthSeconds.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
maxTimerLengthSeconds.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
name string 觸發條件顯示名稱。 可寫入
notes string 使用者在容器中套用這個觸發條件的附註。 可寫入
parameter[] list 其他參數。 可寫入
parameter[].isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
parameter[].key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
parameter[].list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
parameter[].map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
parameter[].type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
parameter[].value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
parentFolderId string 上層資料夾 ID。
path string GTM 觸發條件的 API 相對路徑。
selector nested object 點擊觸發條件 CSS 選取器 (例如「a」、「按鈕」等)。僅適用於 AMP 點擊觸發條件。 可寫入
selector.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
selector.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
selector.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
selector.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
selector.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
selector.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
tagManagerUrl string 自動產生的代碼管理工具使用者介面連結
totalTimeMinMilliseconds nested object 顯示設定觸發條件的最少可視時間總數 (以毫秒為單位)。僅適用於 AMP 瀏覽權限觸發條件。 可寫入
totalTimeMinMilliseconds.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
totalTimeMinMilliseconds.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
totalTimeMinMilliseconds.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
totalTimeMinMilliseconds.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
totalTimeMinMilliseconds.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
totalTimeMinMilliseconds.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
triggerId string 觸發條件 ID 可用來識別 GTM 觸發條件。
type string 定義導致此觸發條件的資料層事件。

可接受的值為:
  • "always"
  • "ampClick"
  • "ampScroll"
  • "ampTimer"
  • "ampVisibility"
  • "click"
  • "consentInit"
  • "customEvent"
  • "domReady"
  • "elementVisibility"
  • "eventTypeUnspecified"
  • "firebaseAppException"
  • "firebaseAppUpdate"
  • "firebaseCampaign"
  • "firebaseFirstOpen"
  • "firebaseInAppPurchase"
  • "firebaseNotificationDismiss"
  • "firebaseNotificationForeground"
  • "firebaseNotificationOpen"
  • "firebaseNotificationReceive"
  • "firebaseOsUpdate"
  • "firebaseSessionStart"
  • "firebaseUserEngagement"
  • "formSubmission"
  • "historyChange"
  • "init"
  • "jsError"
  • "linkClick"
  • "pageview"
  • "scrollDepth"
  • "serverPageview"
  • "timer"
  • "triggerGroup"
  • "windowLoaded"
  • "youTubeVideo"
可寫入
uniqueTriggerId nested object 自動產生此觸發條件 (「表單提交」、「連結點擊」或「計時器」事件監聽器) 的全域專屬 ID (如果有的話)。用於讓不相容的自動事件,搭配觸發條件 ID 的觸發條件篩選功能搭配使用。在產生輸出時填入這個值,因為觸發條件所隱含的代碼必須等到之後才存在。僅適用於表單提交、連結點擊和計時器觸發條件。 可寫入
uniqueTriggerId.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
uniqueTriggerId.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
uniqueTriggerId.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
uniqueTriggerId.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
uniqueTriggerId.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
uniqueTriggerId.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
verticalScrollPercentageList nested object 捲動觸發條件的整數百分比值清單。以垂直捲動方式捲動瀏覽皆達到每個百分比時,觸發條件就會啟動。僅適用於 AMP 捲動觸發條件。 可寫入
verticalScrollPercentageList.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
verticalScrollPercentageList.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
verticalScrollPercentageList.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
verticalScrollPercentageList.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
verticalScrollPercentageList.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
verticalScrollPercentageList.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
visibilitySelector nested object 瀏覽權限觸發條件 CSS 選取器 (例如「#id」)。僅適用於 AMP 瀏覽權限觸發條件。 可寫入
visibilitySelector.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
visibilitySelector.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
visibilitySelector.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
visibilitySelector.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
visibilitySelector.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
visibilitySelector.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
visiblePercentageMax nested object 瀏覽權限觸發條件百分比設定上限。僅適用於 AMP 瀏覽權限觸發條件。 可寫入
visiblePercentageMax.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
visiblePercentageMax.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
visiblePercentageMax.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
visiblePercentageMax.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
visiblePercentageMax.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
visiblePercentageMax.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
visiblePercentageMin nested object 可見度觸發條件的最低顯示設定百分比。僅適用於 AMP 瀏覽權限觸發條件。 可寫入
visiblePercentageMin.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
visiblePercentageMin.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
visiblePercentageMin.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
visiblePercentageMin.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
visiblePercentageMin.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
visiblePercentageMin.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
waitForTags nested object 是否應將提交表單或連結開啟時間延後到所有代碼都觸發為止 (避免預設動作,之後再模擬預設動作)。僅適用於「表單提交」和「連結點擊」觸發條件。 可寫入
waitForTags.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
waitForTags.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
waitForTags.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
waitForTags.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
waitForTags.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
waitForTags.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
waitForTagsTimeout nested object 當上述「waits_for_tags」評估為 true 時,代碼要觸發的時間長度 (以毫秒為單位)。僅適用於「表單提交」和「連結點擊」觸發條件。 可寫入
waitForTagsTimeout.isWeakReference boolean 是否強烈參照參照類型參數。只會由轉換使用。 可寫入
waitForTagsTimeout.key string 唯一識別參數的已命名鍵。必須用於頂層參數和對應值。清單值會忽略。 可寫入
waitForTagsTimeout.list[] list 此清單參數的參數 (系統會忽略鍵)。 可寫入
waitForTagsTimeout.map[] list 此對應參數的參數 (必須有鍵,鍵不得重複)。 可寫入
waitForTagsTimeout.type string 參數類型。有效值如下:
  • boolean:這個值代表布林值,以「true」或「false」表示
  • integer:這個值代表 64 位元的帶正負號整數值,以 10 為底數
  • list:應指定參數清單
  • map:應指定參數對應
  • template:此值代表任何文字,可能包含變數參照 (甚至是可能會傳回非字串類型的變數參照)
  • trigger_reference:這個值代表觸發條件,以觸發條件 ID 表示
  • tag_reference:這個值代表標記,以標記名稱表示


可接受的值為:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
可寫入
waitForTagsTimeout.value string 適合指定類型的參數值 (可能包含「」等變數參照。 可寫入
workspaceId string GTM 工作區 ID。

方法

建立
建立 GTM 觸發條件。
刪除
刪除 GTM 觸發條件。
取得
取得 GTM 觸發條件。
list
列出容器的所有 GTM 觸發條件。
revert
在 GTM 工作區中還原對 GTM 觸發條件的變更。
更新
更新 GTM 觸發條件。