Actualiza un activador de GTM. Pruébalo ahora.
Solicitud
Solicitud HTTP
PUT https://www.googleapis.com/tagmanager/v2/path
Parámetros
Nombre del parámetro | Valor | Descripción |
---|---|---|
Parámetros de ruta de acceso | ||
path |
string |
Ruta relativa de la API del activador de GTM. Ejemplo: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/triggers/{trigger_id}. |
Parámetros de consulta opcionales | ||
fingerprint |
string |
Cuando se proporciona, esta huella digital debe coincidir con la del activador en el almacenamiento. |
Autorización
Esta solicitud requiere una autorización con el siguiente alcance:
Permiso |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Para obtener más información, consulta la página de autenticación y autorización.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona un recurso de activadores con las siguientes propiedades:
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
Propiedades obligatorias | |||
autoEventFilter[].parameter[] |
list |
Una lista de parámetros con nombre (clave-valor), según el tipo de condición. Notas:
|
admite escritura |
autoEventFilter[].parameter[].type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
autoEventFilter[].type |
string |
Es el tipo de operador para esta condición.
Los valores aceptables son los siguientes:
|
admite escritura |
checkValidation.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
continuousTimeMinMilliseconds.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
customEventFilter[].parameter[] |
list |
Una lista de parámetros con nombre (clave-valor), según el tipo de condición. Notas:
|
admite escritura |
customEventFilter[].parameter[].type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
customEventFilter[].type |
string |
Es el tipo de operador para esta condición.
Los valores aceptables son los siguientes:
|
admite escritura |
eventName.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
filter[].parameter[] |
list |
Una lista de parámetros con nombre (clave-valor), según el tipo de condición. Notas:
|
admite escritura |
filter[].parameter[].type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
filter[].type |
string |
Es el tipo de operador para esta condición.
Los valores aceptables son los siguientes:
|
admite escritura |
horizontalScrollPercentageList.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
interval.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
intervalSeconds.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
limit.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
maxTimerLengthSeconds.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
name |
string |
Nombre visible del activador. | admite escritura |
parameter[].type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
selector.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
totalTimeMinMilliseconds.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
uniqueTriggerId.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
verticalScrollPercentageList.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
visibilitySelector.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
visiblePercentageMax.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
visiblePercentageMin.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
waitForTags.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
waitForTagsTimeout.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
Propiedades opcionales | |||
autoEventFilter[] |
list |
Se utiliza en el caso del seguimiento automático de eventos. | admite escritura |
autoEventFilter[].parameter[].key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
autoEventFilter[].parameter[].list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
autoEventFilter[].parameter[].map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
autoEventFilter[].parameter[].value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
checkValidation |
nested object |
Indica si solo debemos activar o no etiquetas si algún otro controlador de eventos no cancela el envío de formulario o el evento de clic en el vínculo (p.ej., debido a la validación). Solo es válido para los activadores de envío de formularios y clic en vínculo. | admite escritura |
checkValidation.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
checkValidation.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
checkValidation.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
checkValidation.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
continuousTimeMinMilliseconds |
nested object |
El tiempo mínimo visible continuo de un activador de visibilidad (en milisegundos). Solo es válido para el activador de visibilidad de AMP. | admite escritura |
continuousTimeMinMilliseconds.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
continuousTimeMinMilliseconds.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
continuousTimeMinMilliseconds.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
continuousTimeMinMilliseconds.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
customEventFilter[] |
list |
Se usa en el caso de los eventos personalizados, que se activan si todas las Condiciones son verdaderas. | admite escritura |
customEventFilter[].parameter[].key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
customEventFilter[].parameter[].list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
customEventFilter[].parameter[].map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
customEventFilter[].parameter[].value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
eventName |
nested object |
Nombre del evento de GTM que se activa. Solo es válido para activadores de temporizador. | admite escritura |
eventName.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
eventName.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
eventName.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
eventName.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
filter[] |
list |
El activador solo se activará si todas las condiciones son verdaderas. | admite escritura |
filter[].parameter[].key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
filter[].parameter[].list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
filter[].parameter[].map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
filter[].parameter[].value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
horizontalScrollPercentageList |
nested object |
Lista de valores porcentuales de números enteros para los activadores de desplazamiento. El activador se activará cuando se alcance cada porcentaje cuando la vista se desplace horizontalmente. Solo es válido para los activadores de desplazamiento de AMP. | admite escritura |
horizontalScrollPercentageList.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
horizontalScrollPercentageList.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
horizontalScrollPercentageList.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
horizontalScrollPercentageList.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
interval |
nested object |
Tiempo transcurrido entre la activación de eventos de temporizador recurrentes (en milisegundos). Solo es válido para activadores de temporizador. | admite escritura |
interval.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
interval.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
interval.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
interval.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
intervalSeconds |
nested object |
Tiempo entre los eventos de temporizador para activarse (en segundos). Solo es válido para el activador del temporizador de AMP. | admite escritura |
intervalSeconds.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
intervalSeconds.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
intervalSeconds.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
intervalSeconds.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
limit |
nested object |
Límite de la cantidad de eventos de GTM que se activará este activador de temporizador. Si no se establece ningún límite, seguiremos activando eventos de GTM hasta que el usuario abandone la página. Solo es válido para activadores de temporizador. | admite escritura |
limit.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
limit.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
limit.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
limit.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
maxTimerLengthSeconds |
nested object |
Tiempo máximo para activar eventos de temporizador (en segundos). Solo es válido para el activador del temporizador de AMP. | admite escritura |
maxTimerLengthSeconds.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
maxTimerLengthSeconds.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
maxTimerLengthSeconds.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
maxTimerLengthSeconds.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
notes |
string |
Notas del usuario sobre cómo aplicar este activador en el contenedor. | admite escritura |
parameter[] |
list |
Parámetros adicionales | admite escritura |
parameter[].key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
parameter[].list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
parameter[].map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
parameter[].value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
selector |
nested object |
Un selector CSS de activación de clic (es decir, "un", "botón", etc.). Solo es válido para el activador de clics de AMP. | admite escritura |
selector.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
selector.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
selector.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
selector.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
totalTimeMinMilliseconds |
nested object |
El tiempo visible total mínimo del activador de visibilidad (en milisegundos). Solo es válido para el activador de visibilidad de AMP. | admite escritura |
totalTimeMinMilliseconds.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
totalTimeMinMilliseconds.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
totalTimeMinMilliseconds.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
totalTimeMinMilliseconds.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
type |
string |
Define el evento de la capa de datos que genera este activador.
Los valores aceptables son los siguientes:
|
admite escritura |
uniqueTriggerId |
nested object |
Es el ID único global del activador que lo genera automáticamente (un objeto de escucha de envío de formulario, de clics en vínculos o de cronómetros), si corresponde. Se usa para que los eventos automáticos incompatibles funcionen en conjunto con el filtrado de activadores basado en los IDs de los activadores. Este valor se propaga durante la generación del resultado, ya que las etiquetas implícitas en los activadores no existen hasta ese momento. Solo es válido para los activadores de envío de formulario, clic en vínculo y temporizador. | admite escritura |
uniqueTriggerId.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
uniqueTriggerId.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
uniqueTriggerId.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
uniqueTriggerId.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
verticalScrollPercentageList |
nested object |
Lista de valores porcentuales de números enteros para los activadores de desplazamiento. El activador se activará cuando se alcance cada porcentaje cuando la vista se desplace verticalmente. Solo es válido para los activadores de desplazamiento de AMP. | admite escritura |
verticalScrollPercentageList.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
verticalScrollPercentageList.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
verticalScrollPercentageList.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
verticalScrollPercentageList.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
visibilitySelector |
nested object |
Un selector CSS del activador de visibilidad (es decir, "#id"). Solo es válido para el activador de visibilidad de AMP. | admite escritura |
visibilitySelector.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
visibilitySelector.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
visibilitySelector.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
visibilitySelector.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
visiblePercentageMax |
nested object |
El porcentaje máximo de visibilidad de un activador de visibilidad Solo es válido para el activador de visibilidad de AMP. | admite escritura |
visiblePercentageMax.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
visiblePercentageMax.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
visiblePercentageMax.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
visiblePercentageMax.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
visiblePercentageMin |
nested object |
Un porcentaje de visibilidad mínimo del activador de visibilidad. Solo es válido para el activador de visibilidad de AMP. | admite escritura |
visiblePercentageMin.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
visiblePercentageMin.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
visiblePercentageMin.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
visiblePercentageMin.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
waitForTags |
nested object |
Indica si debemos demorar o no los envíos de formularios o la apertura de vínculos hasta que se activen todas las etiquetas (para ello, se debe evitar la acción predeterminada y, luego, simular la acción predeterminada). Solo es válido para los activadores de envío de formularios y clic en vínculo. | admite escritura |
waitForTags.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
waitForTags.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
waitForTags.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
waitForTags.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
waitForTagsTimeout |
nested object |
Tiempo de espera (en milisegundos) para que las etiquetas se activen cuando 'waits_for_tags' anterior se evalúa como true . Solo es válido para los activadores de envío de formularios y clic en vínculo. |
admite escritura |
waitForTagsTimeout.key |
string |
La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. | admite escritura |
waitForTagsTimeout.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
waitForTagsTimeout.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
waitForTagsTimeout.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
Respuesta
Si se aplica correctamente, este método muestra un recurso de activadores en el cuerpo de la respuesta.
Pruébala
Usa el Explorador de APIs que aparece a continuación para llamar a este método con datos en tiempo real y ver la respuesta.