Referencia de datos de Square

Objetivos del artículo

Descubre qué datos se sincronizan de Square a Klaviyo, cómo verlos y qué propiedades contienen los eventos de Square.

Antes de empezar

Si aún no lo has hecho, lee nuestro artículo sobre los primeros pasos con Square para obtener instrucciones paso a paso sobre cómo integrar tu tienda antes de continuar con este artículo.

Cómo ver tus datos

Asegúrate de que la integración de Square esté habilitada. Para revisar la sincronización de datos de Square a Klaviyo:

1. En tu cuenta de Klaviyo, selecciona Integraciones en el menú de navegación de la izquierda.
2. Selecciona Square en la lista.
3. Selecciona la pestaña Datos en la parte superior.

Aquí verás los datos recientes sincronizados de Square a Klaviyo y una barra de progreso mientras se sincronizan los datos históricos.

Si tienes problemas con la sincronización, selecciona Reiniciar importación en la sección datos históricos para reiniciar una sincronización histórica incompleta, o Volver a importar para ejecutarla de nuevo después de que se complete. Necesitas permiso para administrar integraciones para usar estos controles.

Datos sincronizados desde Square

Los eventos de Square Online se sincronizan con Klaviyo en tiempo real, y los eventos de Square POS se sincronizan cada 30 minutos.

Los datos sincronizados de Square a Klaviyo incluyen:

• Visitantes conocidos del sitio rastreados como eventos con actividad en el sitio (si dejaste marcada la configuración de JavaScript en el sitio)
• Cancelaciones de suscripción de correo electrónico
• Información del cliente asociada con eventos de pedidos
• Tu catálogo de Square (incluidos los artículos solo de POS)
• Los siguientes eventos:
  • Página de pago abandonada
  • Pedido realizado
  • Producto Pedido
  • Pedido Reembolsado
  • Pedido Cancelado
  • Pedido parcial completado
  • Pedido completado

Los eventos de pedidos de Square POS se sincronizarán con Klaviyo (y se crearán perfiles de Klaviyo) si hay una dirección de correo electrónico o un número de teléfono asociado al pedido que el cliente compartió directamente con tu empresa.

Los eventos a nivel de pedido, como Pedido realizado y Pedido reembolsado, incluyen una propiedad de Nombre de fuente que identifica el origen, como Square Online o POS, para que puedas segmentar estos eventos en Klaviyo. Esta propiedad no se incluye en los eventos Producto pedido ni Checkout abandonado.

Detalles de la información del cliente

La generación de perfiles de clientes se sincroniza de Square a Klaviyo si hay una dirección de correo electrónico o un número de teléfono asociados con el cliente que éste compartió directamente con tu compañía. Los perfiles sincronizados de Square a Klaviyo pueden incluir las siguientes propiedades, según los datos disponibles en Square:

• Correo electrónico
  Dirección de correo electrónico del cliente
• Nombre
  Nombre del cliente, si tanto el nombre como el apellido están disponibles
• Apellido
  Apellido del cliente, si el nombre y el apellido están disponibles
• Ciudad
  Ciudad del cliente
• Estado/región
  Estado del cliente
• Código postal
  Código postal del cliente
• País
  País del cliente
• Número de teléfono
  Número de teléfono del perfil. Klaviyo solo creará perfiles solo con número de teléfono si has configurado Klaviyo SMS
• Cumpleaños
  La fecha de nacimiento del cliente, si la proporciona
• Grupos de Square
  Grupos de Square asociados con el cliente. Actualmente, esto no incluye Square Segments.

Consentimiento para enviar correos electrónicos

Las integraciones de Square sincronizan el estado de cancelar la suscripción de correo electrónico, pero no sincronizan el consentimiento de suscripción al correo electrónico. Cuando email_unsubscribed es true en Square, Klaviyo marca al cliente como Canceló la suscripción. Cuando es false, la sincronización no cambia el estado de cancelar la suscripción de correo electrónico de un perfil existente. Los perfiles nuevos sin consentimiento de correo electrónico se marcan como Nunca se suscribió.

consentimiento para enviar SMS

El consentimiento de SMS recopilado en Square Online actualmente no se puede sincronizar con Klaviyo. Puedes recopilar el consentimiento de SMS a través de un formulario de Klaviyo en tu sitio de Square.

Detalles del artículo del catálogo

Los artículos del catálogo se sincronizan de Square a Klaviyo con las siguientes propiedades:

• Nombre del elemento
• ID del artículo
• Descripción del artículo
• Precio del artículo
• SKU
• URL
• URL de la imagen
• Cantidad de inventario
• Política de inventario
• Categoría
• Publicada
• Variantes

Eventos sincronizados y sus propiedades

Página de pago abandonada

Este evento se activa 1 hora después de que se abandone un carrito en una tienda Square Online y se puede usar en un flujo de carrito abandonado. Square debe proporcionar un registro de cliente con una dirección de correo electrónico o un número de teléfono válidos para que el evento se sincronice.

Para que este evento se sincronice con Klaviyo, primero debes desactivar los correos electrónicos de carrito abandonado en Square. Para hacerlo:

1. Inicia sesión en Square y navega a tu página de resumen
2. Selecciona Comunicaciones > Carrito abandonado
3. Selecciona Inhabilitar

Las propiedades de nivel superior del evento en Klaviyo son:

• $value
  Monto total en el carrito
• Artículos
  Artículos incluidos en el carrito
• Colecciones
  Colecciones vinculadas a los artículos incluidos en el carrito

Los eventos de Checkout abandonado no incluyen una propiedad de cantidad de artículos de nivel superior.

Pedido realizado

Este evento se activa cuando se realiza un pedido en una tienda de Square Online o en una terminal de POS.

Las propiedades de nivel superior del evento en Klaviyo son:

• $value
  Monto total del pedido
• Artículos
  Artículos incluidos en el pedido
• Colecciones
  Colecciones vinculadas a los artículos incluidos en el pedido
• Cantidad de artículos
  Número total de artículos incluidos en el pedido
• Códigos de descuento
  Nombres de los descuentos aplicados al pedido
• Descuentos totales
  Monto total del descuento
• Nombre de la fuente
  Origen del pedido (Square Online, POS)
• Nombre de la ubicación
  Nombre de la ubicación de Square

Producto Pedido

Este evento se activa cuando se realiza un pedido en una tienda de Square Online o en una terminal POS. Para los productos del catálogo que se venden en unidades enteras, se activa un evento de Producto pedido por cada unidad comprada, hasta 100 eventos por línea de pedido. Para los productos que se venden por peso u otra unidad fraccionaria, 1 evento representa la cantidad total comprada.

Las propiedades de nivel superior del evento en Klaviyo son:

• $value
  Valor de la cantidad del producto representada por este evento, incluidos los modificadores y sin incluir impuestos
• Nombre
  Nombre del producto pedido
• Variante
  Nombre de la variante del producto
• SKU
  SKU del producto
• ProductID
  Identificador del producto
• ID de variante
  Identificador de variante
• Cantidad
  1 por cada evento de unidad completa, o la cantidad total comprada de un producto vendido en unidades fraccionarias
• Colecciones
  Colecciones vinculadas al producto
• Opción de variante: [option name]
  Valor de la opción de variante con nombre para el producto pedido
• Opciones del modificador: [modifier list name]
  Opciones de modificador seleccionadas de la lista de modificadores con nombre para el producto pedido

Pedido Reembolsado

Este evento se activa cuando se reembolsa un pedido en una tienda de Square Online o en una terminal de POS.

Las propiedades de nivel superior del evento en Klaviyo son:

• $value
  Monto reembolsado
• URL del recibo
  URL del recibo del pedido
• Nombre de la fuente
  Origen del pedido (Square Online, POS)
• Nombre de la ubicación
  Nombre de la ubicación de Square

Pedido Cancelado

Este evento se activa cuando un cliente crea un pedido en tu tienda, pero luego cancela el pedido completo. El evento que Klaviyo rastrea incluye toda la información del producto sobre los artículos que alguien compró, incluidos los nombres e imágenes de los productos. No se admiten cancelaciones parciales.

Las propiedades de nivel superior del evento en Klaviyo son:

• $value
  Monto total del pedido
• Artículos
  Artículos incluidos en el pedido
• Colecciones
  Colecciones vinculadas a los artículos incluidos en el pedido
• Cantidad de artículos
  Número total de artículos incluidos en el pedido
• Códigos de descuento
  Nombres de los descuentos aplicados al pedido
• Descuentos totales
  Monto total del descuento
• Nombre de la fuente
  Origen del pedido (Square Online, POS)
• Nombre de la ubicación
  Nombre de la ubicación de Square

Pedido parcial completado

Se registra un evento Fulfilled Partial Order por cada envío, entrega o recolección completados mientras otros cumplimientos siguen incompletos. Cuando todos los cumplimientos están completos, el cumplimiento final se registra como Fulfilled Order. Si Square no proporciona detalles de los artículos para un cumplimiento parcial, el evento contiene detalles para todo el pedido.

Las propiedades de nivel superior del evento en Klaviyo son:

• $value
  Importe total del cumplimiento
• Artículos
  Artículos incluidos en el cumplimiento
• Colecciones
  Colecciones vinculadas a los artículos incluidos en el cumplimiento
• Cantidad de artículos
  Número total de artículos incluidos en el cumplimiento
• Códigos de descuento
  Nombres de los descuentos aplicados al pedido
• Descuentos totales
  Monto total del descuento
• Nombre de la fuente
  Origen del pedido (Square Online, POS)
• Nombre de la ubicación
  Nombre de la ubicación de Square

Pedido completado

Este evento se activa cuando se completa un pedido en una tienda de Square Online o en una terminal POS. Se registrará un evento de Pedido completado en el último cumplimiento, si hay varios vinculados a un pedido.

Las propiedades de nivel superior del evento en Klaviyo son:

• $value
  Monto total del pedido
• Artículos
  Artículos incluidos en el pedido
• Colecciones
  Colecciones vinculadas a los artículos incluidos en el pedido
• Cantidad de artículos
  Número total de artículos incluidos en el pedido
• Códigos de descuento
  Nombres de los descuentos aplicados al pedido
• Descuentos totales
  Monto total del descuento
• Estado de cumplimiento
  Estado del pedido reportado por Square
• Nombre de la fuente
  Origen del pedido (Square Online, POS)
• Nombre de la ubicación
  Nombre de la ubicación de Square

Recursos adicionales