1. Centro de Ajuda
  2. Integre sua Loja
  3. Integração Personalizada
  4. Através de eventos JavaScript
  5. Adicionar e configurar o JavaScript do Connectif

Enviar à Connectif uma lista de eventos con connectif.managed.sendEvents

Criado
Atualizado
Seguir

A função "connectif.managed.sendEvents" serve para enviar para a Connectif uma lista de eventos, junto com outras informações adicionais que possam estar presentes na página. Graças a essa função, é possível notificar por meio de JavaScript todos os tipos de eventos sem a necessidade de implementar as tags. 

É recomendável, sempre que possível, utilizar managed.sendEvents agrupando todos os eventos simultâneos em um único envio. Isso permite: 

  • Simplificar a integração realizando menos chamadas. 

  • Todos os eventos são registrados de forma realmente simultânea, evitando inconsistências no rastreamento. 

  • Reduzir, sob determinadas circunstâncias, o consumo de atividades da conta. 

  

Este artigo faz parte do guia para criar uma integração personalizada.
Se sua integração for por meio de um módulo, essa função será inserida automaticamente no seu eCommerce.

 

Como usar

A função "connectif.managed.sendEvents" envia automaticamente os seguintes dados:

  

Esta função pode receber, opcionalmente, um array de objetos do tipo "evento". Caso nenhum evento seja indicado, os dados da lista anterior serão enviados para a Connectif sem nenhum evento específico. Isso pode ser útil para ressincronizar o carrinho de compras ou o e-mail sem a necessidade de recarregar completamente a página.

Requisitos

É importante que essa função seja utilizada quando a Connectif já estiver inicializada. 

const isConnectifInitialized = window.connectif?.managed?.isInitialized();

Caso não esteja inicializado, será necessário aguardar o evento "connectif.managed.initialized".

A seguir, um exemplo de como enviar eventos garantindo que a Connectif esteja inicializada:

function trackPageVisit() {
    window.connectif.managed.sendEvents([{ type: 'page-visit' }]);
}

if (window.connectif && 
    window.connectif.managed &&
    window.connectif.managed.isInitialized()) {
    trackPageVisit();
} else {
    document.addEventListener("connectif.managed.initialized", function onConnectifInitialized() {
        trackPageVisit();
    },
    { once: true });
}

 

Enviar informações do objeto "options"

A função também pode receber, opcionalmente, um segundo objeto "options", que pode conter alguns dos seguintes campos:

Nome Obrigatório Tipo Descrição
options.onResponded Não function Callback que será chamado assim que os eventos forem enviados para a Connectif.
options.cart Não object Indica o objeto do tipo Carrinho de Compras que será enviado para a Connectif (em vez de pegar o carrinho da Tag de "Estado atual do carrinho de compras").
Saiba mais em Notificar informações do carrinho.
options.entityInfo Não object Indica o objeto com as informações do Contato que será enviado para a Connectif (em vez de pegá-lo da Tag de "Informações do contato").
Saiba mais em Notificar informações do contato.
options.pageInfo Não object Indica o objeto com as informações da página que enriquece o evento de página visitada (em vez de pegá-lo dos metadados da página e das tags de Tag de "Categoria da página" e Tag de "Tag da página").
Saiba mais em Notificar evento de página visitada.
  

Após receber a resposta da Connectif, a função será responsável por desencadear as ações que podem ter sido definidas pelos fluxos de Workflows, como exibir um conteúdo inline, um popup, etc.

 

Exemplos

A seguir, pode-se ver como usar essa função para rastrear diferentes eventos:

 

 

Parabéns!
Você chegou ao final da lição.

  

Ficou com alguma dúvida?
Lembre-se de que você tem à disposição nossos especialistas em Connectif. Para entrar em contato com eles, basta abrir um ticket para o Suporte clicando no botão azul “Ajuda” no seu dashboard.

Continue aprendendo!

Para aproveitar todo o potencial da sua conta na Connectif, recomendamos que você continue com os seguintes artigos: