Recursos de publicidade

Este guia descreve como usar o plug-in de recursos de publicidade para analytics.js.

Visão geral

Para ativar os Recursos de publicidade do Google Analytics (incluindo listas de remarketing para anúncios de pesquisa), acesse Configurações da propriedade > Coleta de dados. Com o plug-in de recursos de publicidade para analytics.js, você pode ativar os recursos de forma programática, além de substituir e desativar todos os recursos de remarketing e relatórios de publicidade da IU do Google Analytics.

Implementação

O método recomendado é ativar os Recursos de relatórios de publicidade nas configurações da propriedade do Google Analytics.

Para ativar o plug-in de Recursos de publicidade, adicione uma chamada require e especifique o plug-in displayfeatures.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'displayfeatures');
ga('send', 'pageview');

O plug-in envia uma solicitação para stats.g.doubleclick.net, que é usada para ativar os Recursos de publicidade. O plug-in cria um novo cookie chamado _gat que tem um tempo limite de um minuto. Esse cookie não armazena informações do usuário; é usado apenas para limitar o número de solicitações que precisam ser feitas para doubleclick.net.

O nome do cookie padrão é _gat. Você pode mudá-lo definindo a opção cookieName quando precisar do plug-in:

ga('require', 'displayfeatures', {cookieName: 'display_features_cookie'});

O terceiro argumento costuma ser usado para especificar o local do script. Como este plug-in está incluído na analytics.js, você pode simplesmente transmitir undefined.

Usar vários rastreadores

Para usar o plug-in de Recursos de publicidade com vários rastreadores, inclua a chamada require com o nome do rastreador:

// create a tracker named 'foo' for property UA-XXXXX-Y
ga('create', 'UA-XXXXX-Y', {name: 'foo'});
ga('foo.require', 'displayfeatures');
ga('foo.send', 'pageview');

// create a second tracker named 'bar' for a different property UA-XXXX-Z
ga('create', 'UA-XXXXX-Z', {name: 'bar'});
ga('bar.require', 'displayfeatures');
ga('bar.send', 'pageview');

Quando o plug-in de Recursos de publicidade de um rastreador nomeado for carregado, o nome do rastreador será incluído no nome do cookie. O exemplo acima cria os cookies _gat_foo e _gat_bar.

Desativar os Recursos de publicidade

Como os Recursos de publicidade podem ser ativados pelas configurações de administrador do Google Analytics, em alguns casos, você precisará desativá-los de maneira programática.

Para desabilitar todos os Recursos de publicidade com a analytics.js, defina allowAdFeatures como false após o comando create e antes do comando send.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('set', 'allowAdFeatures', false);
ga('send', 'pageview');

Quando definido como true (o valor padrão), allowAdFeatures permite que o plug-in displayfeatures e as configurações de Recursos de publicidade no Google Analytics funcionem. Esse campo sozinho não ativa os recursos.

Defina allowAdFeatures como false para desativar os beacons dos Recursos de publicidade do Google Analytics, independentemente de eles terem sido ativados com o uso do plug-in displayfeatures ou do Google Analytics.

Para desativar apenas os recursos de personalização de publicidade, defina allowAdPersonalizationSignals como false após o comando create e antes do comando send.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('set', 'allowAdPersonalizationSignals', false);
ga('send', 'pageview');