Las etiquetas asociadas con el contenedor Por lo general, las etiquetas están asociadas con una o más reglas de activación (consulta firingRuleId
a continuación) y, opcionalmente, con una o más reglas de bloqueo (consulta blockingRuleId
a continuación). Cuando al menos una regla de activación se evalúa como verdadera y ninguna regla de bloqueo se evalúa como verdadera, la etiqueta se activa (ejecuta). Usa la propiedad opcional priority
para ajustar qué etiquetas se activan antes que otras. Usa la propiedad dependencies
para especificar qué otras etiquetas se deben activar y completar antes de que se active esta etiqueta. Si deseas obtener más información sobre los parámetros que se pueden configurar para las etiquetas de Google Tag Manager, consulta la Referencia del diccionario de etiquetas.
Para ver una lista de métodos para este recurso, consulta el final de esta página.
Representaciones de recursos
Representa una etiqueta de Google Tag Manager.
{ "accountId": string, "containerId": string, "tagId": string, "name": string, "type": string, "firingRuleId": [ string ], "blockingRuleId": [ string ], "firingTriggerId": [ string ], "blockingTriggerId": [ string ], "liveOnly": boolean, "priority": { "type": string, "key": string, "value": string, "list": [ (Parameter) ], "map": [ (Parameter) ] }, "notes": string, "scheduleStartMs": long, "scheduleEndMs": long, "parameter": [ { "type": string, "key": string, "value": string, "list": [ (Parameter) ], "map": [ (Parameter) ] } ], "fingerprint": string, "setupTag": [ { "tagName": string, "stopOnSetupFailure": boolean } ], "teardownTag": [ { "tagName": string, "stopTeardownOnFailure": boolean } ], "parentFolderId": string, "tagFiringOption": string, "paused": boolean }
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
accountId |
string |
ID de la cuenta de GTM. | |
blockingRuleId[] |
list |
IDs de reglas de bloqueo. Si alguna de las reglas de la lista se evalúa como verdadera, la etiqueta no se activará. | admite escritura |
blockingTriggerId[] |
list |
Bloquea los IDs de activador. Si alguno de los activadores de la lista se evalúa como verdadero, la etiqueta no se activará. | admite escritura |
containerId |
string |
ID del contenedor de GTM. | |
fingerprint |
string |
La huella digital de la etiqueta de GTM tal como se calculó en el momento del almacenamiento. Este valor se vuelve a calcular cada vez que se modifica la etiqueta. | |
firingRuleId[] |
list |
Los IDs de las reglas de activación. Se activará una etiqueta cuando alguna de las reglas enumeradas sea verdadera y todos sus blockingRuleIds (si los hay) sean falsos. |
admite escritura |
firingTriggerId[] |
list |
Se activan los IDs de los activadores. Una etiqueta se activará cuando alguno de los activadores enumerados sea verdadero y todos sus blockingTriggerIds (si los hay) sean falsos. |
admite escritura |
liveOnly |
boolean |
Si se establece como verdadera, esta etiqueta solo se activará en el entorno en vivo (p.ej., no en modo de vista previa ni de depuración). | admite escritura |
name |
string |
Nombre visible de la etiqueta. | admite escritura |
notes |
string |
Notas del usuario sobre cómo aplicar esta etiqueta en el contenedor. | admite escritura |
parameter[] |
list |
Los parámetros de la etiqueta. | 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[].type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
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 |
parentFolderId |
string |
ID de la carpeta superior. | |
paused |
boolean |
Es verdadero si la etiqueta está detenida. | admite escritura |
priority |
nested object |
Prioridad numérica de la etiqueta definida por el usuario. Las etiquetas se activan de forma asíncrona en orden de prioridad. Las etiquetas con valor numérico más alto se activan primero. La prioridad de una etiqueta puede ser un valor positivo o negativo. El valor predeterminado es 0. | admite escritura |
priority.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 |
priority.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
priority.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
priority.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
priority.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
scheduleEndMs |
long |
Es la marca de tiempo de finalización en milisegundos para programar una etiqueta. | admite escritura |
scheduleStartMs |
long |
Es la marca de tiempo de inicio en milisegundos para programar una etiqueta. | admite escritura |
setupTag[] |
list |
La lista de etiquetas de configuración. Por el momento, solo permitimos una. | |
setupTag[].stopOnSetupFailure |
boolean |
Si esta preferencia se establece como "true", la etiqueta principal solo se activa si la etiqueta de configuración se activa correctamente. Si es falso, se debe activar la etiqueta principal independientemente del estado de activación de la etiqueta de configuración. | |
setupTag[].tagName |
string |
El nombre de la etiqueta de configuración. | |
tagFiringOption |
string |
Es la opción para activar esta etiqueta.
Los valores aceptables son los siguientes:
|
|
tagId |
string |
El ID de etiqueta identifica de forma exclusiva la etiqueta de GTM. | |
teardownTag[] |
list |
La lista de etiquetas desmontajes. Por el momento, solo permitimos una. | |
teardownTag[].stopTeardownOnFailure |
boolean |
Si es verdadero, activa la etiqueta de desmontaje solo si la etiqueta principal se activa correctamente. Si es falso, activa la etiqueta de desmontaje, independientemente del estado de activación de la etiqueta principal. | |
teardownTag[].tagName |
string |
El nombre de la etiqueta teardown. | |
type |
string |
Tipo de etiqueta de GTM. | admite escritura |
Métodos
Usa los siguientes métodos para crear, modificar, borrar o recuperar etiquetas.
- crear
- Crea una etiqueta de GTM.
- borrar
- Borra una etiqueta de GTM.
- get
- Obtiene una etiqueta de GTM.
- list
- Enumera todas las etiquetas de GTM de un contenedor.
- actualizar
- Actualiza una etiqueta de GTM.