Evento "Notificar informações do carrinho"

O evento “Notificar informação do carrinho” serve para descrever o carrinho de compras que o contato possui em um dado momento. Para isso, notifica via JavaScript os produtos e o estado do carrinho de um contato por meio do uso de connectif.managed.sendEvents.

  

Este artigo faz parte da guia para criar uma integração personalizada.
Se sua integração for via módulo, esta notificação será inserida automaticamente no seu eCommerce.

 

Como usar

A notificação de informação do carrinho utiliza a opção entityInfo do método sendEvents para enriquecer a informação dos eventos enviados. Esta notificação descreve o carrinho completo; a Connectif se encarrega de detectar mudanças e gerar os eventos adequados quando um produto é adicionado ou removido do carrinho.

  

Esta notificação via JavaScript representa uma alternativa a implementar a Etiqueta “Estado atual do carrinho de compras” no HTML da sua loja ou página da web.

Notificar o carrinho de compras

Este objeto representa um carrinho de compras completo em um determinado instante. Inclui as seguintes propriedades:

Nombre Obligatoria Tipo Descripción
cartId Sim string Identificador único do carrinho.
totalQuantity Sim number Quantidade total de produtos que há no carrinho.
CartRecoveryUrl Não Cart recovery url Url associada ao carrinho e por meio da qual se pode acessar para recuperar/comprar todos os produtos relacionados.
totalPrice Sim number Preço total do carrinho.
products Sim Product Basket Item Itens que o carrinho contém, junto com sua quantidade e valor.

Notificar os produtos via Product Basket Item

Este objeto representa os produtos, suas quantidades e seu preço total em uma compra ou carrinho de compras.

Inclui todas as propriedades do tipo de objeto Produto (mais informações em Notify product visited event), além das seguintes:

Nombre Obligatoria Tipo Descripción
quantity Sim number Quantidade de unidades deste produto.
price Sim number Preço acumulado dos produtos representados por este Product Basket Item. Normalmente é quantity * unitPrice.

 

Outras considerações

É muito importante definir um identificador do carrinho (“cartId”) e notificar a Connectif também quando o carrinho for esvaziado, para evitar que eventos de carrinho abandonado sejam gerados.

 

Exemplo

A notificação terá este formato:

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: 'My product',
        description: 'product description',
        imageUrl: 'https://mywebsite.com/images/myproduct',
        unitPrice: 10.2,
        availability: 'InStock',
        categories: ['/Home'],
        tags: ['tag1','tag2'],
        brand: 'Brand',
        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([ // here my events if any ], { entityInfo, cart });

 

 

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

  

Ficou alguma dúvida sem resolver?
Lembre‑se que você tem à sua disposição nossos especialistas da Connectif. Para contatá‑los, basta abrir um ticket para o Suporte clicando no botão azul “Ajuda” do seu dashboard.


Continue aprendendo!

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