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

Agrupar e rotear dados

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

As instalações da tag do Google (gtag.js) podem ser configuradas para rotear dados a grupos específicos de contas ou produtos. Você pode configurar as soluções de métricas completas dos produtos de medição do Google no mesmo bloco de código. Neste guia, explicamos como configurar a tag do Google para enviar dados a contas, configurações e produtos específicos usando os parâmetros send_to e groups.

Roteamento padrão

A tag do Google contém um comando config para processar o roteamento. Por exemplo, quando você instala a tag do Google com um ID de tag, o snippet a seguir envia dados para suas contas do Google Analytics 4, do Google Ads ou ambas:

gtag('config', 'TAG_ID');

É possível substituir o roteamento especificado na tag do Google (ou qualquer instrução desse tipo na página) adicionando o parâmetro send_to aos comandos event.

Por exemplo, o evento sign_in a seguir é enviado apenas para uma propriedade do Google Analytics com o ID de destino 'G-XXXXXX-2', independentemente dos destinos configurados antes na página.

gtag('event', 'sign_in', { 'send_to': 'G-XXXXXX-2' });

Grupos

Às vezes, pode ser necessário enviar determinadas informações para um conjunto de contas ou produtos, e outras informações para outro conjunto. Por exemplo, você pode enviar informações sobre campanhas de marketing específicas para sua agência de publicidade e, ao mesmo tempo, reter dados mais detalhados na sua organização. Para fazer isso, use groups.

Crie um grupo de destinos (por exemplo, produtos, contas e propriedades) e, em seguida, faça o roteamento dos eventos para esse grupo. No exemplo a seguir, duas propriedades do Google Analytics são adicionadas a um grupo chamado group1. Depois, um evento sign_in é enviado a elas.

gtag('config', 'G-XXXXXX-1', { 'groups': 'group1' });
gtag('config', 'G-XXXXXX-2', { 'groups': 'group1' });

// Routes to 'G-XXXXXX-1' and 'G-XXXXXX-2'
gtag('event', 'sign_in', { 'send_to': 'group1' });

Grupo padrão

Se um parâmetro send_to não for definido, os eventos serão roteados para o grupo de destino default. O grupo default inclui todos os produtos e contas dos comandos config presentes na página e executados antes do evento. Mesmo que o parâmetro groups não seja especificado em um comando config, o destino será atribuído ao grupo default.

// The following two lines are equivalent:
gtag('config', 'G-XXXXXX-1');
gtag('config', 'G-XXXXXX-1', { 'groups': 'default' });

O próximo exemplo mostra que os eventos serão enviados para o grupo default, independentemente de {'send_to : 'default'} ter sido especificado.

// Configure a target
gtag('config', 'G-XXXXXX-1');

// Since send_to is not specified, this routes to the 'default' group which
// includes 'G-XXXXXX-1', as defined in config, above.
gtag('event', 'sign_in');

// By default, routes to the 'default' groups which includes
// 'G-XXXXXX-1', as defined in config, above.
gtag('event', 'generate_lead', { 'send_to': 'default' });

Rotear para groups personalizados

Ao usar groups, você pode identificar dados que precisam ser roteados para um conjunto específico de IDs. Veja no exemplo de código a seguir como rotear dados de eventos sign_in para um grupo personalizado chamado agency.

// Configure a target
gtag('config', 'G-XXXXXX-1');
gtag('config', 'G-XXXXXX-3', { 'groups': 'agency' });
gtag('config', 'G-XXXXXX-9', { 'groups': 'agency' });

// Routes only to 'G-XXXXXX-3' and 'G-XXXXXX-9' since they
// are both in the 'agency' group
gtag('event', 'sign_in', { 'send_to': 'agency' });

Exemplo: configurar o Google Ads, o Analytics e o Floodlight juntos

Você pode criar configurações completas para o Google Ads, o Analytics e o Floodlight na mesma tag do Google. Neste exemplo, mostramos a aparência de uma tag combinada. Exemplo:

  • Envia dados de visualizações de página para o Google Analytics.
  • Mede as conversões do Google Ads e do Floodlight.
  • Envia informações sobre um item adicionado a um carrinho de compras para o Analytics e o Google Ads.
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID">
</script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  // Global configs
  gtag('config', 'TAG_ID');
  gtag('config', 'DC-ZZZZZZ');

  // Measure Google Ads conversions
  gtag('event', 'conversion', {
      'send_to': 'AW-YYYYYY/AbC-D_efG-h12_34-567',
      'value': 1.0,
      'currency': 'USD'
  });

  // Measure Floodlight conversions
  gtag('event', 'conversion', {
    'allow_custom_scripts': true,
    'send_to': 'DC-ZZZZZZ/actions/locat304+standard'
  });

  // Route ecommerce add_to_cart event to Google Ads and Analytics
  gtag('event', 'add_to_cart', {
    'send_to': [
      'G-XXXXXX-1',
      'AW-YYYYYY'
    ],
    'items': [
      'id': 'U1234',
      'ecomm_prodid': 'U1234',
      'name': 'Argyle Funky Winklepickers',
      'list': 'Search Results',
      'category': 'Footwear',
      'quantity': 1,
      'ecomm_totalvalue': 123.45,
      'price': 123.45
    ]
  });
</script>