Rotear dados

Depois de instalar a gtag.js, é possível configurá-la para enviar (ou rotear) dados para grupos de contas ou produtos. Você pode configurar as soluções completas de avaliação do Google Ads e do Google Marketing Platform na mesma tag. Neste guia, explicamos como usar a gtag.js para enviar dados a contas, configurações e produtos específicos usando o parâmetro send_to e os groups.

Roteamento padrão

Cada snippet global tem um comando config para processar o roteamento. Por exemplo, para enviar dados a uma conta específica do Google Analytics, use o respectivo snippet global, que configura gtag.js:

gtag('config', 'GA_MEASUREMENT_ID-1');

É possível modificar o roteamento especificado no snippet global (ou qualquer instrução desse tipo na página) adicionando o parâmetro send_to aos comandos de evento. Por exemplo, o evento sign_in a seguir é enviado apenas para a propriedade "GA_MEASUREMENT_ID-2" do Google Analytics, independentemente dos destinos que foram configurados anteriormente na página.

gtag('event', 'sign_in', { 'send_to': 'GA_MEASUREMENT_ID-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', 'GA_MEASUREMENT_ID-1', { 'groups': 'group1' });
gtag('config', 'GA_MEASUREMENT_ID-2', { 'groups': 'group1' });

// Routes to 'GA_MEASUREMENT_ID-1' and 'GA_MEASUREMENT_ID-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', 'GA_MEASUREMENT_ID-1');
gtag('config', 'GA_MEASUREMENT_ID-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', 'GA_MEASUREMENT_ID-1');

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

// By default, routes to the 'default' groups which includes
// 'GA_MEASUREMENT_ID-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 códigos. Veja na amostra de código a seguir como enviar dados do evento sign_in para um grupo personalizado chamado agency.

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

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

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

Você pode criar configurações completas para o Google Ads, o Google Analytics e o Floodlight na mesma tag global do site. A seguir, vemos um exemplo de tag combinada que fará o seguinte:

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

  // Global configs
  gtag('config', 'GA_MEASUREMENT_ID-1');
  gtag('config', 'AW-CONVERSION_ID');
  gtag('config', 'DC-FLOODLIGHT_ID');

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

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

  // route ecommerce add_to_cart event to Google Ads and Analytics
  gtag('event', 'add_to_cart', {
    'send_to': [
      'GA_MEASUREMENT_ID-1',
      'AW-CONVERSION_ID'
    ],
    '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>