O evento "Notificar informações do carrinho" serve para descrever o carrinho de compras que o contato possui em um determinado momento. Para isso, ele notifica via JavaScript os produtos e o estado do carrinho de um contato usando o connectif.managed.sendEvents.
Este artigo faz parte do guia para criar uma integração personalizada. Se sua integração for por meio de módulo, esta notificação será inserida em sua eCommerce automaticamente.
Como usar
A notificação de informações do carrinho utiliza a opção entityInfo do método sendEvents para enriquecer as informações dos eventos enviados. Esta notificação descreve o carrinho completo; o Connectif detecta as mudanças e gera os eventos apropriados quando um produto é adicionado ou removido do carrinho.
Esta notificação via JavaScript é uma alternativa à implementação da Etiqueta "Estado atual do carrinho de compras" no HTML da página da sua loja ou website.
Notificar o carrinho de compras
Este objeto representa um carrinho de compras completo em um determinado momento. Inclui as seguintes propriedades:
| Nome | Obrigatória | Tipo | Descrição |
|---|---|---|---|
| cartId | Sim | string | Identificador único do carrinho. |
| totalQuantity | Sim | number | Quantidade total de produtos no carrinho. |
| totalPrice | Sim | number | Preço total do carrinho. |
| products | Sim | Item de Cesta de Produtos | Produtos contidos no carrinho, juntamente com a quantidade e o valor. |
Notificar os produtos através do Item de Cesta de Produtos
Este objeto representa os produtos, a quantidade deles e o preço total que estão em um carrinho de compras ou em uma compra.
Inclui todas as propriedades do tipo de objeto Produto (mais informações em Notificar evento de produto visitado), além das seguintes:
| Nome | Obrigatória | Tipo | Descrição |
|---|---|---|---|
| quantity | Sim | number | Quantidade de unidades deste produto. |
| price | Sim | number | Preço acumulado dos produtos representados por este Item de Cesta de Produtos. Normalmente é quantidade * preço unitário. |
Outras considerações
É muito importante estabelecer um identificador de carrinho ("cartId") e notificar também o Connectif quando o carrinho for esvaziado, para evitar que eventos de carrinhos abandonados sejam gerados.
Exemplo
Segue abaixo a aparência da notificação:
const cart = {
cartId: '123456789',
totalQuantity: 1,
totalPrice: 10.2,
products: [{
quantity: 1,
price: 10.2,
productDetailUrl: 'https://mywebsite.com/myproduct-detail-url',
productId: '12345678910',
name: 'Meu produto',
description: 'descrição do produto',
imageUrl: 'https://mywebsite.com/images/myproduct',
unitPrice: 10.2,
availability: 'Em estoque',
categories: ['/Início'],
tags: ['tag1','tag2'],
brand: 'Marca',
reviewCount: 1,
rating: 2,
ratingCount: 2,
thumbnailUrl: 'https://mywebsite.com/images/thumb/myproduct',
priority: 20,
unitPriceOriginal: 10.2,
unitPriceWithoutVAT: 8,
discountedAmount: 0,
discountedPercentage: 0,
publishedAt: '2020-05-20T15:24:20Z',
customField1: '',
customField2: '',
customField2: ''
}]
};
connectif.managed.sendEvents([
// aqui vão meus eventos, se houver
], { entityInfo, cart });
Parabéns!
Você chegou ao final da lição.
Restaram dúvidas?
Lembre-se de que você tem à sua disposição nossos especialistas em Connectif. Para entrar em contato com eles, basta abrir um chamado de suporte clicando no botão azul "Ajuda" no seu painel.
¡Continue aprendendo!
Para aproveitar todo o potencial de sua conta no Connectif, recomendamos que você continue com os seguintes artigos:
- Adicionar o JavaScript do Connectif em seu site, para inserir o código e começar a coletar informações sobre as visitas à sua página.
- Integração via etiquetas, para conhecer todas as notificações que você pode enviar do seu comércio eletrônico 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 comércio eletrônico, para garantir que todos os dados estejam sendo sincronizados corretamente em sua conta Connectif.