Neste documento, descrevemos a finalidade e a representação do objeto do parâmetro do Gerenciador de tags.
Introdução
Com a API Tag Manager, você pode criar e gerenciar recursos do Gerenciador de tags, como tags, acionadores e variáveis.
A maioria dos tipos de tags e variáveis tem parâmetros adicionais específicos e pode ser definida na hora de criar/atualizar o recurso. Você encontra a lista de parâmetros (pares key, type) para cada tipo de tag e variável na Referência do dicionário de tags.
Para configurar esses parâmetros específicos, um objeto de parâmetro é definido como o valor da propriedade parameter do recurso tag ou variável.
Objeto de parâmetro
O objeto a seguir representa um objeto de parâmetro:
[
{
"type": string,
"key": string,
"value": string,
"list": [
(Parameter)
],
"map": [
(Parameter)
]
}
]
type
O tipo de parâmetro de tag ou variável que está sendo configurado.
A propriedade type determinará se uma propriedade value, list ou map precisa ser incluída no objeto de parâmetro, conforme descrito na tabela abaixo.
Por exemplo, se type for definido como boolean, será necessário incluir uma propriedade value no objeto de parâmetro e defini-la como true ou false.
| Valor | Propriedade adicional a ser incluída | Definição da propriedade adicional |
|---|---|---|
template |
value |
value é qualquer string, incluindo referências de variável, por exemplo, foo{{bar}}. |
boolean |
value |
value é true ou false.
|
number |
value |
value é um número inteiro |
list |
list |
list conterá zero ou mais parâmetros, independentemente ou não da ordem; o key de qualquer parâmetro no list
será ignorado. |
map |
map |
map conterá zero ou mais parâmetros, a ordem não importa. O key em qualquer parâmetro no map precisa ser exclusivo. |
key
A chave de parâmetro da tag ou variável que está sendo configurada.
O campo key key é usado para identificar o parâmetro de tags ou variáveis específicos que estão sendo definidos. Todos os tipos de parâmetro precisam de uma propriedade key (exceto parâmetros list).
Exemplos
Um objeto de parâmetro para uma tag HTML personalizada,
que tem um parâmetro do tipo template e dois do tipo boolean:
"parameter": [
{
"key": "html",
"type": "template",
"value": "<script>alert('hello world')</script>"
},
{
"key": "supportDocumentWrite",
"type": "boolean",
"value": "false"
}
]
Um objeto de parâmetro para uma tag de chamada de função, que tem um parâmetro do tipo template e um do tipo map:
"parameter": [
{
"key": "functionName",
"type": "template",
"value": "fn"
},
{
"key": "functionArgument",
"map": [
{
"key": "argkey1",
"type": "template",
"value": "argval1"
}
],
"type": "map"
}
]