Rules

As regras de um contêiner. Elas são avaliadas como "true" ou "false" durante o tempo de execução. Podem ser usadas para controlar quando uma tag é disparada ou bloqueada e para controlar quando as macros em um contêiner para dispositivos móveis são ativadas ou desativadas. Para mais detalhes, confira as regras de disparo e desativação de regras na configuração de uma tag e as regras de ativação e desativação na configuração de uma macro, respectivamente.

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

Representações de recursos

Representa um Rule do Gerenciador de tags do Google.

{
  "accountId": string,
  "containerId": string,
  "ruleId": string,
  "name": string,
  "notes": string,
  "condition": [
    {
      "type": string,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ]
    }
  ],
  "fingerprint": string
}
Nome da propriedade Valor Descrição Observações
accountId string Código do Account do GTM.
condition[] list Lista de condições que compõem essa regra (o operador "AND" implícito entre elas). gravável
condition[].parameter[] list Lista de parâmetros nomeados (chave/valor), dependendo do tipo de condição. Observações:
  • No caso dos operadores binários, inclua os parâmetros arg0 e arg1 para especificar os operandos esquerdo e direito, respectivamente.
  • No momento, o operando esquerdo (arg0) precisa ser uma referência a uma macro.
  • Para correspondência de regex que não diferencia maiúsculas de minúsculas, inclua um parâmetro booleano ignore_case definido como true. Se não for especificada nem definida como outro valor, a correspondência diferenciará maiúsculas de minúsculas.
  • Para negar um operador, inclua um parâmetro booleano negate e defina-o como true.
gravável
condition[].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
condition[].parameter[].list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
condition[].parameter[].map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
condition[].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 pode incluir referências de macro, até mesmo aquelas que podem retornar tipos que não são strings.


Estes são os valores aceitáveis:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
gravável
condition[].parameter[].value string Valor de um parâmetro (pode conter referências de macros, como ""), conforme apropriado para o tipo especificado. gravável
condition[].type string Tipo de operador para essa condição.

Os valores aceitáveis são:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
gravável
containerId string Código do Container do GTM.
fingerprint string Impressão digital do Rule do GTM, conforme processada no armazenamento. Esse valor é reprocessado sempre que a regra é modificada.
name string Nome de exibição da regra. gravável
notes string Observações para o usuário sobre como aplicar essa regra no contêiner. gravável
ruleId string Código do Rule que identifica a regra do GTM de forma exclusiva.

Métodos

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

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