API Tag Manager: referência do dicionário de variáveis

Neste documento, descrevemos as propriedades que podem ser definidas para as variáveis do Gerenciador de tags do Google.

Introdução

Cada variável do Gerenciador de tags do Google tem um código type para identificação. Além disso, a maioria das variáveis tem parâmetros (pares key e type) que podem ser definidos como parte de um "objeto de parâmetro" durante a criação ou atualização delas. Para saber mais sobre como definir esses parâmetros usando um objeto, consulte a referência de parâmetros.

No restante deste documento, incluímos os detalhes de todas as variáveis compatíveis.

Cookie primário

Código de tipo

k

Parâmetros

Chave	Tipo	Observações
name	template	Nome do cookie.

Exemplo

 {
   "name": "Sample First Party Cookie Variable",
   "type": "k",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "myCookieName"
    }
   ]
 }

Variável de evento automático

Código de tipo

aev

Parâmetros

Chave	Tipo	Observações
varType	template	Um dentre ELEMENT,CLASSES, ID, TARGET, TEXT, URL, HISTORY_NEW_URL_FRAGMENT, HISTORY_OLD_URL_FRAGMENT, HISTORY_NEW_STATE, HISTORY_OLD_STATE, HISTORY_CHANGE_SOURCE.
defaultValue	template	Opcional.

Exemplo

  {
   "name": "Sample AutoEvent Variable",
   "type": "aev",
   "parameter": [
    {
     "type": "template",
     "key": "varType",
     "value": "CLASSES"
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "MyDefault"
    }
   ]
  }

String constante

Código de tipo

c

Parâmetros

Chave	Tipo
value	template

Exemplo

  {
   "name": "Sample Constant String",
   "type": "c",
   "parameter": [
    {
     "type": "template",
     "key": "value",
     "value": "MyString"
    }
   ]
  }

Número da versão do contêiner

Código de tipo

ctv

Parâmetros

N/D

Exemplo

  {
   "name": "Sample Container Version Number",
   "type": "ctv"
  }

Evento personalizado

Código de tipo

Parâmetros

N/D

Exemplo

  {
   "name": "Custom Event Name",
   "type": "e"
  }

JavaScript personalizado

Código de tipo

jsm

Parâmetros

Chave	Tipo
javascript	template

Exemplo

  {
   "name": "Sample Custom Javascript",
   "type": "jsm",
   "parameter": [
    {
     "type": "template",
     "key": "javascript",
     "value": "function() {\n return \"Hello World\";\n}"
    }
   ]
  }

Variável de camada de dados

Código de tipo

v

Parâmetros

Chave	Tipo	Observações
name	template	Nome da variável da camada de dados.
defaultValue	template
dataLayerVersion	integer	1 ou 2.

Exemplo

  {
   "name": "Sample Data Layer Variable",
   "type": "v",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "DL Variable Name"
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "DEFAULT"
    },
    {
     "type": "integer",
     "key": "dataLayerVersion",
     "value": "2"
    }
   ]
  }

Modo de depuração

Código de tipo

dbg

Parâmetros

N/D

Exemplo

  {
   "name": "Sample Debug Mode Variable",
   "type": "dbg"
  }

Elemento DOM

Código de tipo

d

Parâmetros

Chave	Tipo	Notas
elementId	template
attributeName	template	Opcional

Exemplo

  {
   "name": "Sample DOM Element Variable",
   "type": "d",
   "parameter": [
    {
     "type": "template",
     "key": "elementId",
     "value": "MyElementId"
    },
    {
     "type": "template",
     "key": "attributeName",
     "value": "MyAttributeName"
    }
   ]
  }

Referenciador de HTTP

Código de tipo

f

Parâmetros

Chave	Tipo	Observações
component	template	Um dentre: URL, PROTOCOL, HOST, PORT, PATH, QUERY, FRAGMENT.
stripWww	boolean	Para componente = HOST
queryKey	template	Para componente = QUERY

Exemplo

  {
   "name": "Sample HTTP Referrer Variable",
   "type": "f",
   "parameter": [
    {
     "type": "template",
     "key": "component",
     "value": "URL"
    }
   ]
  }

Variável JavaScript

Código de tipo

j

Parâmetros

Chave	Tipo	Observações
name	template	Nome da variável global.

Exemplo

  {
   "name": "Sample Javascript Variable",
   "type": "j",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "MyGlobalVarName"
    }
   ]
  }

Tabela de consulta

Código de tipo

smm

Parâmetros

Chave	Tipo	Observações
input	template	O valor usado para pesquisa precisa ser uma referência de variável.
map	list	Uma lista de mapas, cada um com um único par (key e value).
map[].key	template
map[].value	template
defaultValue	template	Opcional.

Exemplo

  {
   "name": "Sample Lookup Table Variable",
   "type": "smm",
   "parameter": [
    {
     "type": "template",
     "key": "input",
     "value": "{{event}}"
    },
    {
     "type": "list",
     "key": "map",
     "list": [
      {
       "type": "map",
       "map": [
        {
         "type": "template",
         "key": "key",
         "value": "EventEqualsThis"
        },
        {
         "type": "template",
         "key": "value",
         "value": "ThenSetToThis"
        }
       ]
      }
     ]
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "MyDefaultValue"
    }
   ]
  }

Número aleatório

Código de tipo

r

Parâmetros

N/D

Exemplo

  {
   "name": "Sample Random Number Variable",
   "type": "r"
  }

URL

Código de tipo

u

Parâmetros

Chave	Tipo	Observações
component	template	Um dentre: URL, PROTOCOL, HOST, PORT, PATH, QUERY, FRAGMENT.
customUrlSource	template	Opcional.
stripWww	boolean	Para componente = HOST
queryKey	template	Para componente = QUERY

Exemplo

  {
   "name": "Sample URL Variable",
   "type": "u",
   "parameter": [
    {
     "type": "template",
     "key": "component",
     "value": "URL"
    },
    {
     "type": "template",
     "key": "customUrlSource",
     "value": "{{element}}"
    }
   ]
  }