Triggers: create

Requiere autorización

Crea un recurso Trigger de GTM. Pruébalo ahora o consulta un ejemplo.

Solicitud

Solicitud HTTP

POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/triggers

Parámetros

Nombre de parámetro Valor Descripción
Parámetros de ruta
accountId string ID de recurso Account de GTM
containerId string ID de recurso Container de GTM

Autorización

Esta solicitud requiere autorización con el siguiente ámbito. Consulta más información sobre la autenticación y la autorización.

Ámbito
https://www.googleapis.com/auth/tagmanager.edit.containers

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona un recurso Trigger con las siguientes propiedades:

Nombre de la propiedad Valor Descripción Notas
Propiedades obligatorias
autoEventFilter[].parameter[] list Lista de parámetros con nombre (clave-valor), que dependen del tipo de condición. Notas:
  • En el caso de los operadores binarios, incluye los parámetros arg0 y arg1 para especificar los operandos izquierdo y derecho, respectivamente.
  • Por ahora, el operando izquierdo (arg0) debe ser una referencia a una variable.
  • En el caso de las coincidencias de expresión regular en las que no se distinga entre mayúsculas y minúsculas, incluye un parámetro booleano ignore_case cuyo valor sea true. Si no se especifica o si se elige cualquier otro valor, en la coincidencia se distinguirá entre mayúsculas y minúsculas.
  • Para negar un operador, incluye un parámetro booleano negate cuyo valor sea true.
editable
autoEventFilter[].parameter[].type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
autoEventFilter[].type string Tipo de operador de esta condición.

Estos son los valores posibles:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
editable
checkValidation.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
continuousTimeMinMilliseconds.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
customEventFilter[].parameter[] list Lista de parámetros con nombre (clave-valor), que dependen del tipo de condición. Notas:
  • En el caso de los operadores binarios, incluye los parámetros arg0 y arg1 para especificar los operandos izquierdo y derecho, respectivamente.
  • Por ahora, el operando izquierdo (arg0) debe ser una referencia a una variable.
  • En el caso de las coincidencias de expresión regular en las que no se distinga entre mayúsculas y minúsculas, incluye un parámetro booleano ignore_case cuyo valor sea true. Si no se especifica o si se elige cualquier otro valor, en la coincidencia se distinguirá entre mayúsculas y minúsculas.
  • Para negar un operador, incluye un parámetro booleano negate cuyo valor sea true.
editable
customEventFilter[].parameter[].type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
customEventFilter[].type string Tipo de operador de esta condición.

Estos son los valores posibles:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
editable
eventName.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
filter[].parameter[] list Lista de parámetros con nombre (clave-valor), que dependen del tipo de condición. Notas:
  • En el caso de los operadores binarios, incluye los parámetros arg0 y arg1 para especificar los operandos izquierdo y derecho, respectivamente.
  • Por ahora, el operando izquierdo (arg0) debe ser una referencia a una variable.
  • En el caso de las coincidencias de expresión regular en las que no se distinga entre mayúsculas y minúsculas, incluye un parámetro booleano ignore_case cuyo valor sea true. Si no se especifica o si se elige cualquier otro valor, en la coincidencia se distinguirá entre mayúsculas y minúsculas.
  • Para negar un operador, incluye un parámetro booleano negate cuyo valor sea true.
editable
filter[].parameter[].type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
filter[].type string Tipo de operador de esta condición.

Estos son los valores posibles:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
editable
horizontalScrollPercentageList.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
interval.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
intervalSeconds.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
limit.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
maxTimerLengthSeconds.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
name string Nombre visible del recurso Trigger. editable
parameter[].type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
selector.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
totalTimeMinMilliseconds.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
type string Define el evento de capa de datos que activa este activador.

Estos son los valores posibles:
  • "always"
  • "ampClick"
  • "ampScroll"
  • "ampTimer"
  • "ampVisibility"
  • "click"
  • "customEvent"
  • "domReady"
  • "elementVisibility"
  • "formSubmission"
  • "historyChange"
  • "jsError"
  • "linkClick"
  • "pageview"
  • "scrollDepth"
  • "timer"
  • "windowLoaded"
  • "youTubeVideo"
editable
uniqueTriggerId.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
verticalScrollPercentageList.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
visibilitySelector.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
visiblePercentageMax.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
visiblePercentageMin.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
waitForTags.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
waitForTagsTimeout.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano, con un valor "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
Propiedades opcionales
autoEventFilter[] list Se utiliza en el caso del seguimiento de eventos automáticos. editable
autoEventFilter[].parameter[].key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
autoEventFilter[].parameter[].list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
autoEventFilter[].parameter[].map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
autoEventFilter[].parameter[].value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
checkValidation nested object Indica si debemos activar etiquetas únicamente si ningún otro gestor de eventos cancela el evento de envío de formulario o de clic en enlace (por ejemplo, debido a la validación). Solo es válido en activadores de envío de formularios y de clic en enlace. editable
checkValidation.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
checkValidation.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
checkValidation.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
checkValidation.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
continuousTimeMinMilliseconds nested object Tiempo visible mínimo continuo de un activador de visibilidad (en milisegundos). Solo es válido en el activador de visibilidad AMP. editable
continuousTimeMinMilliseconds.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
continuousTimeMinMilliseconds.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
continuousTimeMinMilliseconds.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
continuousTimeMinMilliseconds.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
customEventFilter[] list Se utiliza en el caso de que haya eventos personalizados; se activa si se cumplen todas las condiciones. editable
customEventFilter[].parameter[].key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
customEventFilter[].parameter[].list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
customEventFilter[].parameter[].map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
customEventFilter[].parameter[].value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
eventName nested object Nombre del evento de GTM que se activa. Solo es válido en activadores de temporizador. editable
eventName.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
eventName.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
eventName.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
eventName.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
filter[] list El activador solo se activa si se cumplen todas las condiciones. editable
filter[].parameter[].key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
filter[].parameter[].list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
filter[].parameter[].map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
filter[].parameter[].value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
horizontalScrollPercentageList nested object Lista de valores porcentuales enteros de los activadores de desplazamiento. El activador se activa cuando se alcanza cada porcentaje al desplazar la vista en sentido horizontal. Solo es válido en los activadores de desplazamiento AMP. editable
horizontalScrollPercentageList.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
horizontalScrollPercentageList.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
horizontalScrollPercentageList.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
horizontalScrollPercentageList.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
interval nested object Tiempo transcurrido entre la activación de eventos de temporizador recurrentes (en milisegundos). Solo es válido en activadores de temporizador. editable
interval.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
interval.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
interval.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
interval.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
intervalSeconds nested object Tiempo transcurrido entre los eventos de temporizador que deben activarse (en segundos). Solo es válido en activadores de temporizador AMP. editable
intervalSeconds.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
intervalSeconds.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
intervalSeconds.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
intervalSeconds.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
limit nested object Límite del número de eventos de GTM que activará este activador de temporizador. Si no se configura ningún límite, seguiremos activando eventos de GTM hasta que el usuario abandone la página. Solo es válido en activadores de temporizador. editable
limit.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
limit.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
limit.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
limit.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
maxTimerLengthSeconds nested object Tiempo máximo para activar eventos de temporizador (en segundos). Solo es válido en activadores de temporizador AMP. editable
maxTimerLengthSeconds.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
maxTimerLengthSeconds.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
maxTimerLengthSeconds.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
maxTimerLengthSeconds.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
parameter[].key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
parameter[].list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
parameter[].map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
parameter[].value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
selector nested object Selector CSS de activador de clic (es decir, "a", "button", etc.). Solo es válido en el activador de clics AMP. editable
selector.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
selector.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
selector.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
selector.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
totalTimeMinMilliseconds nested object Tiempo visible mínimo total de un activador de visibilidad (en milisegundos). Solo es válido en el activador de visibilidad AMP. editable
totalTimeMinMilliseconds.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
totalTimeMinMilliseconds.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
totalTimeMinMilliseconds.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
totalTimeMinMilliseconds.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
uniqueTriggerId nested object ID único global del activador que genera automáticamente esta acción (un envío de formulario, un clic en un enlace o un procesador del temporizador) si lo hubiera. Se utiliza para hacer que los eventos automáticos incompatibles funcionen conjuntamente con el filtrado de activación basado en los ID de activación. Este valor se rellena al generar los resultados, ya que las etiquetas que activan los activadores no existen hasta entonces. Solo es válido en activadores de envío de formularios, de clic en enlace y de temporizador. editable
uniqueTriggerId.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
uniqueTriggerId.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
uniqueTriggerId.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
uniqueTriggerId.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
verticalScrollPercentageList nested object Lista de valores porcentuales enteros de los activadores de desplazamiento. El activador se activa cuando se alcanza cada porcentaje al desplazar la vista en sentido vertical. Solo es válido en los activadores de desplazamiento AMP. editable
verticalScrollPercentageList.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
verticalScrollPercentageList.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
verticalScrollPercentageList.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
verticalScrollPercentageList.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
visibilitySelector nested object Selector CSS de un activador de visibilidad (es decir, "#id"). Solo es válido en el activador de visibilidad AMP. editable
visibilitySelector.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
visibilitySelector.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
visibilitySelector.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
visibilitySelector.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
visiblePercentageMax nested object Porcentaje máximo de visibilidad de un activador de visibilidad. Solo es válido en el activador de visibilidad AMP. editable
visiblePercentageMax.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
visiblePercentageMax.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
visiblePercentageMax.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
visiblePercentageMax.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
visiblePercentageMin nested object Porcentaje mínimo de visibilidad de un activador de visibilidad. Solo es válido en el activador de visibilidad AMP. editable
visiblePercentageMin.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
visiblePercentageMin.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
visiblePercentageMin.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
visiblePercentageMin.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
waitForTags nested object Indica si debemos retrasar los envíos de formularios o la apertura de enlaces hasta que todas las etiquetas se hayan activado (impidiendo la acción predeterminada y simulándola más tarde). Solo es válido en activadores de envío de formularios y de clic en enlace. editable
waitForTags.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
waitForTags.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
waitForTags.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
waitForTags.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable
waitForTagsTimeout nested object Tiempo (en milisegundos) que se debe esperar para que se activen las etiquetas cuando la propiedad 'waits_for_tags' anterior se evalúa como true. Solo es válido en activadores de envío de formularios y de clic en enlace. editable
waitForTagsTimeout.key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. editable
waitForTagsTimeout.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
waitForTagsTimeout.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
waitForTagsTimeout.value string Valor de un parámetro (puede contener referencias a variables como "{{myVariable}}") según requiera el tipo especificado. editable

Respuesta

Si se realiza correctamente, este método devuelve un recurso Trigger en el cuerpo de la respuesta.

Ejemplos

Nota: Los ejemplos de código de este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas de cliente para obtener una lista de los lenguajes admitidos).

Java

Utiliza la biblioteca de cliente Java.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request creates a new trigger for the authorized user.
 */

// Create the condition parameters objects.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("arg0");
arg0.setValue("{{Page URL}}");
Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("arg1");
arg1.setValue("timed.html");

// Create the auto event condition object.
Condition condition = new Condition();
condition.setType("contains");
condition.setParameter(Arrays.asList(arg0, arg1));

// Create the event parameter.
Parameter eventName = new Parameter();
eventName.setType("template");
eventName.setValue("gtm.timer");

// Create the interval parameter.
Parameter interval = new Parameter();
interval.setType("template");
interval.setValue("10000");

// Create the limit parameter.
Parameter limit = new Parameter();
limit.setType("template");
limit.setValue("10");

// Create the trigger object.
Trigger trigger = new Trigger();
trigger.setName("Timer Trigger");
trigger.setType("timer");
trigger.setAutoEventFilter(Arrays.asList(condition));
trigger.setEventName(eventName);
trigger.setInterval(interval);
trigger.setLimit(limit);

try {
  Trigger response = tagmanager.accounts().containers().
      triggers().create("123456", "54321", trigger).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the create method are stored in the response object.
 * The following code shows how to access the created Id and Fingerprint.
 */
System.out.println("Trigger Id = " + response.getTriggerId());
System.out.println("Trigger Fingerprint = " + response.getFingerprint());

Python

Utiliza la biblioteca de cliente Python.

# Note: This code assumes you have an authorized tagmanager service object.

# This request creates a new trigger.
try:
  response = tagmanager.accounts().containers().triggers().create(
      accountId='123456',
      containerId='54321',
      body={
          'name': 'Timed trigger',
          'type': 'timer',
          'autoEventFilter': [
              {
                  'type': 'contains',
                  'parameter': [
                      {
                          'type': 'template',
                          'key': 'arg0',
                          'value': '{{Page URL}}'
                      },
                      {
                          'type': 'template',
                          'key': 'arg1',
                          'value': 'timed.html'
                      }
                  ]
              }
          ],
          'eventName': {
              'type': 'template',
              'value': 'gtm.timer'
          },
          'interval': {
              'type': 'template',
              'value': '10000'
          },
          'limit': {
              'type': 'template',
              'value': '10'
          }
      }
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

# The results of the create method are stored in response object.
# The following code shows how to access the created id and fingerprint.
print 'Trigger Id = %s' % response.get('triggerId')
print 'Trigger Fingerprint = %s' % response.get('fingerprint')

Pruébalo

Utiliza el siguiente explorador de APIs para llamar a este método con datos en tiempo real y ver la respuesta.