Integración Klaviyo

Los motores de recomendación y automatización de Klaviyo solo funcionan si tienen una imagen actualizada de tu catálogo. Una vez sincronizado el catálogo, Klaviyo combina los datos de tus productos con el comportamiento en el sitio web y por correo electrónico (productos vistos, añadidos al carrito, inicios de compra e historial de compras) para crear bloques de recomendaciones personalizadas, activar notificaciones de reposición de stock y mostrar en los correos electrónicos de carritos abandonados y navegación abandonada los productos exactos que el comprador consultó. Klaviyo señala que los productos a los que les faltan datos clave, como una imagen, se excluyen automáticamente de las recomendaciones, y que los artículos ya comprados o agotados se filtran de los bloques de sugerencias, por lo que la integridad y precisión de la información determinan directamente el rendimiento de estos flujos.

Una vez sincronizado un catálogo personalizado, Klaviyo permite a los profesionales del marketing arrastrar un bloque de producto a un flujo o correo electrónico de campaña y completarlo dinámicamente, sin necesidad de escribir HTML, ya que la propia documentación de Klaviyo indica que "los bloques de producto no admiten HTML personalizado". Estos bloques pueden mostrar productos vistos recientemente (según la métrica de Producto visto), artículos similares a los que un cliente vio o pidió, productos añadidos al carrito (a partir de los eventos Añadido al carrito o Inicio del proceso de compra) o listas clásicas de los más vendidos y estáticas. Para casos de uso más avanzados, como un motor de recomendaciones propio, Klaviyo también admite etiquetas de búsqueda de catálogo que hacen referencia a artículos específicos mediante su ID único dentro de las plantillas. Todo esto depende de que el feed del catálogo contenga registros de artículos limpios y completos con los identificadores correctos.

Klaviyo admite dos vías para sincronizar un catálogo externo: una fuente de catálogo personalizada alojada o la integración directa a través de la API de catálogos.

Para un feed alojado, Klaviyo acepta JSON o XML ; CSV no es compatible. El feed debe ser accesible públicamente a través de HTTPS, y Klaviyo lo obtiene según un cronograma fijo en lugar de bajo demanda. La guía de Klaviyo especifica que los datos en el feed deben tener "solo un nodo de profundidad, no JSON o XML anidados" (los feeds de Google Merchant son la única excepción documentada), que el primer elemento del feed debe contener todos los campos que se pretenden mapear para que Klaviyo pueda detectar el esquema, y ​​que ningún campo obligatorio debe quedar en blanco. Klaviyo recomienda usar "0" para números no disponibles y "n/a" para texto no disponible en lugar de omitir el campo. Los archivos del feed pueden tener hasta 100 MB, aunque Klaviyo recomienda mantenerse por debajo de 50 MB para un procesamiento fiable, y los catálogos más grandes se pueden dividir en varios archivos que alimentan un solo catálogo.

Alternativamente, los sistemas que necesitan actualizaciones en tiempo real o basadas en eventos pueden enviar elementos directamente a través de la API de catálogos de Klaviyo, que utiliza un formato de ID de recurso de {integration_type}:::{catalog_type}:::{external_id} - Por ejemplo $custom:::$default:::3829918373-TShirt-1. Klaviyo actualmente solo admite el $custom tipo de integración emparejado con el $default tipo de catálogo.

Feedance genera el catálogo JSON o XML alojado que Klaviyo espera, mapeado campo por campo al esquema de Klaviyo, por lo que no es necesario crear manualmente un feed plano de un solo nodo ni mantener una integración de API personalizada.

1. En Feedance, crea una nueva fuente de datos y selecciona Klaviyo como plantilla de destino.
2. Asigna los datos de tu producto a los campos obligatorios de Klaviyo ($id, $title, $description, $link, $image_link) y añade los campos opcionales que quieras usar, como $price, $inventory_quantity, $inventory_policy y categories.
3. Publica el feed para obtener una URL de feed pública alojada en HTTPS de Feedance.
4. En Klaviyo, vaya a Contenido > Productos > Administrar fuentes de catálogo personalizadas, haga clic en Agregar nueva fuente y pegue la URL de la fuente Feedance.
5. Configure la asignación de campos en la página de Fuentes personalizadas de Klaviyo para confirmar que cada atributo se alinee correctamente y, a continuación, póngase en contacto con el soporte técnico de Klaviyo con los nombres de las métricas relevantes y los nombres de las propiedades del ID del artículo para que su equipo pueda finalizar el catálogo para la producción, tal como lo requiere el propio flujo de configuración de Klaviyo.
6. Una vez que Klaviyo confirme que el catálogo está activo, supervise la primera sincronización en Feedance y en Klaviyo para detectar cualquier problema de asignación antes de que los bloques de recomendaciones o los flujos de "De vuelta en stock" se activen.

Klaviyo obtiene feeds de catálogos personalizados en un ciclo fijo de 6 horas . Si tu feed está detrás de una capa de caché, la documentación de Klaviyo advierte que debes desactivar la caché o actualizarla manualmente cuando cambien los datos subyacentes; de lo contrario, Klaviyo seguirá obteniendo datos obsoletos almacenados en caché incluso después de que se actualice tu fuente. Además de la sincronización del feed en sí, los modelos de recomendación de Klaviyo necesitan su propio tiempo de entrenamiento: la plataforma indica que sus sistemas suelen tardar entre 2 días y una semana en entrenarse con un catálogo nuevo, y que los modelos de recomendación generalmente se reentrenan cada 2 a 7 días, según el uso. Feedance actualiza tu feed de forma fiable con la cadencia de 6 horas de Klaviyo, lo que permite que los cambios de precio, inventario y nuevos productos fluyan hacia ese ciclo de entrenamiento tan rápido como lo permita la propia arquitectura de Klaviyo.

La documentación de sincronización y solución de problemas de Klaviyo señala varias causas recurrentes de fallos en la sincronización del catálogo:

• Fuente no accesible: Klaviyo no puede acceder a la URL de origen, normalmente porque está protegida con contraseña o bloqueada por alguna otra capa de seguridad.
• Datos almacenados en caché obsoletos: Una capa de almacenamiento en caché situada delante de la URL del feed sirve a Klaviyo una versión antigua del archivo, por lo que las actualizaciones nunca aparecen hasta que se borra o se actualiza la caché.
• Estructuras de datos anidadas: El analizador de Klaviyo espera datos "de un solo nodo de profundidad", por lo que el JSON o XML anidado (fuera de la excepción del feed de Google Merchant) no se asignará correctamente.
• Primer elemento incompleto: Dado que Klaviyo utiliza el primer elemento del feed para detectar el esquema, si a un elemento le faltan campos que aparecen más adelante en el archivo, esos campos pueden eliminarse de todo el catálogo.
• Identificadores duplicados o faltantes: Klaviyo tiene un artículo específico para solucionar problemas relacionados con errores de identificadores duplicados o faltantes, y en lo que respecta a la API de catálogos, intentar crear un elemento con un external_id que ya existe devuelve un error 409 Conflict; los fallos en trabajos masivos muestran el campo específico y el motivo en una matriz de errores en la respuesta de la API.
• Imágenes faltantes: Los elementos que no tienen una URL de imagen quedan excluidos del motor de recomendaciones de Klaviyo, incluso si el resto del registro es válido.

Mantén estable el ID del artículo en cada sincronización: Klaviyo compara los artículos según este valor, por lo que un ID cambiante hace que Klaviyo trate un producto existente como nuevo y restablezca cualquier recomendación acumulada e historial de inventario para él. Completa todos los campos opcionales que Klaviyo puede usar para la automatización, especialmente $price y $inventory_quantity, ya que los datos de inventario son necesarios para activar los flujos de "De nuevo en stock" y los datos de precios alimentan las campañas de bajada de precios. Asegúrate de que cada artículo tenga una URL de imagen HTTPS válida, ya que Klaviyo elimina silenciosamente los productos sin imagen de los bloques de recomendación en lugar de generar un error. Si estás gestionando más de aproximadamente 50 MB de datos de catálogo, divídelos en varios archivos de alimentación que apunten al mismo catálogo en lugar de enviar un archivo demasiado grande, y si tu catálogo se acerca a los límites documentados de Klaviyo de 250 000 artículos, 500 000 variantes o 2,500 categorías, o si tu alimentación superará el millón de artículos, planea contactar con el soporte de Klaviyo antes de la configuración, según sus propias directrices.

¿Klaviyo acepta archivos CSV?
No. La sincronización de feeds de catálogo personalizado de Klaviyo solo acepta JSON o XML; CSV no es un formato compatible.

¿En qué se diferencia un feed de catálogo personalizado de la API de catálogos?
Un feed de catálogo personalizado es un archivo alojado que Klaviyo obtiene según su propio calendario de 6 horas. La API de catálogos permite enviar directamente la creación, actualización y eliminación de artículos, lo que resulta ideal para comerciantes que necesitan actualizaciones más rápidas o basadas en eventos que las que puede proporcionar un feed de sondeo.

¿Por qué no se actualiza mi catálogo en Klaviyo?
Las causas más comunes que documenta Klaviyo son una capa de almacenamiento en caché que sirve datos obsoletos, una URL de fuente que se ha vuelto inaccesible o protegida, o una estructura de fuente mal formada o anidada que no cumple con el requisito de Klaviyo de un solo nodo de profundidad.

¿Qué necesito en mi feed para activar las alertas de reposición de stock?
La guía de Klaviyo para la función "De nuevo en stock" requiere que cada artículo de su catálogo personalizado incluya el campo $inventory_quantity; sin él, Klaviyo no tiene señal de stock para activar una notificación de reposición.

¿Puedo usar HTML personalizado en los bloques de recomendación de productos de Klaviyo?
No. La documentación de Klaviyo indica que los bloques de productos no admiten HTML personalizado; para obtener un formato avanzado, es necesario utilizar la opción Fuente en un bloque de texto o etiquetas de búsqueda de catálogo.