El evento “Notificar evento de compra realizada” sirve para describir una compra realizada por el cliente. Para ello notifica, vía JavaScript, cuando un usuario realiza una compra mediante el uso del connectif.managed.sendEvents.
Este artículo forma parte de la guía para crear una integración a medida.
Si tu integración es mediante módulo, esta notificación será insertada en tu eCommerce de forma automática.
Cómo se usa
La notificación de información del carrito utiliza la opción entityInfo, del método sendEvents, para enriquecer la información de los eventos enviados.
Este evento representa una alternativa al implementar la Etiqueta de "Compra realizada" en el HTML de la página de tu tienda o web.
Notificar la compra realizada
Este objeto representa el modelo del Carrito de compra que incluye las siguientes propiedades:
| Nombre | Obligatoria | Tipo | Descripción |
|---|---|---|---|
| purchaseId | Sí | string | Identificador único de la compra. |
| cartId | No | string | Identificador único del carrito a partir del cual se originó esta compra. |
| totalQuantity | Sí | number | 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, totalQuantity será igual a 10. |
| totalPrice | Sí | number | Importe total de la compra. |
| purchaseDate | No | string | Fecha de la compra. Se espera formato ISO_8601. |
| paymentMethod | No | string | El metodo de pago |
| products | Sí | Product Basket Item | Artículos que contiene la compra, junto con la cantidad de los mismos y el importe. |
| source_name | No | string | El nombre de la fuente, para aportar contexto o detalle sobre el tipo de fuente de la compra. |
| source_type | No | string |
El nombre de la fuente donde se realizó la compra. Los valores posibles son: "marketplace", "digital-store", "point-of-sale", "third-party" y "other". |
Aunque opcional, el campo cartId es altamente recomendado para poder marcar el carrito como comprado y evitar eventos incorrectos de Carrito Abandonado.
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... |
| point-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
La notificación tendrá este aspecto:
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 el registro de la compra vendrá notificado con el evento de página visitada. Esta suele representar la visita a la página de confirmación del pedido o compra.
¡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:
- Añadir el JavaScript de Connectif en tu web, para insertar el código y comenzar a recopilar información sobre las visitas a tu página.
- Integración mediante etiquetas, para conocer todas las notificaciones que puedes enviar desde tu eCommerce a Connectif y su funcionamiento.
- 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.