Macros

As macros de um contêiner. Elas representam valores que são avaliados no tempo de execução. É possível fazer referência às macros ao configurar regras e tags. Para mais detalhes sobre as propriedades que podem ser definidas para as macros do Gerenciador de tags do Google, consulte a Referência do dicionário de macros. Para informações sobre como os usuários configuram e usam macros, consulte Macros na Central de Ajuda do Gerenciador de tags do Google.

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

Representações de recursos

Representa um Macro do Gerenciador de tags do Google.

{
  "accountId": string,
  "containerId": string,
  "macroId": string,
  "name": string,
  "type": string,
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "enablingRuleId": [
    string
  ],
  "disablingRuleId": [
    string
  ],
  "fingerprint": string,
  "parentFolderId": string
}
Nome da propriedade Valor Descrição Observações
accountId string Código do Account do GTM.
containerId string Código do Container do GTM.
disablingRuleId[] list Apenas para contêineres de dispositivos móveis: uma lista de códigos de regras para macros condicionais de desativação. A macro será ativada se uma das regras de ativação tiver o valor "true" e todas as regras de desativação apresentarem o valor "false". Tratado como um conjunto não ordenado. gravável
enablingRuleId[] list Apenas para contêineres para dispositivos móveis: uma lista de códigos de regras para macros condicionais de ativação. A macro será ativada se uma das regras de ativação tiver o valor "true" e todas as regras de desativação tiverem o valor "false". Tratado como um conjunto não ordenado. gravável
fingerprint string Impressão digital do Macro do GTM, conforme processado no momento do armazenamento. Esse valor é reprocessado sempre que a macro é modificada.
macroId string Código do Macro que identifica o Macro do GTM de forma única.
name string Nome de exibição da macro. gravável
notes string Observações para os usuários sobre como aplicar essa macro no contêiner. gravável
parameter[] list Parâmetros da macro. 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 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
parameter[].value string Valor de um parâmetro (pode conter referências de macros, como ""), conforme apropriado para o tipo especificado. gravável
parentFolderId string Código da pasta pai.
scheduleEndMs long Data e hora de término em milissegundos para agendar uma macro. gravável
scheduleStartMs long A data e hora de início em milissegundos para agendar uma macro. gravável
type string Tipo de Macro do GTM. gravável

Métodos

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

create
Cria um Macro do GTM.
excluir
Exclui um Macro do GTM.
get
Recebe um Macro do GTM.
list
Lista todas as macros do GTM de um contêiner.
update
Atualiza um Macro do GTM.