La etiqueta “Compra realizada" es un fragmento de código HTML que sirve para describir una compra realizada.
Este artículo forma parte de los pasos para crear una integración a medida.
Si tu integración es mediante módulo, esta etiqueta será insertada en tu eCommerce de forma automática.
¿Cuál es y dónde usar esta etiqueta?
La etiqueta “cn_purchase" debe insertarse en la primera página que se visite después de una compra. Habitualmente, esta página será la de confirmación de compra.
Propiedades
Las diferentes propiedades de una compra se deben definir en el interior de la etiqueta “cn_purchase" como etiquetas hijas, indicando el nombre de la propiedad en el atributo “class" .
Cada producto diferente que haya en el carrito se indica mediante una etiqueta con la clase "product_basket_item", que incluye la cantidad de los mismos y su importe.
Si quieres saber más sobre el objeto "Product Basket Item" revisa este artículo.
Las propiedades a incluir en la etiqueta son:
| Nombre | Obligatoria | Tipo | Múltiples | Descripción |
|---|---|---|---|---|
| total_quantity | Sí | integer | No | Cantidad total de productos que hay en la compra (incluyendo los duplicados). Por ejemplo: si un carrito tiene 3 unidades de un producto y 7 unidades de otro diferente, total_quantity será igual a 10. |
| total_price | Sí | decimal | No | Importe total de la compra. |
| payment_method | No | string | No | Método de pago utilizado en la compra. |
| purchase_date | No | string | No | Fecha y hora de la compra. Se espera formato ISO_8601, ejemplo 2024-09-13T10:49:31Z. |
| product_basket_item | No | Product Basket Item | Sí | Artículos que contiene la compra, junto con la cantidad de los mismos y el importe. |
| source_name | No | string | No | El nombre de la fuente, para aportar contexto o detalle sobre el tipo de fuente de la compra. |
| source_type | No | string | No | El nombre de la fuente donde se realizó la compra. Los valores posibles son: "marketplace", "digital-store", "point-of-sale", "third-party" y "other". |
| purchase_id | Sí | string | No | Identificador único de la compra. |
| cart_id | No | string | No | Identificador único del carrito a partir del cuál se originó esta compra. |
Aunque opcional, se recomienda el uso del campo "cart_id" para cambiar el estado del carrito a comprado y evitar eventos de Carrito Abandonado incorrectos.
Organización de los valores de la fuente (source_type)
A continuación, se explican cada uno de los valores posibles de la fuente de la compra (source_type):
| Valor | Descripción | Ejemplo |
|---|---|---|
| third-party | Ventas canalizadas a través de distribuidores, minoristas o redes de socios (no marketplaces). | Venta al por mayor, Distribuidores, Afiliados... |
| other | Casos especiales o canales que no encajan en las categorías anteriores. | Televentas, Ferias y eventos, Comercio social... |
| marketplace | Plataformas de comercio electrónico de terceros donde publicas tus productos. | Amazon Marketplace, eBay, Zalando... |
| digital-store | Ventas desde el sitio web o app de comercio electrónico propio del minorista. | Directo, Búsqueda orgánica, Búsqueda de pago, Email Marketing... |
| pont-of-sale | Ventas en tiendas físicas procesadas a través de un sistema POS. | Caja en tienda, Kiosco en tienda, Tiendas pop-up... |
Ejemplo
Una vez incluidas las propiedades, la etiqueta tendrá 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">Credit card</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 Gaming Logitech Pro v.1.5</span>
<span class="description">Teclado inalámbrico retroiluminado de alta gama, personalizable y resistente a líquidos y caídas.</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">/Ordenadores/Teclados/Logitech</span>
<span class="category">/Ordenadores/Gaming</span>
<span class="tag">Azul</span>
<span class="tag">Gaming</span>
<span class="tag">Retroiluminado</span>
<span class="tag">Inalámbrico</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">Información personalizada de ejemplo</span>
</div>
</div>
¡Enhorabuena!
Has llegado al final de la lección.
¿Te han quedado dudas sin resolver?
Recuerda que tienes a tu disposición a nuestros especialistas en Connectif. Para contactar con ellos, tan solo tendrás que abrir ticket a Soporte haciendo clic en el botón azul de “Ayuda” de tu dashboard.
¡Sigue aprendiendo!
Para aprovechar todo el potencial de tu cuenta en Connectif, te recomendamos continuar con los siguientes artículos:
Integración mediante etiquetas, para conocer todas las notificaciones que puedes enviar desde tu eCommerce a Connectif y su funcionamiento.
Integración mediante eventos JavaScript, para conocer esta forma de integración que te permitirá un mayor control sobre cuándo y cómo enviar los eventos.
Integración con Connectif vía API, para sincronizar contactos, productos, compras y cupones.
Comprobar la integración con el eCommerce, para asegurarte de que todos los datos están sincronizándose de forma correcta en tu cuenta de Connectif.