For a list of methods for this resource, see the end of this page.
Resource representations
Represents a Google Tag Manager Trigger
{ "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 } ] }
Property name | Value | Description | Notes |
---|---|---|---|
accountId |
string |
GTM Account ID. | |
autoEventFilter[] |
list |
Used in the case of auto event tracking. | writable |
autoEventFilter[].parameter[] |
list |
A list of named parameters (key/value), depending on the condition's type. Notes:
|
writable |
autoEventFilter[].parameter[].isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
autoEventFilter[].parameter[].key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
autoEventFilter[].parameter[].list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
autoEventFilter[].parameter[].map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
autoEventFilter[].parameter[].type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
autoEventFilter[].parameter[].value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
autoEventFilter[].type |
string |
The type of operator for this condition.
Acceptable values are:
|
writable |
checkValidation |
nested object |
Whether or not we should only fire tags if the form submit or link click event is not cancelled by some other event handler (e.g. because of validation). Only valid for Form Submission and Link Click triggers. | writable |
checkValidation.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
checkValidation.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
checkValidation.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
checkValidation.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
checkValidation.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
checkValidation.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
containerId |
string |
GTM Container ID. | |
continuousTimeMinMilliseconds |
nested object |
A visibility trigger minimum continuous visible time (in milliseconds). Only valid for AMP Visibility trigger. | writable |
continuousTimeMinMilliseconds.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
continuousTimeMinMilliseconds.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
continuousTimeMinMilliseconds.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
continuousTimeMinMilliseconds.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
continuousTimeMinMilliseconds.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
continuousTimeMinMilliseconds.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
customEventFilter[] |
list |
Used in the case of custom event, which is fired iff all Conditions are true. | writable |
customEventFilter[].parameter[] |
list |
A list of named parameters (key/value), depending on the condition's type. Notes:
|
writable |
customEventFilter[].parameter[].isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
customEventFilter[].parameter[].key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
customEventFilter[].parameter[].list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
customEventFilter[].parameter[].map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
customEventFilter[].parameter[].type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
customEventFilter[].parameter[].value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
customEventFilter[].type |
string |
The type of operator for this condition.
Acceptable values are:
|
writable |
eventName |
nested object |
Name of the GTM event that is fired. Only valid for Timer triggers. | writable |
eventName.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
eventName.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
eventName.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
eventName.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
eventName.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
eventName.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
filter[] |
list |
The trigger will only fire iff all Conditions are true. | writable |
filter[].parameter[] |
list |
A list of named parameters (key/value), depending on the condition's type. Notes:
|
writable |
filter[].parameter[].isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
filter[].parameter[].key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
filter[].parameter[].list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
filter[].parameter[].map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
filter[].parameter[].type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
filter[].parameter[].value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
filter[].type |
string |
The type of operator for this condition.
Acceptable values are:
|
writable |
fingerprint |
string |
The fingerprint of the GTM Trigger as computed at storage time. This value is recomputed whenever the trigger is modified. | |
horizontalScrollPercentageList |
nested object |
List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled horizontally. Only valid for AMP scroll triggers. | writable |
horizontalScrollPercentageList.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
horizontalScrollPercentageList.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
horizontalScrollPercentageList.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
horizontalScrollPercentageList.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
horizontalScrollPercentageList.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
horizontalScrollPercentageList.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
interval |
nested object |
Time between triggering recurring Timer Events (in milliseconds). Only valid for Timer triggers. | writable |
interval.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
interval.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
interval.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
interval.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
interval.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
interval.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
intervalSeconds |
nested object |
Time between Timer Events to fire (in seconds). Only valid for AMP Timer trigger. | writable |
intervalSeconds.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
intervalSeconds.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
intervalSeconds.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
intervalSeconds.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
intervalSeconds.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
intervalSeconds.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
limit |
nested object |
Limit of the number of GTM events this Timer Trigger will fire. If no limit is set, we will continue to fire GTM events until the user leaves the page. Only valid for Timer triggers. | writable |
limit.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
limit.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
limit.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
limit.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
limit.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
limit.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
maxTimerLengthSeconds |
nested object |
Max time to fire Timer Events (in seconds). Only valid for AMP Timer trigger. | writable |
maxTimerLengthSeconds.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
maxTimerLengthSeconds.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
maxTimerLengthSeconds.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
maxTimerLengthSeconds.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
maxTimerLengthSeconds.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
maxTimerLengthSeconds.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
name |
string |
Trigger display name. | writable |
notes |
string |
User notes on how to apply this trigger in the container. | writable |
parameter[] |
list |
Additional parameters. | writable |
parameter[].isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
parameter[].key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
parameter[].list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
parameter[].map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
parameter[].type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
parameter[].value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
parentFolderId |
string |
Parent folder id. | |
path |
string |
GTM Trigger's API relative path. | |
selector |
nested object |
A click trigger CSS selector (i.e. "a", "button" etc.). Only valid for AMP Click trigger. | writable |
selector.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
selector.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
selector.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
selector.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
selector.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
selector.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
tagManagerUrl |
string |
Auto generated link to the tag manager UI | |
totalTimeMinMilliseconds |
nested object |
A visibility trigger minimum total visible time (in milliseconds). Only valid for AMP Visibility trigger. | writable |
totalTimeMinMilliseconds.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
totalTimeMinMilliseconds.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
totalTimeMinMilliseconds.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
totalTimeMinMilliseconds.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
totalTimeMinMilliseconds.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
totalTimeMinMilliseconds.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
triggerId |
string |
The Trigger ID uniquely identifies the GTM Trigger. | |
type |
string |
Defines the data layer event that causes this trigger.
Acceptable values are:
|
writable |
uniqueTriggerId |
nested object |
Globally unique id of the trigger that auto-generates this (a Form Submit, Link Click or Timer listener) if any. Used to make incompatible auto-events work together with trigger filtering based on trigger ids. This value is populated during output generation since the tags implied by triggers don't exist until then. Only valid for Form Submit, Link Click and Timer triggers. | writable |
uniqueTriggerId.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
uniqueTriggerId.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
uniqueTriggerId.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
uniqueTriggerId.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
uniqueTriggerId.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
uniqueTriggerId.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
verticalScrollPercentageList |
nested object |
List of integer percentage values for scroll triggers. The trigger will fire when each percentage is reached when the view is scrolled vertically. Only valid for AMP scroll triggers. | writable |
verticalScrollPercentageList.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
verticalScrollPercentageList.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
verticalScrollPercentageList.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
verticalScrollPercentageList.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
verticalScrollPercentageList.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
verticalScrollPercentageList.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
visibilitySelector |
nested object |
A visibility trigger CSS selector (i.e. "#id"). Only valid for AMP Visibility trigger. | writable |
visibilitySelector.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
visibilitySelector.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
visibilitySelector.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
visibilitySelector.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
visibilitySelector.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
visibilitySelector.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
visiblePercentageMax |
nested object |
A visibility trigger maximum percent visibility. Only valid for AMP Visibility trigger. | writable |
visiblePercentageMax.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
visiblePercentageMax.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
visiblePercentageMax.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
visiblePercentageMax.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
visiblePercentageMax.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
visiblePercentageMax.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
visiblePercentageMin |
nested object |
A visibility trigger minimum percent visibility. Only valid for AMP Visibility trigger. | writable |
visiblePercentageMin.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
visiblePercentageMin.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
visiblePercentageMin.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
visiblePercentageMin.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
visiblePercentageMin.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
visiblePercentageMin.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
waitForTags |
nested object |
Whether or not we should delay the form submissions or link opening until all of the tags have fired (by preventing the default action and later simulating the default action). Only valid for Form Submission and Link Click triggers. | writable |
waitForTags.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
waitForTags.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
waitForTags.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
waitForTags.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
waitForTags.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
waitForTags.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
waitForTagsTimeout |
nested object |
How long to wait (in milliseconds) for tags to fire when 'waits_for_tags' above evaluates to true . Only valid for Form Submission and Link Click triggers. |
writable |
waitForTagsTimeout.isWeakReference |
boolean |
Whether or not a reference type parameter is strongly or weakly referenced. Only used by Transformations. | writable |
waitForTagsTimeout.key |
string |
The named key that uniquely identifies a parameter. Required for top-level parameters, as well as map values. Ignored for list values. | writable |
waitForTagsTimeout.list[] |
list |
This list parameter's parameters (keys will be ignored). | writable |
waitForTagsTimeout.map[] |
list |
This map parameter's parameters (must have keys; keys must be unique). | writable |
waitForTagsTimeout.type |
string |
The parameter type. Valid values are:
Acceptable values are:
|
writable |
waitForTagsTimeout.value |
string |
A parameter's value (may contain variable references such as "{{myVariable}}") as appropriate to the specified type. | writable |
workspaceId |
string |
GTM Workspace ID. |