Tags

As tags associadas ao contêiner. As tags geralmente são associadas a uma ou mais regras de disparo (consulte firingRuleId abaixo) e, opcionalmente, a uma ou mais regras de bloqueio (consulte blockingRuleId abaixo). Quando pelo menos uma regra de disparo e nenhuma regra de bloqueio é avaliada como "true", a tag é disparada (executada). Use a propriedade priority opcional para ajustar quais tags são disparadas antes das outras. Use a propriedade dependencies para especificar quais outras tags precisam ser disparadas e concluídas antes do disparo dessa tag. Se quiser detalhes sobre os parâmetros que podem ser definidos para as tags do Gerenciador de tags do Google, consulte a Referência do dicionário de tags.

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

Representa um Tag do Gerenciador de tags do Google.

{
  "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
}
Nome da propriedade Valor Descrição Observações
accountId string Código do Account do GTM.
blockingRuleId[] list Códigos de regras de bloqueio. Se uma das regras listadas forem avaliadas como "true", a tag não será disparada. gravável
blockingTriggerId[] list Códigos dos acionadores de bloqueio. Se um dos acionadores listados forem avaliadas como "true", a tag não será disparada. gravável
containerId string Código do Container do GTM.
fingerprint string Impressão digital do Tag do GTM, conforme processada no momento do armazenamento. Esse valor é reprocessado sempre que a tag do contêiner é modificada.
firingRuleId[] list IDs de regra de disparo. Uma tag é disparada quando uma das regras listadas têm o valor "true" e todos os blockingRuleIds (se especificados) têm o valor "false". gravável
firingTriggerId[] list IDs de acionador de disparo. Uma tag é disparada quando um dos acionadores listados têm o valor "true" e todos os blockingTriggerIds (se especificados) têm o valor "false". gravável
liveOnly boolean Se definida como "true", essa tag só será disparada no ambiente ativo (não no modo de visualização ou depuração). gravável
name string Nome de exibição da tag. gravável
notes string Observações para os usuários sobre como aplicar essa tag no contêiner. gravável
parameter[] list Parâmetros da tag. gravável
parameter[].key string Chave nomeada que identifica um parâmetro de forma única. Obrigatório para parâmetros de nível superior, bem como para valores de mapa. Ignorado para valores de lista. gravável
parameter[].list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
parameter[].map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
parameter[].type string Tipo de parâmetro. Os valores válidos são:
  • boolean: o valor representa um booleano, exibido como "true" ou "false"
  • integer: o valor representa um número inteiro assinado com 64 bits e de formato decimal
  • list: uma lista de parâmetros precisa ser especificada
  • map: um mapa de parâmetros precisa ser especificado
  • template: o valor representa qualquer texto e inclui referências de variáveis, mesmo aquelas que podem retornar tipos que não são strings
  • trigger_reference: o valor representa um acionador, que é informado como o ID do acionador


Estes são os valores aceitáveis:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
gravável
parameter[].value string Valor de um parâmetro (pode conter referências de variáveis, como ""), conforme apropriado para o tipo especificado. gravável
parentFolderId string Código da pasta pai.
paused boolean Valor "true" se a tag estiver pausada. gravável
priority nested object Prioridade numérica da tag definida pelo usuário. As tags são disparadas de forma assíncrona na ordem de prioridade. Tags com valor numérico maior são disparadas primeiro. A prioridade de uma tag pode ser um valor positivo ou negativo. O valor padrão é 0. gravável
priority.key string Chave nomeada que identifica um parâmetro de forma única. Obrigatório para parâmetros de nível superior, bem como para valores de mapa. Ignorado para valores de lista. gravável
priority.list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
priority.map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
priority.type string Tipo de parâmetro. Os valores válidos são:
  • boolean: o valor representa um booleano, exibido como "true" ou "false"
  • integer: o valor representa um número inteiro assinado com 64 bits e de formato decimal
  • list: uma lista de parâmetros precisa ser especificada
  • map: um mapa de parâmetros precisa ser especificado
  • template: o valor representa qualquer texto e inclui referências de variáveis, mesmo aquelas que podem retornar tipos que não são strings
  • trigger_reference: o valor representa um acionador, que é informado como o ID do acionador


Estes são os valores aceitáveis:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
gravável
priority.value string Valor de um parâmetro (pode conter referências de variáveis, como ""), conforme apropriado para o tipo especificado. gravável
scheduleEndMs long Data e hora de término em milissegundos para agendar uma tag. gravável
scheduleStartMs long Data e hora de início em milissegundos para agendar uma tag. gravável
setupTag[] list Lista de tags de configuração. No momento, permitimos apenas uma.
setupTag[].stopOnSetupFailure boolean Quando o valor é "true", a tag principal é disparada apenas se a tag de configuração for disparada com sucesso. Quando o valor é "false", a tag principal é disparada seja qual for o status de disparo da tag de configuração.
setupTag[].tagName string O nome da tag de configuração.
tagFiringOption string Opção para disparar essa tag.

Os valores aceitáveis são:
  • "oncePerEvent"
  • "oncePerLoad"
  • "unlimited"
tagId string O Tag ID identifica de forma única o Tag do GTM.
teardownTag[] list Lista de tags de desconstrução. No momento, permitimos apenas uma.
teardownTag[].stopTeardownOnFailure boolean Se o valor for "true", a tag de desconstrução é disparada apenas se a tag principal for disparada com sucesso. Quando o valor é "false", a tag de desconstrução é disparada seja qual for o status de disparo da tag principal.
teardownTag[].tagName string Nome da tag de desconstrução.
type string Tipo de Tag do GTM. gravável

Métodos

Use os métodos abaixo para criar, modificar, excluir ou recuperar tags.

create
Cria uma tag do GTM.
excluir
Exclui uma tag do GTM.
get
Recebe uma tag do GTM.
list
Lista todos os tags do GTM de um contêiner.
update
Atualiza uma tag do GTM.