A etiqueta "Compra realizada" é um fragmento de código HTML que descreve uma compra realizada.
Este artigo faz parte dos passos para criar uma integração personalizada.
Se sua integração for por módulo, esta etiqueta será inserida automaticamente em seu eCommerce.
O que é e onde usar esta etiqueta?
A etiqueta “cn_purchase" deve ser inserida na primeira página visitada após uma compra. Normalmente, esta página será a de confirmação da compra.
Propriedades
As diferentes propriedades de uma compra devem ser definidas dentro da etiqueta “cn_purchase" como etiquetas filhas, indicando o nome da propriedade no atributo “class" .
Cada produto diferente que estiver no carrinho é indicado por uma etiqueta com a classe "product_basket_item", que inclui a quantidade dos mesmos e seu valor.
Se você quiser saber mais sobre o objeto "Product Basket Item", confira este artigo.
As propriedades a serem incluídas na etiqueta são:
| Nome | Obrigatória | Tipo | Múltiplas | Descrição |
|---|---|---|---|---|
| total_quantity | Sim | inteiro | Não | Quantidade total de produtos na compra (incluindo duplicatas). Por exemplo: se um carrinho tiver 3 unidades de um produto e 7 unidades de outro diferente, total_quantity será igual a 10. |
| total_price | Sim | decimal | Não | Valor total da compra. |
| purchase_date | Não | string | Não |
Data e hora da compra. O formato esperado é ISO_8601, por exemplo: 2024-09-13T10:49:31Z. |
| product_basket_item | Não | Product Basket Item | Sim | Itens contidos na compra, junto com a quantidade dos mesmos e o valor. |
| 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 esta compra foi originada. |
Embora opcional, é recomendado o uso do campo "cart_id" para alterar o estado do carrinho para comprado e evitar eventos de Carrinho Abandonado incorretos.
Exemplo
Depois de incluir as propriedades, a etiqueta terá este aspecto:
<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>
<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 Gaming Logitech Pro v.1.5</span>
<span class="description">Teclado sem fio retroiluminado de alta qualidade, 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">Em Estoque</span>
<span class="category">/Computadores/Teclados/Logitech</span>
<span class="category">/Computadores/Gaming</span>
<span class="tag">Azul</span>
<span class="tag">Gaming</span>
<span class="tag">Retroiluminado</span>
<span class="tag">Sem fio</span>
<span class="brand">Logitech</span>
<span class="review_count"> 245</span>
<span class="review_rating">4.9</span>
<span class="custom"></span>
</div>
<div class="product_basket_item">
<span class="quantity">1</span>
<span class="price">79.50</span>
<span class="url">http://example.org/products/pr7385</span>
<span class="product_id">pr7385</span>
<span class="name">Mouse sem Fio Microsoft Wireless</span>
<span class="description">Mouse ergonômico e preciso, com bateria de longa duração.</span>
<span class="image_url">http://example.org/img/products/pr7385.jpg</span>
<span class="unit_price">79.50</span>
<span class="availability">Em Estoque</span>
<span class="category">/Computadores/Mouses/Microsoft</span>
<span class="tag">Sem fio</span>
<span class="brand">Microsoft</span>
<span class="review_count">312</span>
<span class="review_rating">4.7</span>
<span class="custom"></span>
</div>
</div>
Parabéns!
Você chegou ao final da lição.
Ficaram dúvidas sem resposta?
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 continuar com os seguintes artigos:
- 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 por eventos JavaScript, para conhecer esta forma de integração que permitirá um maior controle sobre quando e como enviar os eventos.
- 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 estão sendo sincronizados corretamente em sua conta do Connectif.