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 da rede 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 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 ativa os recursos de publicidade. O plug-in cria um novo cookie chamado _gat com o tempo limite de um minuto. Esse cookie não armazena informações do usuário e é usado somente para limitar o número de solicitações que precisam ser feitas para doubleclick.net.

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

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

O terceiro argumento costuma ser usado para especificar o local do script. Como esse plug-in é incluído no analytics.js, você pode simplesmente enviar 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 administração do Google Analytics, em alguns casos, você precisará desativá-los de maneira programática.

Para desativar todos os Recursos de publicidade, incluindo remarketing e relatórios, defina allowAdFeatures como false:

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

Quando definido como true (valor padrão), allowAdFeatures permite que o plug-in displayfeatures e as configurações dos 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, mesmo que eles tenham sido ativados pelo plug-in displayfeatures ou no Google Analytics.