Primeros pasos con SQL en Composer y el servidor MCP de Klaviyo
Qué aprenderás
Descubre cómo hacer preguntas de analítica sobre tus datos de Klaviyo en lenguaje sencillo usando Composer o el servidor del Protocolo de contexto del modelo (MCP) de Klaviyo. Klaviyo Data Platform SQL reúne perfiles, audiencias, campañas, productos y eventos para responder preguntas que implican varios conjuntos de datos. No necesitas escribir SQL.
SQL está actualmente 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 has conectado Klaviyo, no necesitas instalar otra herramienta, aunque puede que necesites actualizar la lista de herramientas del cliente.
Ambas opciones usan los mismos datos y permiten los mismos tipos de preguntas de análisis. SQL está diseñado para el análisis. Para exportaciones masivas de datos, utiliza otras herramientas de Klaviyo, como los informes personalizados.
Normalmente, los datos se retrasan unos 30 minutos con respecto a la actividad de la cuenta. Si se trata de un pedido, un envío o un cambio de suscripción muy reciente, compruébalo directamente en Klaviyo.
Haz tu primera pregunta de analítica
Utiliza Composer
- Abre Composer en Klaviyo. Si necesitas ayuda para encontrarlo, consulta Primeros pasos con Composer.
- Haz una pregunta de análisis en lenguaje sencillo. Incluye la métrica, el intervalo de fechas y cualquier detalle sobre la audiencia o los productos. Por ejemplo: «¿Cuáles son mis 5 productos principales por unidades vendidas en los últimos 90 días?»
- Revisa la respuesta y, a continuación, haz preguntas de seguimiento en la misma conversación para profundizar en ella.
Composer decide cuándo usar SQL. No es necesario asignar un nombre a una herramienta ni cambiar ninguna configuración.
Usa el servidor MCP de Klaviyo
Para conectar un cliente de IA, necesitas un rol de Propietario, Administrador o Mánager 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 que intervienen en tu pregunta. Por ejemplo, una pregunta sobre pedidos y segmentos necesita acceso a eventos y segmentos.
- Conecta Klaviyo usando 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 sobre 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 con varias cuentas de cliente
- Haz una pregunta de análisis detallada en el cliente conectado. No hace falta que menciones 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 de tu cliente con los pasos de resolución de problemas que se indican a continuación.
Si te conectas mediante OAuth, sigue la guía de tu cliente para revisar y conceder los permisos solicitados.
Partir de una respuesta y comprobar 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 se añaden clientes, pertenencia a segmentos y país.
Empieza con una pregunta y, a continuación, desarrolla la respuesta en la misma conversación:
- «¿Cuántos pedidos recibimos el mes pasado?»
- «¿Cuántos clientes realizaron 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 de cada grupo».
- «Para los compradores que compran por primera vez, ¿cuánta navegación de productos se produjo en los 10 días previos a su primer pedido?»
Pregunta cómo se calculó la respuesta antes de compartir un número importante o de usarlo para tomar una decisión. Por ejemplo:
- «¿Qué conjuntos de datos utilizaste?»
- «¿Qué intervalo de fechas y 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 coincide con la pregunta que querías hacer. Si no es así, aclara la métrica, las fechas o los filtros y vuelve a preguntar.
Sobre qué datos puedes preguntar
SQL puede responder a preguntas sobre estos conjuntos de datos, sujeto a los permisos de la conexión.
Conjunto de datos | Lo que puedes analizar |
|---|---|
Perfiles | Atributos de cliente, identificadores, valor de vida previsto, compromiso del canal, propiedades de perfil personalizadas y consentimiento de marketing por email y SMS |
Segmentos | Audiencias dinámicas con la membresía recalculada según condiciones guardadas; el análisis utiliza la membresía actual |
Listas | Audiencias cuya pertenencia actual puedes conectar con perfiles y eventos |
Campañas | Envíos únicos, mensajes, variantes, incluidas las pruebas A/B, y segmentos de envío |
Catálogo | Productos sincronizados desde tu plataforma de comercio, incluidas las categorías de productos y las variantes |
Eventos | Actividad de comercio, mensajería, consentimiento, flujo, reseñas, 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 añadir al carrito, realizar o cancelar un pedido, reembolsos y visualizaciones de productos
- Actividad de Email, incluidos los recibos, las aperturas, los clics, los rebotes, las entregas fallidas y darse de baja
- Actividad de SMS y WhatsApp, incluidas las recepciones, los clics, los fallos, el consentimiento y las bajas
- Actividad de push, incluidas recepciones, aperturas y rebotes
- Cambios en el consentimiento y la supresión, incluidas suscripciones, bajas, incorporaciones o eliminaciones de supresión y actualizaciones de preferencias
- Actividad del flujo, incluidas las entradas, las eliminaciones, el cumplimiento, las omisiones y los inicios
- Fusiones de perfiles
- Envíos, ediciones, eliminaciones y preparación de reseñas y valoraciones para su revisión
- Asignaciones y usos de cupones
- Actividad de las conversaciones de soporte, incluidos los inicios, los mensajes recibidos o enviados, las escaladas, 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 visualizaciones de bloques de contenido
- Eventos de integración de fuentes como la API, Shopify y Lightspeed, incluida la actividad de finalización de compra, los envíos de formularios, los registros en programas de fidelización, las búsquedas y los envíos
- Métricas de marketing, incluidos los recuentos y las tasas de entrega, destinatarios, aperturas, clics, rebotes, bajas, quejas por spam y compromiso humano
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, una cantidad y un precio. SQL puede leer esos detalles, así que puedes preguntar cuántos pedidos incluyeron un SKU concreto o cuál fue el número medio de artículos por pedido.
Combinar conjuntos de datos
SQL puede conectar conjuntos de datos relacionados para responder a una pregunta. Esto se denomina join, pero no es necesario solicitar un join 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 compromiso para comparar campañas con nombre.
- Conecta la suscripción actual a la lista o al 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 de los productos o las categorías.
- Conecta las asignaciones de cupones con los usos de cupones para calcular los canjes e identificar los cupones no canjeados.
Preguntas de ejemplo
Adapta las fechas, los productos, los segmentos y los detalles de la campaña a la cuenta.
Objetivo | Pregunta de ejemplo |
|---|---|
Comparar pedidos a lo largo del tiempo | «¿Cuántos pedidos recibimos en el 2.º trimestre de 2025, el 1.er trimestre de 2026 y el 2.º trimestre de 2026?» |
Analiza los detalles del pedido | «¿Cuántos pedidos de los últimos 90 días incluyeron el SKU FACEBUND01?» |
Resume los ingresos y los reembolsos | «Resume los pedidos de junio: total de pedidos, ingresos totales, número de pedidos reembolsados y importe total de los reembolsos». |
Comprender las compras repetidas | «¿Qué porcentaje de clientes ha realizado solo 1 pedido?» |
Medir el tiempo entre compras | «¿Cuál es el número medio de días entre la primera y la segunda compra de un cliente?» |
Compara el valor del cliente | “Compara el valor de vida de los clientes que interactúan con el email con el de 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 el compromiso de la campaña | «¿Qué día de la semana tiene la mejor tasa de apertura de campaña?» |
Explora el rendimiento del email | «¿Cuáles fueron mis 10 emails más abiertos, excluidas las campañas de rebajas?» |
Analiza los dispositivos | «¿Cuál es la división entre móvil y ordenador en las aperturas de mi email?» |
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 y mi tasa de bajas de SMS en abril, mayo y junio?» |
Investiga los rebotes | «Mi boletín del 2 de julio tuvo 5514 rebotes. ¿Provinieron de 1 proveedor de buzón? ¿Cuáles fueron los tipos de rebote?» |
Comprobar la frecuencia de envío | «¿Cuántos perfiles recibieron 2 o más emails en 1 día?» |
Información sobre los límites
Datos no disponibles
SQL actualmente no admite:
- Pertenencia a una lista o un segmento en un momento pasado
- formulario de registro o su rendimiento
- Objetos personalizados
- Plantillas de email 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 tu pregunta depende de datos no disponibles, es posible que la respuesta esté incompleta o que el cliente no pueda responder.
Actualización de datos y diferencias con los informes de Klaviyo
Los datos suelen tener un retraso de unos 30 minutos respecto a tu cuenta. Es posible que la actividad reciente no aparezca de inmediato.
Por lo general, las cifras deben ser coherentes con Klaviyo, pero pueden producirse pequeñas diferencias debido a diferencias en las definiciones, las optimizaciones de consultas o la actualidad de los datos. SQL usa una fuente de datos diferente a otras formas de acceder a los datos de Klaviyo. Klaviyo ha comprobado que estos datos han sido coherentes en un 99 % durante los últimos 3 años.
Pregunta por 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 tu pregunta. Actualmente, no hay ningún punto de conexión en el que puedas enviar tu propia consulta SQL y recibir un resultado garantizado y repetible. Un redactado diferente puede 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 haría Composer. Claude, por ejemplo, tiene una ventana de tiempo de espera de 60 segundos. Si se agota el tiempo de espera de una pregunta, acota el intervalo de fechas, reduce el número de desgloses o divide el análisis en preguntas más pequeñas.
Solución de problemas
La herramienta de análisis no está disponible
Si no ves ask_analytics_question en el cliente de IA, confirma que SQL está habilitado para la 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 vuelve a intentarlo con tu pregunta.
SQL no puede devolver datos que sabes que están en la cuenta.
Comprueba si el conjunto de datos es compatible y ten en cuenta el retraso habitual de 30 minutos. Si la conexión utiliza una clave de API, comprueba que tenga acceso a todos los conjuntos de datos implicados, como perfiles, segmentos, listas, campañas, catálogos o eventos. Actualiza los permisos que faltan en Klaviyo, actualiza la lista de herramientas de Klaviyo del cliente y vuelve a intentar la pregunta.
Para una conexión OAuth, revisa los permisos mediante la guía de conexión del cliente.
Una pregunta ha caducado
Prueba un intervalo de fechas más corto o menos desgloses, o divide la pregunta en preguntas más pequeñas. Vuelve a intentarlo con la pregunta más específica y, después, amplía el 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. Comprueba si las definiciones de métricas y la actualización de los datos explican la diferencia. Si la diferencia es grande, ponte en contacto con el 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 intervalo de fechas y una audiencia. Comprueba que usa uno de los conjuntos de datos compatibles y, luego, vuelve a intentarlo.
Recursos adicionales
- Primeros pasos con Composer
- Documentación para desarrolladores del servidor MCP de Klaviyo
- Preguntas frecuentes sobre 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
- Primeros pasos con los informes personalizados en Klaviyo