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

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

É possível chamar comandos gtag() em qualquer lugar da sua página após o snippet da tag do Google. Os comandos a seguir estão disponíveis com estes comandos da gtag(): config e set definem propriedades gerais, e event envia dados para produtos do Google.

Inicializar produtos com config

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

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

<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 outras opções de configuração.

Com o comando config, é possível definir quais produtos e contas a gtag.js vai 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 comando config pede para a gtag.js gerar um hit de visualização de página.

Chame o comando config apenas uma vez por tag do Google. Todas as chamadas seguintes devem usar o comando set.

Para saber como o comando config se comporta em produtos específicos, leia a documentação relacionada:

O exemplo mais básico consiste apenas no comando config e em um TARGET_ID:

gtag('config', '<TARGET_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', 'TAG_ID', {'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, use 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'
});