A tag “Compra realizada" é um trecho de código HTML que serve para descrever uma compra realizada.
Este artigo faz parte dos passos para criar uma integração personalizada.
Se sua integração for via módulo, essa tag será inserida automaticamente no seu eCommerce.
Qual é e onde usar esta tag?
A tag “cn_purchase" deve ser inserida na primeira página acessada após uma compra. Normalmente, essa página será a de confirmação da compra.
Propriedades
As diferentes propriedades de uma compra devem ser definidas dentro da tag “cn_purchase" como tags filhas, indicando o nome da propriedade no atributo “class".
Cada produto diferente no carrinho é indicado por meio de uma tag com a classe "product_basket_item", que inclui a quantidade e o valor.
Se quiser saber mais sobre o objeto "Product Basket Item", confira este artigo.
As propriedades a serem incluídas na tag são:
| Nome | Obrigatória | Tipo | Múltiplos | Descrição |
|---|---|---|---|---|
| total_quantity | Sim | inteiro | Não | Quantidade total de produtos na compra (incluindo os duplicados). Por exemplo: se um carrinho tem 3 unidades de um produto e 7 unidades de outro, total_quantity será igual a 10. |
| total_price | Sim | decimal | Não | Valor total da compra. |
| payment_method | Não | string | Não | Método de pagamento utilizado na compra. |
| purchase_date | Não | string | Não | Data e hora da compra. Espera-se o formato ISO_8601, exemplo: 2024-09-13T10:49:31Z. |
| product_basket_item | Não | Product Basket Item | Sim | Itens incluídos na compra, juntamente com sua quantidade e valor. |
| source_name | Não | string | Não | Nome da origem, para fornecer contexto ou detalhes sobre o tipo de origem da compra. |
| source_type | Não | string | Nã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". |
| purchase_id | Sim | string | Não | Identificador único da compra. |
| cart_id | Não | string | Não | Identificador único do carrinho a partir do qual a compra foi originada. |
Embora opcional, recomenda-se o uso do campo "cart_id" para alterar o status do carrinho para comprado e evitar eventos de Carrinho Abandonado incorretos.
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
Uma vez incluídas as propriedades, a tag terá este formato:
<div class="cn_purchase " style="display:none">
<span class="cart_id">crt8679803</span>
<span class="purchase_id">prchs5241</span>
<span class="purchase_date">2017-09-29 14:12:37.430Z</span>
<span class="total_quantity">3</span>
<span class="total_price">180.75</span>
<span class="payment_method">Cartão de crédito</span>
<span class="source_type">digital-store</span>
<span class="source_name">My online store</span>
<div class="product_basket_item">
<span class="quantity">3</span>
<span class="price">180.75</span>
<span class="url">http://example.org/products/pr9658</span>
<span class="product_id">pr9658</span>
<span class="name">Teclado Gamer Logitech Pro v.1.5</span>
<span class="description">Teclado sem fio retroiluminado de alto padrão, personalizável e resistente a líquidos e quedas.</span>
<span class="image_url">http://example.org/img/products/pr9658.jpg</span>
<span class="unit_price">60.25</span>
<span class="availability">InStock</span>
<span class="category">/Computadores/Teclados/Logitech</span>
<span class="category">/Computadores/Gamer</span>
<span class="tag">Azul</span>
<span class="tag">Gamer</span>
<span class="tag">Retroiluminado</span>
<span class="tag">Sem fio</span>
<span class="brand">Logitech</span>
<span class="review_count">9</span>
<span class="rating_value">4.5</span>
<span class="thumbnail_url">http://example.org/img/thumbnails/products/pr9658.jpg</span>
<span class="related_external_product_id">pr10636</span>
<span class="related_external_product_id">pr11939</span>
<span class="related_external_product_id">pr12653</span>
<span class="published_at">2020-05-20T15:24:20Z</span>
<span class="custom_field_1">Informação personalizada de exemplo</span>
</div>
</div>
Parabéns!
Você chegou ao final da lição.
Ficou com dúvidas?
Lembre-se de que você pode contar com os nossos especialistas da Connectif. Para entrar em contato, basta abrir um chamado ao Suporte clicando no botão azul “Ajuda” no seu painel.
Continue aprendendo!
Para aproveitar todo o potencial da sua conta na Connectif, recomendamos continuar com os seguintes artigos:
Integração via tags, para conhecer todas as notificações que você pode enviar do seu eCommerce para a Connectif e como funcionam.
Integração via eventos JavaScript, para conhecer esse tipo de integração que permite maior controle sobre quando e como enviar os eventos.
Integração com a Connectif via API, para sincronizar contatos, produtos, compras e cupons.
Verificar a integração com o eCommerce, para garantir que todos os dados estão sendo sincronizados corretamente na sua conta da Connectif.