Código de acompanhamento: acompanhamento da campanha

Esta referência descreve os métodos usados para configurar e personalizar o acompanhamento de campanhas nos relatórios do Google Analytics.

Métodos de acompanhamento de campanha GATC

Detalhes dos métodos

_setAllowAnchor()

_setAllowAnchor(bool)

Esse método define o sinal # como o delimitador da string de consulta no acompanhamento de campanhas. Essa opção é definida como false por padrão.

Os URLs de acompanhamento de campanha convencionais usam o ponto de interrogação (?) para indicar o início dos pares de chave-valor que compõem a consulta. Se você definir essa opção como verdadeira, os URLs de monitoramento da campanha poderão usar uma cerquilha (#) em vez do ponto de interrogação (?) para indicar o início da string de consulta.

Snippet assíncrono (recomendado) 
http://mysite.net/index.html#utm_source=In+House&utm_medium=email&utm_campaign=Fall+email+offers
_gaq.push(['_setAllowAnchor', true]);

parâmetros

Boolean  true ou false Se esse parâmetro for definido como true, a campanha usará âncoras. Do contrário, a campanha usará strings de pesquisa.

_setCampContentKey()

_setCampContentKey(newCampContentKey)

Define a chave do conteúdo do anúncio da campanha. A chave de conteúdo da campanha é usada para recuperar o conteúdo do anúncio (descrição) da sua campanha publicitária nos URLs da campanha. Use essa função na página de destino definida na campanha.

Por exemplo, suponha que você tenha um anúncio em outro site com o seguinte URL:

http://mysite.net/index.html?utm_source=giganoshopper.com&utm_medium=referral&utm_campaign=Christmas+specials&description=Garden+gloves

Nesse URL, a chave "descrição" delimita o conteúdo fornecido no URL para a campanha em questão. Esses termos e frases aparecem na coluna "Conteúdo do anúncio", na página de detalhes da campanha, no Relatório de origens de tráfego. Para usar essa chave como sua chave de conteúdo de campanha personalizada, defina:

Snippet assíncrono (recomendado) 
_gaq.push(['_setCampContentKey', 'description']);

parâmetros

String   newCampContentKey Nova chave de conteúdo da campanha a ser definida.

_setCampMediumKey()

_setCampMediumKey(newCampMedKey)
Define a chave da mídia da campanha, que é usada para recuperar a mídia dos URLs da campanha. A mídia aparece como uma opção de segmento no Relatório de campanhas.

Por exemplo, suponha que você tenha um anúncio em outro site com este URL para seu site: 

http://mysite.net/index.html?utm_source=giganoshopper.com&method=ad&utm_campaign=Christmas+specials&utm_content=Garden+gloves


Nesse URL, a chave "método" descreve a mídia no URL para essa campanha.

Snippet assíncrono (recomendado) 
_gaq.push(['_setCampMediumKey', 'method']);

parâmetros

String   newCampMedKey Chave da mídia da campanha a ser definida.

_setCampNameKey()

_setCampNameKey(newCampNameKey)
Define a chave do nome da campanha. A chave do nome da campanha é usada para recuperar o nome da sua campanha publicitária dos URLs dela. Use essa função em qualquer página em que queira acompanhar campanhas de cliques.

Por exemplo, suponha que você envie um e-mail para usuários registrados sobre uma oferta especial, e o link para essa oferta tenha este formato: 

http://mysite.net/index.html?utm_source=In+House&utm_medium=email&offer_type=Fall+email+offers


Nesse URL, a chave "offer_type" delineia o nome fornecido no URL para essa campanha. Esse é o nome que aparece na lista de campanhas no Relatório de origens de tráfego.

Snippet assíncrono (recomendado) 
_gaq.push(['_setCampNameKey', 'offer_type']);

parâmetros

String   newCampNameKey Chave do nome da campanha.

_setCampNOKey()

_setCampNOKey(newCampNOKey)
Define a variável da chave de não substituição da campanha, que é usada para recuperar o valor de não substituição da campanha do URL. Por padrão, essa variável e o valor dela não são definidos. Para o acompanhamento de campanhas e a medição de conversões, isso significa que, por padrão, a impressão mais recente é a campanha creditada no acompanhamento de conversões. Se você preferir associar as primeiras impressões a uma conversão, defina esse método como uma chave específica. Na situação em que você usa variáveis de campanha personalizadas, use esse método para definir o nome da variável para as substituições de campanha. O valor de não substituição impede que os dados da campanha sejam substituídos por URLs de campanha definidos de maneira semelhante, nos quais o visitante também pode clicar.

Se você tiver um anúncio em outro site com este URL para seu site: 

http://mysite.net/index.html?utm_source=giganoshopper.com&utm_medium=referral&utm_campaign=Christmas+specials&utm_content=Garden+gloves&noo=1234


Nesse URL, a chave "noo" delimita o valor de não substituição no URL dessa campanha.

Snippet assíncrono (recomendado) 
_gaq.push(['_setCampNOKey', 'noo']);

parâmetros

String   newCampNOKey Chave de não substituição da campanha a ser definida.

_setCampSourceKey()

_setCampSourceKey(newCampSrcKey)
Define a chave de origem da campanha, que é usada para recuperar a origem da campanha do URL. A "origem" aparece como uma opção de segmento no relatório Campanhas.

Por exemplo, suponha que você tenha um anúncio em outro site com este URL para seu site: 

http://mysite.net/index.html?source=giganoshopper.com&utm_medium=referral&utm_campaign=Christmas+specials&utm_content=Garden+gloves


Nesse URL, a chave "origem" delimita a origem no URL para essa campanha.

Snippet assíncrono (recomendado) 
_gaq.push(['_setCampSourceKey', 'source']);

parâmetros

String   newCampSrcKey Chave de origem da campanha a ser definida.

_setCampTermKey()

_setCampTermKey(newCampTermKey)
Define a chave do termo da campanha, que é usada para recuperar as palavras-chave da campanha do URL.

Por exemplo, suponha que você tenha um anúncio pago em um mecanismo de pesquisa com as seguintes tags: 

http://mysite.net/index.html?source=weSearch4You.com&utm_medium=paidSearchAd&utm_campaign=Christmas+specials&utm_content=Garden+gloves&term=garden+tools


Nesse URL, a chave "termo" delimita os termos da palavra-chave no URL para essa campanha.

Snippet assíncrono (recomendado) 
_gaq.push(['_setCampTermKey', 'term']);

parâmetros

String   newCampTermKey Chave de termo a ser definida.

_setCampaignTrack()

_setCampaignTrack(bool)
Define a sinalização do acompanhamento da campanha. Por padrão, o acompanhamento de campanhas é definido como true na configuração padrão do Google Analytics. Para desativar o acompanhamento de campanhas e os cookies associados que são definidos para o acompanhamento de campanhas, use este método.

parâmetros

Boolean   true ou false Verdadeiro por padrão, o que ativa o acompanhamento de campanhas. Se definido como false, o acompanhamento de campanhas será desativado.

_setCampaignCookieTimeout()

_setCampaignCookieTimeout(cookieTimeoutMillis)

Define a data de validade do cookie de acompanhamento da campanha em milissegundos. Por padrão, o acompanhamento de campanha é definido como seis meses. Dessa forma, é possível determinar em um período de seis meses se os visitantes do seu site foram convertidos com base em uma campanha específica. No entanto, como sua empresa pode ter um período de campanha mais longo ou mais curto, use esse método para ajustar o acompanhamento de campanhas de acordo com essa finalidade.

É possível alterar o tempo limite de validade para 0 a fim de indicar que esse cookie deve ser excluído quando o navegador for fechado.

Snippet assíncrono (recomendado) 
_gaq.push(['_setCampaignCookieTimeout', 15768000000]);

parâmetros

Number   cookieTimeoutMillis A data de validade do novo cookie, em milissegundos, ou "0" para excluir o cookie quando o navegador for fechado.

_setCookieTimeout()

_setCookieTimeout(newDefaultTimeout)
Esse método foi descontinuado. Use _setCampaignCookieTimeout(cookieTimeoutMillis).
Define o tempo de validade do cookie de acompanhamento da campanha em segundos. Por padrão, o acompanhamento de campanha é definido como seis meses. Dessa forma, é possível determinar em um período de seis meses se os visitantes do seu site foram convertidos com base em uma campanha específica. No entanto, como sua empresa pode ter um período de campanha mais longo ou mais curto, use esse método para ajustar o acompanhamento de campanhas de acordo com essa finalidade.
Snippet assíncrono (recomendado) 
_gaq.push(['_setCookieTimeout', 3152600]);

parâmetros

String   newDefaultTimeout Novo prazo de validade do cookie padrão a ser definido. Transmita como uma string e ela será convertida em um número inteiro.

_setReferrerOverride()

_setReferrerOverride(newReferrerUrl)
Define o URL do referenciador usado para determinar os valores de acompanhamento da campanha. Use esse método para permitir que os gadgets em um iFrame acompanhem as referências corretamente. Por padrão, o acompanhamento de campanhas usa a propriedade document.referrer para determinar o URL do referenciador, que é transmitido no parâmetro utmr da solicitação GIF. No entanto, é possível substituir esse parâmetro por seu próprio valor. Por exemplo, se você definir o novo referenciador como http://www.google.com/search?hl=en&q=hats, o cookie da campanha armazenará uma nova campanha com source=google, medium=organic e keyword=hats.

parâmetros

String   newReferrerOverride O novo URL para o referenciador do documento.