Agradecemos seu interesse na nova documentação da plataforma de tags do Google. Este site está na versão Beta pública. (Feedback)

Configurar produtos e enviar dados

É possível invocar comandos gtag() em qualquer local da sua página após o snippet global. Três comandos estão disponíveis na gtag(): config e set são usados para estabelecer propriedades gerais, e event é usado para enviar dados.

Inicializar produtos com config

Use o comando config para inicializar e ajustar as configurações de uma conta do produto específica. Esse comando tem o seguinte formato:

gtag('config', '<TARGET_ID>', {<additional_config_info>});

Em que <TARGET_ID> é o ID da conta do produto para onde 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', 'G-XXXXXX');

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', 'G-XXXXXX', {'send_page_view': false});

Enviar dados com event

Com o comando event, você pode enviar dados de evento. Por exemplo, é possível usar 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 e 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

Com o comando set, é possível definir parâmetros que serão associados a cada evento seguinte na página. Por exemplo, se todas as transações no seu site forem feitas na mesma moeda, você poderá usar o comando 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'
});