É possível invocar comandos gtag()
em qualquer local da sua página após o snippet global.
Três deles podem ser usados: config
e set
para definir as propriedades gerais e event
para enviar dados.
Inicializar produtos com config
Use o comando config
para inicializar e definir as configurações de uma conta de produto específica. Ele tem o seguinte formato:
gtag('config', '<TARGET_ID>', {<additional_config_info>});
em que <TARGET_ID>
é o ID da conta do produto a que os dados serão enviados, e <additional_config_info>
é um objeto opcional usado para especificar opções de configuração adicionais.
Com o comando config
, é possível definir quais produtos e contas a gtag.js irá gerenciar, além de determinar a configuração associada. Dependendo da especificação em target_ID
, o comando config
também pode iniciar um determinado comportamento para esse produto. Por exemplo, em alguns casos, o config
solicita à gtag.js para gerar um hit de visualização de página. Para saber mais sobre como o comando config
se comporta com relação a produtos específicos, leia a documentação do produto em questão:
- Conversões do Google Ads e remarketing
- Campaign Manager e Display & Video 360
- Search Ads 360
- Google Analytics
O exemplo mais básico consiste apenas no comando config
e em um target_id
:
gtag('config', 'GA_MEASUREMENT_ID');
Você pode ajustar e estender um comando config
especificando parâmetros no objeto <additional_config_info>
opcional. Por exemplo, adicionar o parâmetro a seguir impedirá o envio automático de uma visualização de página do Google Analytics:
gtag('config', 'GA_MEASUREMENT_ID', {'send_page_view': false});
Enviar dados com event
O comando event
é usado para enviar dados do evento. Por exemplo, é possível utilizar o comando event
para enviar um evento login
com um valor method
de "Google":
gtag('event', 'login', {
'method': 'Google'
});
Existe um conjunto de eventos recomendados, além de sugestões de parâmetros, que são úteis em contextos específicos. Também é possível enviar eventos personalizados que não estão incluídos na lista de eventos recomendados.
Enviar dados em todos os eventos com set
O comando set
permite definir parâmetros que serão associados a cada evento subsequente na página. Por exemplo, se todas as transações no seu site forem feitas na mesma moeda, você poderá usar o set
para especificar o campo currency
:
gtag('set', {'currency': 'USD'});
É possível definir vários atributos com um único comando set
:
gtag('set', {
'country': 'US',
'currency': 'USD'
});