A função "connectif.managed.sendEvents" serve para enviar à Connectif uma lista de eventos, juntamente com todas as informações adicionais que possam estar presentes na página. Graças a ela, é possível notificar através do JavaScript todo tipo de eventos sem a necessidade de implementar as etiquetas.
Este artigo faz parte do guia para criar uma integração personalizada.
Se sua integração for através de módulo, esta função será inserida em sua loja virtual de forma automática.
Como usar
A função "connectif.managed.sendEvents" envia automaticamente os seguintes dados:
- A informação do carrinho de compras (dados da Etiqueta de "Estado atual do carrinho de compras").
- A informação do contato atual (dados da Etiqueta de "Informação do contato").
- A informação da inscrição em notificações Web Push (mais informações em Funções Web Push).
- Os contêineres disponíveis para o posicionamento de banners (dados da Etiqueta de "Banner").
Esta função pode receber, opcionalmente, um array de objetos do tipo "evento". Se nenhum evento for indicado, os dados da lista anterior serão enviados à 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 a página inteira.
Requisitos
É importante que o uso desta função seja feito quando Connectif estiver inicializado.
const isConnectifInitialized = window.connectif?.managed?.isInitialized();
Caso contrário, será necessário aguardar o evento "connectif.managed.initialized".
Abaixo está um exemplo de como enviar eventos garantindo que Connectif esteja inicializado:
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 algum dos seguintes campos:
| Nome | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| options.onResponded | Não | function | Callback que será chamado uma vez que os eventos tenham sido enviados à Connectif. |
| options.cart | Não | object |
Indica o objeto do tipo Carrinho de Compras que será enviado à Connectif (em vez de pegar o carrinho de compras do Etiqueta de "Estado atual do carrinho de compras"). |
| options.entityInfo | Não | object |
Indica o objeto com as informações do Contato que serão enviadas à Connectif (em vez de pegá-lo da Etiqueta de "Informação do contato"). |
| options.pageInfo | Não | object |
Indica o objeto com as informações da página que enriquecem o evento de página visitada (em vez de pegá-lo dos metadados da página e das etiquetas de Etiqueta de "Categoria de página" e Etiqueta de "Etiqueta de página"). |
Após receber a resposta da Connectif, a função se encarregará de acionar as ações que podem ter sido determinadas pelos fluxos de Workflows, como mostrar um conteúdo inline, um popup, etc.
Exemplos
Abaixo você pode ver como usar esta função para rastrear diferentes eventos:
¡Parabéns!
Você chegou ao final da lição.
Ficaram dúvidas?
Lembre-se de que nossos especialistas do Connectif estão à sua disposição. Para entrar em contato com eles, basta abrir um ticket de suporte clicando no botão azul "Ajuda" no seu painel.
Continue aprendendo!
Para aproveitar todo o potencial de sua conta no Connectif, recomendamos continuar com os seguintes artigos:
- Adicionar o JavaScript do Connectif ao seu site, para inserir o código e começar a coletar informações sobre as visitas à sua página.
- Integração por meio de tags, para conhecer todas as notificações que você pode enviar do seu eCommerce para o Connectif e seu funcionamento.
- Integração com o Connectif via API, para sincronizar contatos, produtos, compras e cupons.
- Verificar a integração com o eCommerce, para garantir que todos os dados estejam sendo sincronizados corretamente em sua conta do Connectif.