Configurar produtos e enviar dados

É 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:

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'
});