Ligar a Novaco ao Google Analytics

    Reencaminhe os eventos do seu assistente virtual para o Google Tag Manager ou o Google Analytics 4 e crie relatórios sobre conversas, leads e marcações.

    Dois métodos

    Existem duas formas de ligar os dados da Novaco ao Google Analytics. Escolha uma — nunca execute as duas em paralelo.

    1. Google Tag Manager

    Recomendado se já utilizar o GTM. Envie eventos para a camada de dados e distribua-os para qualquer tag.

    2. Google Analytics 4

    Utilize a Google tag (gtag.js) diretamente no seu website para enviar eventos diretamente para o GA4.

    Que eventos estão disponíveis? Consulte a referência de eventos do Google Analytics.

    Ligar com o Google Tag Manager

    O GTM distribui eventos a terceiros através de tags. Para isso, fornece os dados na chamada "camada de dados" (data layer). Adicione um listener para cada evento que pretenda utilizar.

    Exemplo: um evento

    <script>
window.addEventListener('autochat_lead_created', function (e) {
  try {
    dataLayer.push({
      "event": e.type,
      "autochat_event_details": e.detail.eventData
    });
  } catch(e) {
    // Your error handling if relevant
  }
});
</script>

    Exemplo: vários eventos

    <script>
window.addEventListener('autochat_lead_created', function (e) {
  try {
    dataLayer.push({
      "event": e.type,
      "autochat_event_details": e.detail.eventData
    });
  } catch(e) {
    // Your error handling if relevant
  }
});
window.addEventListener('autochat_chat_first_user_interaction', function (e) {
  try {
    dataLayer.push({
      "event": e.type,
      "autochat_event_details": e.detail.eventData
    });
  } catch(e) {
    // Your error handling if relevant
  }
});
</script>

    O try-catch é tratamento de erros opcional — pode deixá-lo como está.

    Criar as variáveis da camada de dados

    Além dos eventos, a Novaco disponibiliza dados de evento adicionais como session_id, chat_type e appointment_type. Crie uma variável para cada um.

    1. Aceda ao seu contentor do GTM.
    2. Vá a Variáveis e clique em "Nova" em "Variáveis Definidas pelo Utilizador".
    3. Escolha "Variável da Camada de Dados" como o tipo de variável.
    4. Dê-lhe um nome claro, por exemplo "Novaco – session_id".
    5. Como nome da variável da camada de dados, indique o nome da variável Novaco.
    6. Clique em Guardar.

    Associar os eventos a acionadores e tags

    Crie um acionador para cada evento sobre o qual pretenda atuar e, em seguida, combine acionadores e variáveis numa tag do GA4.

    Criar um acionador

    1. Aceda ao seu contentor do GTM.
    2. Vá a Acionadores e clique em "Novo".
    3. Escolha o tipo de acionador "Evento personalizado".
    4. Dê-lhe um nome claro, por exemplo "Novaco – Lead criado".
    5. Utilize o nome do evento Novaco como nome do evento.
    6. Clique em Guardar.

    Criar a tag do GA4

    1. Vá a Tags e clique em "Nova".
    2. Escolha o tipo de tag "Google Analytics: Evento GA4".
    3. Dê-lhe um nome claro, por exemplo "GA4 – Eventos Novaco".
    4. Preencha o seu ID de medição ou associe-o à configuração da sua Google tag.
    5. Preencha {{Event}} como nome do evento.
    6. Em "Parâmetros de evento", adicione as variáveis Novaco como parâmetros.
    7. Clique em Guardar.

    Qualquer acionador de evento Novaco que adicionar agora envia automaticamente os seus dados para o GA4. Os mesmos blocos de construção podem ser utilizados para outras tags, como uma conversão de lead do Google Ads.

    Ligar diretamente ao Google Analytics 4

    Não tem gestor de tags? Utilize a implementação da Google tag (gtag.js). Nunca execute esta configuração em paralelo com o Google Tag Manager — se utilizar o GTM, siga antes o guia acima.

    1. Configurar a sua Google tag

    <script async src="https://www.googletagmanager.com/gtag/js?id=G-12345678"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'G-12345678');
</script>

    Substitua G-12345678 pelo seu próprio ID de medição.

    2. Adicionar o registo de eventos Novaco

    Adicione este trecho de código depois da sua chamada gtag('config', ...).

    <script>
window.addEventListener('autochat_lead_created', function (e) {
  try {
    gtag('event', e.type, {
      'session_id': e.detail.eventData.session_id,
      'appointment_type': e.detail.eventData.appointment_type
    });
  } catch(e) {
    // Your error handling if relevant
  }
});
window.addEventListener('autochat_chat_first_user_interaction', function (e) {
  try {
    gtag('event', e.type, {
      'session_id': e.detail.eventData.session_id,
      'chat_type': e.detail.eventData.chat_type
    });
  } catch(e) {
    // Your error handling if relevant
  }
});
</script>

    e.type resolve-se automaticamente para o nome do evento, por exemplo autochat_lead_created. Esse é também o nome do evento que verá no GA4. Tudo o que vem a seguir são os parâmetros do evento.

    Dimensões personalizadas do GA4

    Para criar relatórios sobre os parâmetros de evento, registe-os como dimensões personalizadas no GA4.

    1. Aceda à administração da sua propriedade GA4.
    2. Vá a "Definições personalizadas".
    3. Vá a "Dimensões personalizadas" e clique em "Criar dimensão personalizada".
    4. Utilize um nome de dimensão descritivo, por exemplo "Novaco chat open type".
    5. Defina o âmbito como "Evento".
    6. Como parâmetro de evento, utilize o nome da variável que utilizou na tag do GA4, por exemplo chat_open_type.

    analyticsSetup.dimensions.note

    Procura a lista de eventos?

    Cada evento, quando é disparado e que dados transporta.

    Ver a referência de eventos