Los eventos de producto te permiten hacer un seguimiento de cómo interactúan tus contactos con tus productos: por ejemplo, cuando ven un artículo, lo añaden al carrito o completan una compra. Después, puedes utilizar estos datos en automatizaciones, segmentos y analíticas para entender mejor el comportamiento de tus clientes y personalizar la comunicación.
En este artículo te explicamos cómo enviar eventos de producto y qué reglas debes seguir para asegurarte de que los datos se almacenan correctamente.
Si quieres saber más sobre los eventos de producto, consulta el artículo «Qué es un evento de producto».
Existen 2 opciones para enviar eventos de producto a User.com:
SDK de JavaScript
API REST
En general, enviar eventos de producto es bastante similar a enviar eventos estándar. Sin embargo, hay algunos aspectos a los que debes prestar atención:
Utiliza la palabra clave product_event al enviar un evento de producto.
Incluye los atributos obligatorios: «product_id» y «event_type»
Enviar el nombre del producto es opcional. Si no lo incluyes y el producto no existe todavía, se creará el producto sin nombre.
La lista de tipos de evento es cerrada. No puedes añadir otros nuevos. Las opciones disponibles son:
click
promo click
view
detail
liking
add to observation
reservation
add
add to cart
remove
checkout
checkout option
order
purchase
return
refund
Puedes incluir atributos del producto, como el «nombre del producto», la «categoría» o cualquier otro atributo personalizado que necesites.
Antes de enviar eventos de producto, asegúrate de que los atributos de producto ya existen en tu workspace. Es importante mantener el mismo tipo de atributo.
User.com no almacena los valores históricos de los atributos de los eventos de producto (excepto event_type). Cada nuevo evento de producto actualiza los valores actuales del atributo en el perfil del producto. Esto significa que los valores anteriores se sobrescriben.
Como los atributos del producto siempre reflejan el último valor, no podrás hacer un seguimiento de las diferencias entre variantes dentro de un mismo producto. Si necesitas distinguir entre variaciones (como los mismos zapatos en diferentes tallas), crea un producto separado para cada variante y asigna a cada uno un product_id único.
Para mantener tus datos estructurados y fáciles de gestionar, se recomienda crear los atributos de producto antes de enviarlos al sistema. Esto te permite asignar el tipo de dato correcto con antelación (como integer, boolean, date, y más).
Si se envía un atributo sin haberlo predefinido, se creará automáticamente como string. Esto puede reducir la precisión del filtrado y limitar tus capacidades de segmentación e informes más adelante.
Para ver los tipos de atributo disponibles y elegir la mejor opción según tus necesidades, consulta el siguiente artículo.
Endpoints de la API REST para enviar un evento de producto:
A continuación tienes un ejemplo de cómo enviar un evento de producto usando la API REST:
curl -X POST
"https://<your_app_subdomain>.user.com/api/public/products-by-id/"
-H 'authorization: Token <your_64_char_api_key>'
-H 'content-type: application/json'
-d '{
"name": "my product",
"custom_id": "my_product_id",
"product_url": "https://myshop.com/products/my_product/",
"image_url": "https://myshop.com/media/products/myproduct.jpg"
}'Si envías un evento de producto sin proporcionar un nombre, el sistema comprobará primero si ya existe un producto con el «product_id» indicado.
Si no se encuentra ningún producto que coincida, se creará un nuevo producto con ese «product_id», pero se guardará sin nombre.
También puedes activar un evento de producto directamente desde HTML, por ejemplo cuando un contacto hace clic en un botón o enlace.
<a href="#"
onclick="userengage('product_event', {
product_id: 'the_id',
event_type: 'add to cart',
name: 'product name',
my_attribute: 'value',
my_attribute_2: 'value_2'
})">
CLICK ME!
</a>Para una mejor organización de los datos y una mayor flexibilidad a largo plazo, se recomienda encarecidamente crear los atributos de producto antes de enviarlos al sistema. Definir los atributos con antelación te permite establecer el tipo de dato correcto (como integer, boolean, date, etc.).
Si los atributos no están predefinidos, se crearán automáticamente con el tipo de dato string . Esto puede hacer que el filtrado sea menos preciso y limitar tus opciones de segmentación e informes en el futuro.
Para revisar los tipos de atributo disponibles y elegir el adecuado para tu caso de uso, consulta el siguiente artículo.
Para enviar eventos de producto usando el método JavaScript, asegúrate de que la solicitud incluye los parámetros obligatorios.
Campos obligatorios:
product_id
event_type
Campos opcionales:
name
description
Cualquier otro atributo de evento de producto relevante para tu caso de uso
Para el «event_type», selecciona uno de los valores predefinidos indicados anteriormente en este artículo.
Ejemplo:
userengage("product_event", {
product_id: "12345",
event_type: "add to cart",
name: "Product Name",
description: "Product description"
});Entiende el interés y la intención de compra de tus clientes: haz un seguimiento de acciones clave como visualizaciones de productos, clics, eventos de añadir al carrito y compras para comprender mejor qué les interesa a tus clientes y en qué punto del proceso de compra abandonan.
Aumenta las conversiones con seguimientos automatizados en tiempo real: utiliza los eventos de producto para activar automatizaciones basadas en el comportamiento del cliente. Por ejemplo, enviando recordatorios u ofertas cuando un contacto añade un artículo al carrito, pero no completa la compra.
Crea segmentos más precisos para un marketing más dirigido: crea segmentos basados en interacciones reales con los productos para llegar a la audiencia adecuada con mensajes relevantes, como clientes que han visto un producto concreto o que han mostrado interés por una categoría específica.
Mide el engagement con los productos y optimiza el rendimiento: analiza los datos de eventos de producto a lo largo del tiempo para evaluar la popularidad de los productos, seguir las tendencias de engagement e identificar los productos con mejor o peor rendimiento, para tomar mejores decisiones de marketing y ventas.
Aumenta los ingresos con recomendaciones de productos personalizadas: utiliza los eventos de compra para recomendar productos relevantes en función de lo que tus clientes ya han comprado. Esto te permite lanzar campañas específicas que promocionen artículos complementarios o similares, incentivando compras recurrentes y aumentando el valor medio del pedido.
Utiliza tipos de dato adecuados para los atributos para mantener la precisión y la coherencia. Por ejemplo, define «Precio» como «float» para evitar errores.
Personaliza los datos de tus productos añadiendo atributos que se ajusten a las necesidades de tu negocio, para lograr un seguimiento y un análisis más precisos.
Gestionando tus productos de forma estratégica, puedes obtener información valiosa y mejorar la eficacia de tus estrategias de marketing y engagement.