1. Centro de Ajuda
  2. Integre sua Loja
  3. Integração Personalizada
  4. Através de eventos JavaScript
  5. Notifica o envio de eventos JavaScript

Evento "Notificar evento de compra realizada"

Criado
Atualizado
Seguir

O evento “Notificar evento de compra realizada” serve para descrever uma compra feita pelo cliente. Ele notifica, via JavaScript, quando um usuário realiza uma compra através do uso de connectif.managed.sendEvents.

  

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

 

Como usar

A notificação de informações do carrinho utiliza a opção entityInfo do método sendEvents, para enriquecer os dados dos eventos enviados.

  

Este evento representa uma alternativa à implementação da Tag “Compra realizada” no HTML da página da sua loja ou site.

 

Notificar a compra realizada

Este objeto representa o modelo do Carrinho de compra que inclui as seguintes propriedades:

Nome Obrigatória Tipo Descrição
purchaseId Sim string Identificador único da compra.
cartId Não string Identificador único do carrinho a partir do qual esta compra se originou.
totalQuantity Sim number Quantidade total de produtos na compra (incluindo duplicados).
Por exemplo: se um carrinho tem 3 unidades de um produto e 7 de outro, totalQuantity será 10.
totalPrice Sim number Valor total da compra.
purchaseDate Não string Data da compra. Espera‑se o formato ISO_8601.
paymentMethod Não string Método de pagamento.
products Sim Product Basket Item Itens contidos na compra, junto com sua quantidade e valor.
source_name Não string O nome da fonte, para fornecer contexto ou detalhe sobre o tipo de origem da compra.
source_type Não string

O nome da fonte onde a compra foi realizada. Os valores possíveis são: "marketplace", "digital-store", "point-of-sale", "third-party" e "other".
 

Embora opcional, o campo cartId é altamente recomendado para poder marcar o carrinho como comprado e evitar eventos incorretos de Carrinho Abandonado.

 

Organização dos valores da fonte (source_type)

A seguir são explicados cada um dos valores possíveis da fonte da compra (source_type):

Valor Descrição Exemplo
third-party Vendas canalizadas através de distribuidores, varejistas ou redes de parceiros (não marketplaces).

Atacado, Distribuidores, Afiliados...
other Casos especiais ou canais que não se encaixam nas categorias acima.

Tele‑vendas, Feiras e eventos, Comércio social...
marketplace Plataformas de eCommerce de terceiros onde você lista seus produtos.

Amazon Marketplace, eBay, Zalando...
digital-store Vendas do próprio site ou app de eCommerce do varejista.

Direto, Busca Orgânica, Busca Paga, Email Marketing...
point-of-sale Vendas em lojas físicas processadas por meio de um sistema POS.

Checkout na loja, Quiosque na loja, Lojas pop‑up...

 

Exemplo

A notificação terá esta aparência:

connectif.managed.sendEvents([
    {
        "type": "purchase",
        "purchase": {
            "cartId": "cart-0098caf9-42f4-44e9-afdd-45eafe892293",
            "totalQuantity": 1,
            "totalPrice": 51.88,
            "products": [{
                "name": "My Product",
                "productDetailUrl": "https://myshop.com/product/details/59a31949a1a562d4979fbca2",
                "productId": "59a31949a1a562d4979fbca2",
                "unitPrice": 51.88,
                "availability": "outofstock",
                "imageUrl": "https://myshop.com/img/59a31949a1a562d4979fbca2.jpg",
                "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
                "priority": 10,
                "rating": 4,
                "tags": ["tag1", "tag2", "tag3"],
                "relatedExternalProductIds": ["59a31953a1a562d4979fbd90", "59a31b2ba1a562d4979fe5b8"],
                "brand": "Jata",
                "publishedAt": "2020-05-03T10:15:00Z",
                "quantity": 1,
                "price": 51.88
            }],
            "purchaseId": "purchase-e3418b5a-8709-4593-a7c8-d8a7f12df737",
            "purchaseDate": "2020-06-26T12:52:51.591Z",
            "paymentMethod": "Credit Card" 
            "source_type": "digital-store"
            "source_name": "My online store"
        }
    },
    {
        "type": "page-visit"
    }], { entityInfo });
  

Normalmente, o registro da compra será notificado junto com o evento de visita de página. Isso geralmente representa a visita à página de confirmação de pedido ou compra.

 

 

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

  

Ficou com dúvidas?
Lembre-se de que você pode contar com nossos especialistas da Connectif. Para contatá‑los, basta abrir um ticket de suporte clicando no botão azul “Ajuda” no seu painel.

Continue aprendendo!

Para aproveitar todo o potencial da sua conta Connectif, recomendamos continuar com os seguintes artigos: