Primeros pasos con SQL en Composer y el servidor MCP de Klaviyo
Objetivos del artículo
Aprende a hacer preguntas de analítica sobre tus datos de Klaviyo en lenguaje sencillo con Composer o el servidor del Protocolo de Contexto del Modelo (MCP) de Klaviyo. El SQL de Klaviyo Data Platform reúne perfiles, audiencias, campañas, productos y eventos para responder preguntas que involucran varios conjuntos de datos. No necesitas escribir SQL.
SQL actualmente está en beta y está disponible para todos los clientes.
Antes de empezar
Elige dónde quieres hacer tus preguntas:
- Usa Composer para trabajar en el chat dentro de Klaviyo. No hay ninguna configuración adicional de SQL.
- Usa el servidor MCP de Klaviyo para trabajar en un cliente de IA conectado, como Claude o ChatGPT. Si ya conectaste Klaviyo, no necesitas instalar otra herramienta, aunque es posible que tengas que actualizar la lista de herramientas del cliente.
Ambas opciones usan los mismos datos y admiten los mismos tipos de preguntas de análisis. SQL está diseñado para el análisis. Para exportaciones masivas de datos, usa otras herramientas de Klaviyo, como reportes personalizados.
Por lo general, los datos tienen un retraso de unos 30 minutos con respecto a la actividad de la cuenta. Para un pedido, envío o cambio de membresía muy reciente, revisa directamente en Klaviyo.
Haz tu primera pregunta de análisis
Usa Composer
- Abre Composer en Klaviyo. Si necesitas ayuda para encontrarlo, consulta Primeros pasos con Composer.
- Haz una pregunta de analítica en lenguaje sencillo. Incluye la métrica, el rango de fechas y cualquier detalle de audiencia o producto. Por ejemplo: “¿Cuáles son mis 5 productos principales por unidades vendidas en los últimos 90 días?”
- Revisa la respuesta y luego haz preguntas de seguimiento en la misma conversación para profundizar.
Composer decide cuándo usar SQL. No necesitas nombrar una herramienta ni cambiar una configuración.
Usa el servidor MCP de Klaviyo
Para conectar un cliente de IA, necesitas un rol de Propietario, Administrador o Gerente en la cuenta de Klaviyo que quieras usar. Cuando la conexión usa una clave de API, la clave necesita acceso a los conjuntos de datos relacionados con la pregunta. Por ejemplo, una pregunta sobre pedidos y segmentos necesita acceso a eventos y segmentos.
- Conecta Klaviyo con la guía para tu cliente o configuración:
- Documentación para desarrolladores del servidor MCP de Klaviyo para conexiones de terminal y de servidor remoto
- Preguntas frecuentes de la aplicación de Klaviyo para Claude
- Cómo usar la aplicación de Klaviyo para ChatGPT
- Guía del servidor MCP de Klaviyo para agencias para trabajar en varias cuentas de clientes
- Haz una pregunta detallada de análisis en el cliente conectado. No necesitas mencionar la herramienta ask_analytics_question. El cliente la selecciona cuando corresponde para la pregunta.
- Revisa la respuesta y continúa con preguntas de seguimiento. Si la herramienta no está disponible, actualiza la lista de herramientas de Klaviyo del cliente con los pasos de solución de problemas que se indican a continuación.
Si te conectas mediante OAuth, sigue la guía del cliente para revisar y otorgar los permisos solicitados.
Crea una respuesta a partir de otra y revisa el cálculo
SQL es útil cuando una pregunta necesita información de varios conjuntos de datos. Por ejemplo, un recuento de pedidos se convierte en un análisis de audiencia más detallado cuando agregas clientes, pertenencia a segmentos y país.
Empieza con una pregunta y luego desarrolla la respuesta en la misma conversación:
- “¿Cuántos pedidos recibimos el mes pasado?”
- “¿Cuántos clientes hicieron esos pedidos?”
- “Desglosa esos pedidos por los segmentos a los que pertenecen actualmente los clientes”.
- “Desglosa los resultados por segmento y país, e incluye los ingresos para cada grupo.”
- “Para los compradores primerizos, ¿cuánta navegación de productos ocurrió en los 10 días anteriores a su primer pedido?”
Pregunta cómo se calculó la respuesta antes de compartir un número importante o usarlo para tomar una decisión. Por ejemplo:
- “¿Qué conjuntos de datos usaste?”
- “¿Qué rango de fechas y qué filtros aplicaste?”
- “¿Cómo definiste los ingresos en este cálculo?”
- “Explícame paso a paso cómo calculaste eso”.
Usa la explicación para comprobar que la respuesta coincida con la pregunta que querías hacer. Si no coincide, aclara la métrica, las fechas o los filtros y vuelve a preguntar.
Qué datos puedes preguntar
SQL puede responder preguntas sobre estos conjuntos de datos, sujeto a los permisos de tu conexión.
Conjunto de datos | Lo que puedes analizar |
|---|---|
Perfiles | Atributos del cliente, identificadores, valor de vida previsto, interacción en el canal, propiedades personalizadas del perfil y consentimiento para marketing por correo electrónico y SMS |
Segmentos | Audiencias dinámicas con membresía recalculada a partir de condiciones guardadas; el análisis usa la membresía actual |
Listas | Audiencias cuya membresía actual puedes conectar a perfiles y eventos |
Campañas | Envíos únicos, mensajes, variantes que incluyen pruebas A/B y segmentos de envío |
Catálogo | Productos sincronizados desde la plataforma de comercio, incluidas las categorías de productos y las variantes |
Eventos | Actividad de comercio, mensajería, consentimiento, flujo, reseña, cupón, soporte, Klaviyo Customer Hub e integraciones, además de recuentos y tasas de marketing |
Eventos y detalles dentro de los eventos
Los datos de eventos disponibles incluyen:
- Actividad de comercio, como agregar a un carrito, hacer o cancelar un pedido, reembolsos y vistas de productos
- Actividad de correo electrónico, incluidas las recepciones, aperturas, clics, rebotes, entregas fallidas y cancelaciones de suscripción
- Actividad de SMS y WhatsApp, incluidas recepciones, clics, fallas, consentimiento y cancelaciones de suscripción
- Actividad de push, incluidos recibidos, aperturas y rebotes
- Cambios de consentimiento y supresión, incluidas las suscripciones, las cancelaciones de suscripción, las adiciones o eliminaciones de supresión y las actualizaciones de preferencias
- Actividad del flujo, incluidas las entradas, las eliminaciones, el cumplimiento, los saltos y los inicios
- Fusiones de perfiles
- Envíos de reseñas y calificaciones, ediciones, eliminaciones y preparación para revisar
- Asignaciones y usos de cupones
- Dar soporte a la actividad de las conversaciones, incluidos los inicios, los mensajes recibidos o enviados, los escalamientos, las resoluciones y la creación o el cierre de tickets
- Actividad de Klaviyo Customer Hub, como inicios de sesión, favoritos, clics en productos o cupones, y vistas de bloques de contenido
- Eventos de integraciones de fuentes como la interfaz de programación de aplicaciones (API), Shopify y Lightspeed, incluida la actividad de pago, los envíos de formularios, los registros de lealtad, las búsquedas y los envíos
- Métricas de marketing, incluidos recuentos y tasas de entrega, destinatario, apertura, clics, rebotes, cancelar la suscripción, quejas de spam e interacción humana
Algunos eventos contienen valores anidados: grupos de detalles relacionados dentro de un evento. Por ejemplo, un pedido puede contener una lista de artículos, cada uno con un SKU, cantidad y precio. SQL puede leer esos detalles, así que puedes preguntar cuántos pedidos incluyeron un SKU en particular o cuál fue el número promedio de artículos por pedido.
Combina conjuntos de datos
SQL puede conectar conjuntos de datos relacionados para responder una pregunta. Esto se llama una unión, pero no necesitas solicitar una unión de forma explícita. Por ejemplo, puedes hacer lo siguiente:
- Conecta los mensajes de campaña con los nombres de campaña y los datos de interacción para comparar campañas con nombre.
- Conecta la membresía actual a una lista o segmento con los perfiles y los pedidos para analizar la actividad de compra de una audiencia.
- Desglosa una audiencia por país, estado de consentimiento o valor de cliente previsto.
- Conecta productos con categorías, o variantes con productos principales, para analizar el rendimiento del producto o la categoría.
- Conecta las asignaciones de cupones con los usos del cupón para calcular el canje e identificar cupones no canjeados.
Preguntas de ejemplo
Adapta las fechas, los productos, los segmentos y los detalles de las campañas a la cuenta.
Objetivo | Pregunta de ejemplo |
|---|---|
Comparar pedidos a lo largo del tiempo | “¿Cuántos pedidos recibimos en el T2 de 2025, el T1 de 2026 y el T2 de 2026?” |
Analizar detalles del pedido | “¿Cuántos pedidos en los últimos 90 días incluyeron el SKU FACEBUND01?” |
Resumir ingresos y reembolsos | “Resume los pedidos de junio: total de pedidos, ingresos totales, número de pedidos reembolsados y monto total de reembolsos”. |
Comprende las compras repetidas | “¿Qué porcentaje de clientes solo han realizado 1 pedido?” |
Mide el tiempo entre compras | “¿Cuál es el número promedio de días entre la primera y la segunda compra de un cliente?” |
Comparar el valor del cliente | “Compara el valor de vida de los clientes con interacciones por correo electrónico con los clientes que no interactúan”. |
Encuentra los productos principales | “¿Cuáles son mis 5 productos principales por unidades vendidas en los últimos 90 días?” |
Comparar interacción de la campaña | “¿Qué día de la semana obtiene la mejor tasa de apertura de campañas?” |
Explora el rendimiento del correo electrónico | “¿Cuáles fueron mis 10 correos electrónicos más abiertos, excluyendo las campañas de ventas?” |
Analizar dispositivos | “¿Cuál es la división del dispositivo entre móvil y escritorio para mis aperturas de correo electrónico?” |
Revisar la actividad del flujo | “¿Qué flujos han enviado mensajes en el último año?” |
Comparar el rendimiento de SMS | “¿Cuál fue mi tasa de clics (CR) y mi tasa de cancelación de suscripción de SMS en abril, mayo y junio?” |
Investigar rebotes | “Mi boletín del 2 de julio tuvo 5,514 rebotes. ¿Vinieron de 1 proveedor de bandeja de entrada? ¿Cuáles fueron los tipos de rebote?” |
Revisar la frecuencia de envío | “¿Cuántos perfiles recibieron 2 o más correos electrónicos en 1 día?” |
Conoce los límites
Datos no disponibles
SQL actualmente no admite:
- Pertenencia a una lista o un segmento en un momento anterior
- Formularios de registro o su rendimiento
- Objetos personalizados
- Plantillas de correo electrónico o SMS
Los eventos de integraciones pueden incluir envíos de formularios, pero eso no significa que SQL admita el análisis de formularios de registro ni de su rendimiento. Si la pregunta depende de datos no disponibles, la respuesta puede estar incompleta o el cliente podría no poder responder.
Actualidad de los datos y diferencias con los informes de Klaviyo
Por lo general, los datos tienen un retraso de unos 30 minutos con respecto a la cuenta. La actividad reciente puede no aparecer de inmediato.
Por lo general, los números deben ser consistentes con Klaviyo, pero pueden presentarse pequeñas diferencias debido a diferencias en las definiciones, optimizaciones de consultas o actualidad de los datos. SQL usa una fuente de datos diferente a otras formas de acceder a los datos de Klaviyo. Klaviyo verificó que estos datos hayan sido consistentes en un 99 % durante los últimos 3 años.
Solicita el cálculo, el intervalo de fechas y los filtros cuando un número difiera de un informe. La explicación puede ayudarte a identificar si estás comparando la misma métrica y el mismo periodo.
Consultas generadas y tiempos de espera
SQL genera una consulta a partir de la pregunta. Actualmente no hay un punto de conexión donde puedas enviar tu propia consulta SQL y recibir un resultado garantizado y repetible. Distintas formulaciones pueden producir consultas diferentes y resultados ligeramente distintos. Revisa el cálculo de los números importantes.
Un cliente de MCP puede dejar de esperar una respuesta antes de que lo haga Composer. Claude, por ejemplo, tiene una ventana de tiempo de espera de 60 segundos. Si se agota el tiempo de espera de una pregunta, delimita el intervalo de fechas, reduce el número de desgloses o divide el análisis en preguntas más pequeñas.
Guía de solución de problemas
La herramienta de análisis no está disponible
Si no ves ask_analytics_question en tu cliente de IA, confirma que SQL esté habilitado para tu cuenta y actualiza la lista de herramientas de Klaviyo del cliente.
En Claude:
- Ve a Personalizar > Conectores > Klaviyo.
- Abre el menú de tres puntos en la esquina superior derecha.
- Haz clic en Actualizar lista de herramientas y luego vuelve a intentar hacer tu pregunta.
SQL no puede devolver datos que sabes que están en la cuenta
Revisa si el conjunto de datos es compatible y considera el retraso típico de 30 minutos. Si la conexión usa una clave de API, revisa que tenga acceso a todos los conjuntos de datos involucrados, como perfiles, segmentos, listas, campañas, catálogos o eventos. Actualiza los permisos faltantes en Klaviyo, actualiza la lista de herramientas de Klaviyo del cliente y vuelve a intentar la pregunta.
Para una conexión de OAuth, revisa los permisos con la guía de conexión del cliente.
Se agotó el tiempo de espera de una pregunta
Prueba con un intervalo de fechas más corto o con menos desgloses, o divide la pregunta en preguntas más pequeñas. Vuelve a intentar la pregunta más específica y luego continúa a partir del resultado con preguntas de seguimiento.
Un número no coincide con Klaviyo
Pregunta cómo SQL calculó el número, incluidos los conjuntos de datos, el intervalo de fechas y los filtros. Revisa si las definiciones de la métrica y la actualización de los datos explican la diferencia. Si la diferencia es grande, ponte en contacto con el equipo de soporte de Klaviyo y comparte la pregunta, el número devuelto y el número que esperabas.
Composer rechaza una pregunta
Reformula la pregunta con una métrica específica, un rango de fechas y una audiencia. Verifica que use uno de los conjuntos de datos compatibles y vuelve a intentarlo.