Este documento lista todos os nomes de campos configuráveis para analytics.js.
Campos exclusivos para "create"
Os campos a seguir só podem ser definidos no método create. Para mais detalhes, leia a seção Como criar objetos de acompanhamento no Guia de configuração avançada.
ID de acompanhamento / ID da propriedade da Web
Obrigatório para todos os tipos de hit.
O ID de acompanhamento / ID da propriedade da Web. O formato é UA-XXXX-Y. Todos os dados coletados são associados a esse ID.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
trackingId |
texto | Nenhum |
UA-XXXX-YExemplo de uso:
ga('create', 'UA-XXXX-Y');
// Alerts the tracking ID for the default tracker.
ga(function(tracker) {
alert(tracker.get('trackingId'));
});
Nome do rastreador
Opcional.
Só pode ser definido no método create.
Nome do objeto de acompanhamento.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
name |
texto | t0
|
myTrackerExemplo de uso:
ga('create', 'UA-XXXX-Y', {'name': 'myTracker'});
ID do cliente
Opcional.
Só pode ser definido no método create.
Identifica anonimamente uma instância do navegador. Por padrão, esse valor é armazenado como parte do cookie de acompanhamento de análises primário com uma validade de dois anos.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
clientId |
texto | Randomly Generated
|
35009a79-1a05-49d7-b876-2b884d0f825bExemplo de uso:
ga('create', 'UA-XXXX-Y', {
'clientId': '35009a79-1a05-49d7-b876-2b884d0f825b'
});
Taxa de amostra
Opcional.
Só pode ser definido no método create.
Especifica a porcentagem de usuários que deve ser acompanhada. O padrão é 100 (nenhum usuário é excluído da amostra), mas grandes sites podem precisar usar uma taxa de amostragem menor para ficar dentro dos limites de processamento do Google Analytics.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
sampleRate |
número | 100
|
5Exemplo de uso:
ga('create', 'UA-XXXX-Y', {'sampleRate': 5});
Taxa de amostra da velocidade do site
Opcional.
Só pode ser definido no método create.
Essa configuração determina a frequência com que os beacons de acompanhamento da velocidade do site são enviados. Por padrão, 1% dos usuários são acompanhados automaticamente.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
siteSpeedSampleRate |
número | 1
|
10Exemplo de uso:
ga('create', 'UA-XXXX-Y', {'siteSpeedSampleRate': 10});
Sempre enviar o referenciador
Opcional.
Só pode ser definido no método create.
Por padrão, o URL do referenciador HTTP, que é usado para atribuir origens de tráfego, só é enviado quando o nome do host do site de referência é diferente do nome do host da página atual. Ative essa configuração somente se você deseja processar outras páginas do seu host atual como referências.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
alwaysSendReferrer |
booleano | false
|
trueExemplo de uso:
ga('create', 'UA-XXXX-Y', {'alwaysSendReferrer': true});
Permitir parâmetros de âncora
Opcional.
Só pode ser definido no método create.
Por padrão, analytics.js procura parâmetros de campanha personalizados, como utm_source, utm_medium etc., na âncora e na string de consulta do URL da página atual. Se você definir esse campo como "false", todos os parâmetros de campanha personalizados que aparecem na âncora serão ignorados.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
allowAnchor |
booleano | true
|
falseExemplo de uso:
ga('create', 'UA-XXXX-Y', {'allowAnchor': false});
Nome do cookie
Opcional.
Só pode ser definido no método create.
Nome do cookie usado para armazenar dados de análise
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
cookieName |
texto | _ga
|
gaCookieExemplo de uso:
ga('create', 'UA-XXXX-Y', {'cookieName': 'gaCookie'});
Domínio do cookie
Opcional.
Só pode ser definido no método create.
Especifica o domínio usado para armazenar o cookie do Google Analytics. A configuração como "none" define o cookie sem especificar um domínio.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
cookieDomain |
texto | document.location.hostname (normalized)
|
example.comExemplo de uso:
ga('create', 'UA-XXXX-Y', {'cookieDomain': 'example.com'});
Validade do cookie
Opcional.
Só pode ser definido no método create.
Especifica a validade do cookie em segundos.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
cookieExpires |
número inteiro | 63072000 (two years)
|
86400Exemplo de uso:
ga('create', 'UA-XXXX-Y', {'cookieExpires': 86400});
GAC de armazenamento
Opcional.
Só pode ser definido no método create.
Por padrão, o analytics.js gera um cookie para armazenar informações da campanha. Esse campo pode ser usado para desativar a geração desse cookie.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
storeGac |
booleano | true
|
falseExemplo de uso:
ga('create', 'UA-XXXX-Y', {'storeGac': false});
Domínio do cookie legado
Opcional.
Só pode ser definido no método create.
Esse campo é usado para configurar a maneira como analytics.js procura cookies gerados por scripts de acompanhamento anteriores do Google Analytics, como ga.js e urchin.js.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
legacyCookieDomain |
texto | Nenhum |
store.example.comExemplo de uso:
ga('create', 'UA-XXXX-Y', {'legacyCookieDomain': 'store.example.com'});
Importação do histórico legado
Opcional.
Só pode ser definido no método create.
Especifica se analytics.js deve tentar importar dados do histórico de cookies do ga.js.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
legacyHistoryImport |
booleano | true
|
falseExemplo de uso:
ga('create', 'UA-XXXX-Y', 'auto', {'legacyHistoryImport': false});
Permitir parâmetros do vinculador
Opcional.
Só pode ser definido no método create.
A configuração desse campo como "true" ativa a análise de parâmetros do vinculador em vários domínios usados para transferir o estado entre domínios.
| Nome do campo | Tipo de valor | Valor padrão |
|---|---|---|
allowLinker |
booleano | false
|
trueExemplo de uso:
ga('create', 'UA-XXXX-Y', {allowLinker: true});
Geral
Anonimizar IP
Opcional.
Quando presente, o endereço IP do remetente fica anônimo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
anonymizeIp |
aip
|
booleano | Nenhum | N/D | todos |
trueExemplo de uso:
ga('set', 'anonymizeIp', true);
Origem de dados
Opcional.
Indica a fonte de dados do hit. Os hits enviados do analytics.js terão a origem de dados configurada como "Web". Os hits enviados de um dos SDKs para dispositivos móveis terão a origem de dados configurada como "aplicativo".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
dataSource |
ds
|
texto | Nenhum | Nenhum | todos |
crmExemplo de uso:
ga('set', 'dataSource', 'crm');
Tempo na fila
Opcional.
Usado para coletar hits off-line / latentes. O valor representa o delta de tempo (em milissegundos) entre o momento em que o hit informado ocorreu e o momento em que o hit foi enviado. O valor precisa ser maior ou igual a 0. Valores acima de quatro horas podem fazer com que os hits não sejam processados.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
queueTime |
qt
|
número inteiro | Nenhum | Nenhum | todos |
560Exemplo de uso:
ga('set', 'queueTime', 560);
Forçar SSL
Opcional.
Por padrão, os beacons de acompanhamento enviados de páginas https são enviados com https. Já os beacons enviados de páginas http são enviados com http. A definição de "forceSSL" como "true" força páginas HTTP a também enviar todos os beacons utilizando https.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
forceSSL |
Nenhum | booleano | false
|
N/D | todos |
trueExemplo de uso:
ga('set', 'forceSSL', true);
Transporte
Opcional.
Especifica o mecanismo de transporte pelo qual os hits são enviados. As opções são "beacon", "xhr" ou "image". Por padrão, o analytics.js tenta descobrir o melhor método com base no tamanho do hit e nos recursos do navegador. Se você especificar "beacon" e o navegador do usuário não for compatível com o método "navigator.sendBeacon", ele voltará a ser "image" ou "xhr", dependendo do tamanho do hit.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
transport |
Nenhum | texto | none (automatically determined)
|
Nenhum | todos |
beaconExemplo de uso:
ga('send', 'event', 'click', 'download-me', {transport: 'beacon'});
Uso de beacon
Opcional.
Esta opção foi suspensa. Use "transport". Se você definir essa opção como "true", o cliente será instruído a usar navigator.sendBeacon para enviar o hit. Isso é útil quando você deseja acompanhar um evento imediatamente antes de um usuário sair do seu site, sem atrasar a navegação. Se o navegador não for compatível com navigator.sendBeacon, o hit será enviado normalmente.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
useBeacon |
Nenhum | booleano | false
|
N/D | todos |
trueExemplo de uso:
ga('send', 'event', 'click', 'download-me', {useBeacon: true});
Parâmetro do vinculador
Opcional.
Parâmetro do vinculador para acompanhamento de vários domínios.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
linkerParam |
Nenhum | texto | Nenhum | Nenhum | todos |
_ga=1.231587807.1974034684.1435105198Exemplo de uso:
// Alerts the linker parameter for the default tracker.
ga(function(tracker) {
alert(tracker.get('linkerParam'));
});
Retorno de hit
Opcional.
Função que é chamada após o processamento de um hit. Esse retorno foi criado para sempre ser chamado, seja diretamente após o envio de um hit ou quando for determinado que um hit não pode ser enviado ou que houve falha no envio. Nenhum argumento é transmitido à função quando ela é chamada. Convém evitar usar hitcallBack para executar um código essencial para seu aplicativo, pois é possível que ele não seja chamado em casos raros (por exemplo, se o servidor não responder ou se analytics.js não for carregado). Nesse caso, você pode definir um tempo limite para garantir a execução.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
hitCallback |
Nenhum | função | Nenhum | Nenhum | todos |
// Alerts the user when a hit is sent.
ga('send', 'pageview', {
'hitCallback': function() {
alert('hit sent');
}
});
// Use a timeout to ensure the execution of critical application code.
ga('send', 'pageview', {'hitCallback': criticalCode});
setTimeout(criticalCode, 2000);
// Only run the critical code once.
var alreadyCalled = false;
function criticalCode() {
if (alreadyCalled) return;
alreadyCalled = true;
// Run critical code here...
}
Usuário
User ID
Opcional.
Esse campo é obrigatório quando o ID de cliente (cid) não é especificado na solicitação. O objetivo é criar um identificador conhecido para um usuário fornecido pelo proprietário do site/usuário da biblioteca de acompanhamento. Ele não pode conter PII (informações de identificação pessoal). O valor nunca deve ser mantido em cookies ou em outras formas de armazenamento do Google Analytics.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
userId |
uid
|
texto | Nenhum | Nenhum | todos |
as8eknlllExemplo de uso:
// Set the user ID when creating the tracker.
ga('create', 'UA-XXXX-Y', {'userId': 'as8eknlll'});
// Alternatively, you may set the user ID via the `set` method.
ga('set', 'userId', 'as8eknlll');
Sessão
Controle de sessão
Opcional.
Utilizado para controlar a duração da sessão. Um valor "start" força o início de uma nova sessão com esse hit, e "end" força a sessão atual a terminar com esse hit. Todos os outros valores são ignorados.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
sessionControl |
sc
|
texto | Nenhum | Nenhum | todos |
startExemplo de uso:
// Starts a new session.
ga('send', 'pageview', {'sessionControl': 'start'});
Origens de tráfego
Referenciador do documento
Opcional.
Especifica qual origem de referência gerou tráfego para um website. Esse valor também é utilizado para calcular a origem de tráfego. O formato desse valor é um URL. Esse campo é inicializado pelo comando "create" e só é definido quando o nome do host atual difere do nome do host do referenciador, a menos que o campo "alwaysSendReferrer" esteja definido como "true".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
referrer |
dr
|
texto | document.referrer
|
2.048 bytes | todos |
http://example.comExemplo de uso:
ga('set', 'referrer', 'http://example.com');
Nome da campanha
Opcional.
Especifica o nome da campanha.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
campaignName |
cn
|
texto | Nenhum | 100 bytes | todos |
(direct)Exemplo de uso:
ga('set', 'campaignName', '(direct)');
Origem da campanha
Opcional.
Especifica a origem da campanha.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
campaignSource |
cs
|
texto | Nenhum | 100 bytes | todos |
(direct)Exemplo de uso:
ga('set', 'campaignSource', '(direct)');
Mídia da campanha
Opcional.
Especifica a mídia da campanha.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
campaignMedium |
cm
|
texto | Nenhum | 50 bytes | todos |
organicExemplo de uso:
ga('set', 'campaignMedium', 'organic');
Palavra-chave da campanha
Opcional.
Especifica a palavra-chave da campanha.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
campaignKeyword |
ck
|
texto | Nenhum | 500 bytes | todos |
Blue ShoesExemplo de uso:
ga('set', 'campaignKeyword', 'Blue Shoes');
Conteúdo da campanha
Opcional.
Especifica o conteúdo da campanha.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
campaignContent |
cc
|
texto | Nenhum | 500 bytes | todos |
contentExemplo de uso:
ga('set', 'campaignContent', 'content');
ID da campanha
Opcional.
Especifica o ID da campanha.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
campaignId |
ci
|
texto | Nenhum | 100 bytes | todos |
IDExemplo de uso:
ga('set', 'campaignId', 'ID');
Informações do sistema
Resolução da tela
Opcional.
Especifica a resolução da tela. Este campo é iniciado pelo comando "create".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
screenResolution |
sr
|
texto | Nenhum | 20 bytes | todos |
800x600Exemplo de uso:
ga('set', 'screenResolution', '800x600');
Tamanho da janela de visualização
Opcional.
Especifica a área visível do navegador / dispositivo. Este campo é iniciado pelo comando "create".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
viewportSize |
vp
|
texto | Nenhum | 20 bytes | todos |
123x456Exemplo de uso:
ga('set', 'viewportSize', '123x456');
Codificação do documento
Opcional.
Especifica o conjunto de caracteres usado para codificar a página / o documento. Este campo é iniciado pelo comando "create".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
encoding |
de
|
texto | UTF-8
|
20 bytes | todos |
UTF-8Exemplo de uso:
ga('set', 'encoding', 'UTF-16');
Cores da tela
Opcional.
Especifica a profundidade da cor da tela. Este campo é iniciado pelo comando "create".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
screenColors |
sd
|
texto | Nenhum | 20 bytes | todos |
24-bitsExemplo de uso:
ga('set', 'screenColors', '8-bit');
Idioma do usuário
Opcional.
Especifica o idioma. Este campo é iniciado pelo comando "create".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
language |
ul
|
texto | Nenhum | 20 bytes | todos |
en-usExemplo de uso:
ga('set', 'language', 'en-us');
Java ativado
Opcional.
Especifica se o Java foi ativado. Este campo é iniciado pelo comando "create".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
javaEnabled |
je
|
booleano | Nenhum | N/D | todos |
trueExemplo de uso:
ga('set', 'javaEnabled', true);
Versão do Flash
Opcional.
Especifica a versão do Flash. Este campo é iniciado pelo comando "create".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
flashVersion |
fl
|
texto | Nenhum | 20 bytes | todos |
10 1 r103Exemplo de uso:
ga('set', 'flashVersion', '10 1 r103');
Hit
Tipo de hit
Obrigatório para todos os tipos de hit.
O tipo de hit. Precisa ser "pageview", "screenview", "event", "transaction", "item", "social", "exception" ou "timing".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
hitType |
t
|
texto | Nenhum | Nenhum | todos |
pageviewExemplo de uso:
ga('send', {
'hitType': 'pageview',
'page': '/home'
});
Hit que não é de interação
Opcional.
Especifica que um hit seja considerado não interativo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
nonInteraction |
ni
|
booleano | Nenhum | N/D | todos |
trueExemplo de uso:
ga('set', 'nonInteraction', true);
Informações do conteúdo
URL de localização do documento
Opcional.
Especifica o URL completo (exceto a âncora) da página. Este campo é iniciado pelo comando "create".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
location |
dl
|
texto | Nenhum | 2.048 bytes | todos |
http://foo.com/home?a=bExemplo de uso:
ga('set', 'location', 'http://foo.com/home?a=b');
Nome do host do documento
Opcional.
Especifica o nome do host no qual o conteúdo foi hospedado.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
hostname |
dh
|
texto | Nenhum | 100 bytes | todos |
foo.comExemplo de uso:
ga('set', 'hostname', 'foo.com');
Caminho do documento
Opcional.
A parte do caminho do URL da página. Precisa começar com "/". Para hits de "pageview", "&dl" ou "&dh" e "&dp" precisam ser especificados para que o hit seja válido. Usado para especificar caminhos de páginas virtuais.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
page |
dp
|
texto | Nenhum | 2.048 bytes | todos |
/fooExemplo de uso:
ga('set', 'page', '/foo');
Título do documento
Opcional.
O título da página / do documento. O padrão é document.title.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
title |
dt
|
texto | Nenhum | 1.500 bytes | todos |
SettingsExemplo de uso:
ga('set', 'title', 'Settings');
Nome da tela
Obrigatório para o tipo de hit de exibição de tela.
Esse parâmetro é opcional em propriedades da Web e obrigatório em propriedades para dispositivos móveis para hits de exibição de página, onde ele é usado como o "Nome da tela" no hit de exibição de página. Em propriedades da Web, ele assumirá como padrão o URL exclusivo da página usando o parâmetro "&dl" sem alterações ou montando-o com "&dh" e "&dp".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
screenName |
cd
|
texto | Nenhum | 2.048 bytes | exibição de tela |
High ScoresExemplo de uso:
ga('set', 'screenName', 'High Scores');
Grupo de conteúdo
Opcional.
É possível ter até cinco Agrupamentos de conteúdo, cada um dos quais tem um índice associado entre 1 e 5, inclusive. Cada Agrupamento de conteúdo pode ter até cem grupos de conteúdo. O valor de um grupo de conteúdo é um texto hierárquico delimitado por "/". Todas as barras iniciais e finais serão removidas, e as barras repetidas serão reduzidas a uma única barra. Por exemplo, "/a//b/" será convertido em "a/b".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
contentGroup |
cg<groupIndex>
|
texto | Nenhum | 100 bytes | todos |
news/sportsExemplo de uso:
ga('set', 'contentGroup5', '/news/sports');
ID do link
Opcional.
O ID de um elemento DOM clicado, usado para remover a ambiguidade de vários links para o mesmo URL nos Relatórios de Análise de Página quando a Atribuição melhorada de link está ativada para a propriedade.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
linkid |
linkid
|
texto | Nenhum | Nenhum | todos |
nav_barExemplo de uso:
ga('set', '&linkid', 'html-element-id');
Acompanhamento de aplicativos
Nome do aplicativo
Opcional.
Especifica o nome do aplicativo. Esse campo é obrigatório para qualquer hit com dados de aplicativo relacionados (ou seja, versão aplicativo, ID do aplicativo ou Código do instalador do aplicativo). Para hits enviados a propriedades da Web, ele é opcional.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
appName |
an
|
texto | Nenhum | 100 bytes | todos |
My AppExemplo de uso:
ga('set', 'appName', 'My App');
ID do aplicativo
Opcional.
Identificador do aplicativo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
appId |
aid
|
texto | Nenhum | 150 bytes | todos |
com.company.appExemplo de uso:
ga('set', 'appId', 'com.company.app');
Versão do aplicativo
Opcional.
Especifica a versão do aplicativo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
appVersion |
av
|
texto | Nenhum | 100 bytes | todos |
1.2Exemplo de uso:
ga('set', 'appVersion', '1.2');
ID do instalador do aplicativo
Opcional.
Identificador do instalador do aplicativo.nstaller identifier.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
appInstallerId |
aiid
|
texto | Nenhum | 150 bytes | todos |
com.platform.vendingExemplo de uso:
ga('set', 'appInstallerId', 'com.platform.vending');
Acompanhamento de eventos
Categoria do evento
Obrigatório para o tipo de hit de evento.
Especifica a categoria do evento. Não pode estar vazio.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
eventCategory |
ec
|
texto | Nenhum | 150 bytes | event |
CategoryExemplo de uso:
ga('send', 'event', {
'eventCategory': 'Category',
'eventAction': 'Action'
});
Ação do evento
Obrigatório para o tipo de hit de evento.
Especifica a ação do evento. Não pode estar vazio.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
eventAction |
ea
|
texto | Nenhum | 500 bytes | event |
ActionExemplo de uso:
ga('send', 'event', {
'eventCategory': 'Category',
'eventAction': 'Action'
});
Rótulo do evento
Opcional.
Especifica o rótulo do evento.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
eventLabel |
el
|
texto | Nenhum | 500 bytes | event |
LabelExemplo de uso:
ga('send', 'event', {
'eventCategory': 'Category',
'eventAction': 'Action',
'eventLabel': 'Label'
});
Valor do evento
Opcional.
Especifica o valor do evento. Os valores não podem ser negativos.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
eventValue |
ev
|
número inteiro | Nenhum | Nenhum | event |
55Exemplo de uso:
ga('send', 'event', {
'eventCategory': 'Category',
'eventAction': 'Action',
'eventValue': 55
});
Comércio eletrônico avançado
SKU do produto
Opcional.
O SKU do produto. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product) id |
pr<productIndex>id
|
texto | Nenhum | 500 bytes | todos |
P12345Exemplo de uso:
ga('ec:addProduct', {'id': 'P12345'});
Nome do produto
Opcional.
O nome do produto. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product) name |
pr<productIndex>nm
|
texto | Nenhum | 500 bytes | todos |
Android T-ShirtExemplo de uso:
ga('ec:addProduct', {'name': 'Android T-Shirt'});
Marca do produto
Opcional.
A marca associada ao produto. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product) brand |
pr<productIndex>br
|
texto | Nenhum | 500 bytes | todos |
GoogleExemplo de uso:
ga('ec:addProduct', {'brand': 'Google'});
Categoria do produto
Opcional.
A categoria à qual o produto pertence. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. O parâmetro da categoria do produto pode ser hierárquico. Use "/" como delimitador para especificar até cinco níveis de hierarquia. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product) category |
pr<productIndex>ca
|
texto | Nenhum | 500 bytes | todos |
ApparelExemplo de uso:
ga('ec:addProduct', {'category': 'Apparel'});
Variação do produto
Opcional.
A variante do produto. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product) variant |
pr<productIndex>va
|
texto | Nenhum | 500 bytes | todos |
BlackExemplo de uso:
ga('ec:addProduct', {'variant': 'Black'});
Preço do produto
Opcional.
O preço unitário de um produto. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product) price |
pr<productIndex>pr
|
moeda | Nenhum | Nenhum | todos |
29.20Exemplo de uso:
ga('ec:addProduct', {'price': '29.20'});
Quantidade do produto
Opcional.
A quantidade de um produto. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product) quantity |
pr<productIndex>qt
|
número inteiro | Nenhum | Nenhum | todos |
2Exemplo de uso:
ga('ec:addProduct', {'quantity': 2});
Código de cupom do produto
Opcional.
O código do cupom associado a um produto. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product) coupon |
pr<productIndex>cc
|
texto | Nenhum | 500 bytes | todos |
SUMMER_SALE13Exemplo de uso:
ga('ec:addProduct', {'coupon': 'SUMMER_SALE13'});
Posição do produto
Opcional.
A posição do produto em uma lista ou conjunto. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product) position |
pr<productIndex>ps
|
número inteiro | Nenhum | Nenhum | todos |
2Exemplo de uso:
ga('ec:addProduct', {'position': 2});
Dimensão personalizada do produto
Opcional.
A dimensão personalizada no nível do produto em que o índice da dimensão é um número inteiro positivo entre 1 e 200, inclusive. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product) dimension |
pr<productIndex>cd<dimensionIndex>
|
texto | Nenhum | 150 bytes | todos |
MemberExemplo de uso:
ga('ec:addProduct', {'dimension1': 'Member'});
Métrica personalizada do produto
Opcional.
A métrica personalizada no nível do produto em que o índice da métrica é um número inteiro positivo entre 1 e 200, inclusive. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product) metric |
pr<productIndex>cm<metricIndex>
|
número inteiro | Nenhum | Nenhum | todos |
28Exemplo de uso:
ga('ec:addProduct', {'metric1': 28});
Ação do produto
Opcional.
O papel dos produtos incluídos em um hit. Se a ação de um produto não for especificada, todas as definições de produto incluídas com o hit serão ignoradas. Precisa ser uma destas opções: detail, click, add, remove, checkout, checkout_option, purchase e refund. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product action) |
pa
|
texto | Nenhum | Nenhum | todos |
detailExemplo de uso:
ga('ec:setAction', 'detail');
ID da transação
Opcional.
O ID da transação. Ele é um parâmetro adicional que pode ser enviado quando a ação do produto for definida como "purchase" ou "refund". Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product action) id |
ti
|
texto | Nenhum | Nenhum | todos |
T1234Exemplo de uso:
ga('ec:setAction', 'purchase', {'id': 'T1234'});
Afiliação
Opcional.
A loja ou afiliação na qual essa transação ocorreu. Ele é um parâmetro adicional que pode ser enviado quando a ação do produto for definida como "purchase" ou "refund". Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product action) affiliation |
ta
|
texto | Nenhum | Nenhum | todos |
Google StoreExemplo de uso:
ga('ec:setAction', 'purchase', {'affiliation': 'Google Store'});
Receita
Opcional.
O valor total da transação, incluindo impostos e frete. Se não for enviado, esse valor será calculado automaticamente usando os campos de quantidade do produto e preço de todos os produtos no mesmo hit. Ele é um parâmetro adicional que pode ser enviado quando a ação do produto for definida como "purchase" ou "refund". Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product action) revenue |
tr
|
moeda | Nenhum | Nenhum | todos |
123.21Exemplo de uso:
ga('ec:setAction', 'purchase', {'revenue': '123.21'});
Imposto
Opcional.
O total de impostos associados à transação. Ele é um parâmetro adicional que pode ser enviado quando a ação do produto for definida como "purchase" ou "refund". Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product action) tax |
tt
|
moeda | Nenhum | Nenhum | todos |
10.78Exemplo de uso:
ga('ec:setAction', 'purchase', {'tax': '10.78'});
Envio
Opcional.
O custo de envio associado à transação. Ele é um parâmetro adicional que pode ser enviado quando a ação do produto for definida como "purchase" ou "refund". Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product action) shipping |
ts
|
moeda | Nenhum | Nenhum | todos |
3.55Exemplo de uso:
ga('ec:setAction', 'purchase', {'shipping': '3.55'});
Código do cupom
Opcional.
O cupom resgatado na transação. Ele é um parâmetro adicional que pode ser enviado quando a ação do produto for definida como "purchase" ou "refund". Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product action) coupon |
tcc
|
texto | Nenhum | Nenhum | todos |
SUMMER08Exemplo de uso:
ga('ec:setAction', 'purchase', {'coupon': 'SUMMER08'});
Lista de ações do produto
Opcional.
A lista ou coleção em que uma ação do produto ocorreu. Ele é um parâmetro adicional que pode ser enviado quando a ação do produto for definida como "detail" ou "click". Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product action) list |
pal
|
texto | Nenhum | Nenhum | todos |
Search ResultsExemplo de uso:
ga('ec:setAction', 'click', {'list': 'Search Results'});
Etapa de checkout
Opcional.
O número da etapa em um funil de checkout. Ele é um parâmetro adicional que pode ser enviado quando a ação do produto for definida como "checkout". Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product action) step |
cos
|
número inteiro | Nenhum | Nenhum | todos |
2Exemplo de uso:
ga('ec:setAction', 'checkout', {'step': 2});
Opção de etapa de checkout
Opcional.
Informações adicionais sobre uma etapa de checkout. Ele é um parâmetro adicional que pode ser enviado quando a ação do produto for definida como "checkout". Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(product action) option |
col
|
texto | Nenhum | Nenhum | todos |
VisaExemplo de uso:
ga('ec:setAction', 'checkout', {'option': 'Visa'});
Nome da lista de impressões do produto
Opcional.
A lista ou o conjunto ao qual um produto pertence. O índice da lista de impressões precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(impression) list |
il<listIndex>nm
|
texto | Nenhum | Nenhum | todos |
Search ResultsExemplo de uso:
ga('ec:addImpression', {'list': 'Search Results'});
SKU das impressões do produto
Opcional.
O ID ou SKU do produto. O índice da lista de impressões precisa ser um número inteiro positivo entre 1 e 200, inclusive. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(impression) id |
il<listIndex>pi<productIndex>id
|
texto | Nenhum | Nenhum | todos |
P67890Exemplo de uso:
ga('ec:addImpression', {'id': 'P67890'});
Nome das impressões do produto
Opcional.
O nome do produto. O índice da lista de impressões precisa ser um número inteiro positivo entre 1 e 200, inclusive. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(impression) name |
il<listIndex>pi<productIndex>nm
|
texto | Nenhum | Nenhum | todos |
Android T-ShirtExemplo de uso:
ga('ec:addImpression', {'name': 'Android T-Shirt'});
Marca das impressões do produto
Opcional.
A marca associada ao produto. O índice da lista de impressões precisa ser um número inteiro positivo entre 1 e 200, inclusive. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(impression) brand |
il<listIndex>pi<productIndex>br
|
texto | Nenhum | Nenhum | todos |
GoogleExemplo de uso:
ga('ec:addImpression', {'brand': 'Google'});
Categoria das impressões do produto
Opcional.
A categoria à qual o produto pertence. O índice da lista de impressões precisa ser um número inteiro positivo entre 1 e 200, inclusive. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(impression) category |
il<listIndex>pi<productIndex>ca
|
texto | Nenhum | Nenhum | todos |
ApparelExemplo de uso:
ga('ec:addImpression', {'category': 'Apparel'});
Variação das impressões do produto
Opcional.
A variante do produto. O índice da lista de impressões precisa ser um número inteiro positivo entre 1 e 200, inclusive. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(impression) variant |
il<listIndex>pi<productIndex>va
|
texto | Nenhum | Nenhum | todos |
BlackExemplo de uso:
ga('ec:addImpression', {'variant': 'Black'});
Posição das impressões do produto
Opcional.
A posição do produto em uma lista ou conjunto. O índice da lista de impressões precisa ser um número inteiro positivo entre 1 e 200, inclusive. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(impression) position |
il<listIndex>pi<productIndex>ps
|
número inteiro | Nenhum | Nenhum | todos |
2Exemplo de uso:
ga('ec:addImpression', {'position': 2});
Preço das impressões do produto
Opcional.
O preço de um produto. O índice da lista de impressões precisa ser um número inteiro positivo entre 1 e 200, inclusive. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(impression) price |
il<listIndex>pi<productIndex>pr
|
moeda | Nenhum | Nenhum | todos |
29.20Exemplo de uso:
ga('ec:addImpression', {'price': '29.20'});
Dimensão personalizada das impressões do produto
Opcional.
A dimensão personalizada no nível do produto em que o índice da dimensão é um número inteiro positivo entre 1 e 200, inclusive. O índice da lista de impressões precisa ser um número inteiro positivo entre 1 e 200, inclusive. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(impression) dimension |
il<listIndex>pi<productIndex>cd<dimensionIndex>
|
texto | Nenhum | Nenhum | todos |
MemberExemplo de uso:
ga('ec:addImpression', {'dimension1': 'Member'});
Métrica personalizada das impressões do produto
Opcional.
A métrica personalizada no nível do produto em que o índice da métrica é um número inteiro positivo entre 1 e 200, inclusive. O índice da lista de impressões precisa ser um número inteiro positivo entre 1 e 200, inclusive. O índice do produto precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(impression) metric |
il<listIndex>pi<productIndex>cm<metricIndex>
|
número inteiro | Nenhum | Nenhum | todos |
28Exemplo de uso:
ga('ec:addImpression', {'metric1': '28'});
ID da promoção
Opcional.
O ID da promoção. O índice da promoção precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(promo) id |
promo<promoIndex>id
|
texto | Nenhum | Nenhum | todos |
SHIPExemplo de uso:
ga('ec:addPromo', {'id': 'SHIP'});
Nome da promoção
Opcional.
O nome da promoção. O índice da promoção precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(promo) name |
promo<promoIndex>nm
|
texto | Nenhum | Nenhum | todos |
Free ShippingExemplo de uso:
ga('ec:addPromo', {'name': 'Free Shipping'});
Criativo da promoção
Opcional.
O criativo associado à promoção. O índice da promoção precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(promo) creative |
promo<promoIndex>cr
|
texto | Nenhum | Nenhum | todos |
Shipping BannerExemplo de uso:
ga('ec:addPromo', {'creative': 'Shipping Banner'});
Posição da promoção
Opcional.
A posição da peça criativa. O índice da promoção precisa ser um número inteiro positivo entre 1 e 200, inclusive. Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(promo) position |
promo<promoIndex>ps
|
texto | Nenhum | Nenhum | todos |
banner_slot_1Exemplo de uso:
ga('ec:addPromo', {'position': 'banner_slot_1'});
Ação da promoção
Opcional.
Especifica o papel das promoções incluídas em um hit. Se uma ação de promoção não for especificada, a ação de promoção padrão, "view", é definida como padrão. Para avaliar o clique de um usuário em uma promoção, defina esse valor como "promo_click". Para o analytics.js, o plug-in do comércio eletrônico avançado precisa ser instalado antes do uso desse campo.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
(promo) action |
promoa
|
texto | Nenhum | Nenhum | todos |
clickExemplo de uso:
ga('ec:setAction', 'promo_click'});
Código da moeda
Opcional.
Quando presente indica a moeda local dos valores monetários de todas as transações. O valor deve ser um código de moeda ISO 4217 válido.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
currencyCode |
cu
|
texto | Nenhum | 10 bytes | todos |
EURExemplo de uso:
ga('set', 'currencyCode', 'EUR');
Interações em redes sociais
Rede social
Necessário para o tipo de hit "social".
Especifica a rede social, por exemplo, Facebook ou Google Plus.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
socialNetwork |
sn
|
texto | Nenhum | 50 bytes | social |
facebookExemplo de uso:
ga('send', 'social', {
'socialNetwork': 'facebook',
'socialAction': 'like',
'socialTarget': 'http://foo.com'
})
Atividade em redes sociais
Necessário para o tipo de hit "social".
Especifica a atividade de interação de rede social. Por exemplo, no Google Plus, quando um usuário clica no botão +1, a atividade em redes sociais é "plus".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
socialAction |
sa
|
texto | Nenhum | 50 bytes | social |
likeExemplo de uso:
ga('send', 'social', {
'socialNetwork': 'facebook',
'socialAction': 'like',
'socialTarget': 'http://foo.com'
})
Destino da atividade em redes sociais
Necessário para o tipo de hit "social".
Especifica o destino de uma interação em redes sociais. Esse valor é normalmente um URL, mas pode ser qualquer texto.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
socialTarget |
st
|
texto | Nenhum | 2.048 bytes | social |
http://foo.comExemplo de uso:
ga('send', 'social', {
'socialNetwork': 'facebook',
'socialAction': 'like',
'socialTarget': 'http://foo.com'
})
Velocidade
Categoria de velocidade do usuário
Obrigatório para o tipo de hit de velocidade.
Especifica a categoria de velocidade do usuário.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
timingCategory |
utc
|
texto | Nenhum | 150 bytes | timing |
categoryExemplo de uso:
ga('send', 'timing', {
'timingCategory': 'category',
'timingVar': 'lookup',
'timingValue': 123
});
Nome da variável de velocidade do usuário
Obrigatório para o tipo de hit de velocidade.
Especifica a variável de velocidade do usuário.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
timingVar |
utv
|
texto | Nenhum | 500 bytes | timing |
lookupExemplo de uso:
ga('send', 'timing', {
'timingCategory': 'category',
'timingVar': 'lookup',
'timingValue': 123
});
Horário da velocidade do usuário
Obrigatório para o tipo de hit de velocidade.
Especifica o valor da velocidade do usuário. O valor é em milissegundos.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
timingValue |
utt
|
número inteiro | Nenhum | Nenhum | timing |
123Exemplo de uso:
ga('send', 'timing', {
'timingCategory': 'category',
'timingVar': 'lookup',
'timingValue': 123
});
Rótulo de velocidade do usuário
Opcional.
Especifica o rótulo da velocidade do usuário.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
timingLabel |
utl
|
texto | Nenhum | 500 bytes | timing |
labelExemplo de uso:
ga('send', 'timing', {
'timingCategory': 'category',
'timingVar': 'lookup',
'timingValue': 123,
'timingLabel': 'label'
});
Exceções
Descrição da exceção
Opcional.
Especifica a descrição de uma exceção.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
exDescription |
exd
|
texto | Nenhum | 150 bytes | exception |
DatabaseErrorExemplo de uso:
ga('send', 'exception', {
'exDescription': 'DatabaseError'
});
A exceção é fatal?
Opcional.
Especifica se a exceção foi fatal.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
exFatal |
exf
|
booleano | 1
|
N/D | exception |
trueExemplo de uso:
ga('send', 'exception', {
'exFatal': true
});
Dimensões / métricas personalizadas
Dimensão personalizada
Opcional.
Cada dimensão personalizada tem um índice associado. O número máximo de dimensões personalizadas é 20 (200 para contas do Analytics 360). O índice da dimensão precisa ser um número inteiro positivo entre 1 e 200, inclusive.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
dimension |
cd<dimensionIndex>
|
texto | Nenhum | 150 bytes | todos |
SportsExemplo de uso:
ga('set', 'dimension14', 'Sports');
Métrica personalizada
Opcional.
Cada métrica personalizada tem um índice associado. O número máximo de métricas personalizadas é 20 (200 para contas do Analytics 360). O índice da métrica precisa ser um número inteiro positivo entre 1 e 200, inclusive.
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
metric |
cm<metricIndex>
|
número | Nenhum | Nenhum | todos |
47Exemplo de uso:
ga('set', 'metric7', 47);
Experiências de conteúdo
Código do experimento
Opcional.
Esse parâmetro especifica que o usuário foi exposto a uma experiência com o ID fornecido. Ele deve ser enviado em conjunto com o parâmetro "Variação da experiência".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
expId |
xid
|
texto | Nenhum | 40 bytes | todos |
Qp0gahJ3RAO3DJ18b0XoUQExemplo de uso:
ga('set', 'expId', 'Qp0gahJ3RAO3DJ18b0XoUQ');
Variação da experiência
Opcional.
Este parâmetro especifica que esse usuário foi exposto a uma determinada variação de uma experiência. Ele deve ser enviado em conjunto com o parâmetro "ID da experiência".
| Nome do campo | Parâmetro de protocolo | Tipo de valor | Valor padrão | Tamanho máximo | Tipos de hit suportados |
|---|---|---|---|---|---|
expVar |
xvar
|
texto | Nenhum | Nenhum | todos |
1Exemplo de uso:
ga('set', 'expVar', '1');