Cuando activas Custom Fields en la integración con Klaviyo, JeriCommerce sincroniza atributos de clientes como propiedades personalizadas del perfil mediante Klaviyo Profile Import API. Aparecen en Klaviyo > Profiles > [Profile] > Custom Properties y se pueden usar en flujos, segmentos y contenido dinámico.

Para consultar la lista completa de propiedades sincronizadas, su significado y cuándo se sincroniza cada una, visita Campos personalizados: propiedades de clientes sincronizadas.

Nombres de las propiedades de Klaviyo

La mayoría de los nombres coincide con los nombres genéricos, pero hay diferencias importantes en los nombres y tipos de datos específicos de Klaviyo:

Nombre de propiedad en Klaviyo Tipo
balance Número entero (como cadena de texto)
birthdate Fecha (yyyy-MM-dd)
jericommerce_download_wallet_pass_url Cadena URL
tier-name Cadena de texto
tier-balance Número entero (como cadena de texto)
tier-entered-at Fecha (yyyy-MM-dd)
tier-expires-at Fecha (yyyy-MM-dd)

Diferencias principales con Shopify

  • Identificación del perfil: Klaviyo asocia a los clientes por correo electrónico, mientras que Shopify usa el ID de cliente de GraphQL.
  • Nombre de la propiedad: la URL de descarga corresponde a jericommerce_download_wallet_pass_url (usa guiones bajos en vez de guiones).
  • Formato de fecha: las fechas se envían como cadenas yyyy-MM-dd. Si falta una fecha, se envía el valor "-".

Activa Custom Fields

En JeriCommerce, abre Settings → Integrations → Klaviyo, activa Custom Fields y guarda. La sincronización inicial en bloque completa los valores disponibles de los perfiles de clientes que cumplan los requisitos. Los perfiles de Klaviyo se asocian por correo, así que los datos importados se sincronizan cuando está disponible el perfil con el correo correspondiente.

Cómo funciona la sincronización

  • En tiempo real: cada propiedad se actualiza mediante Klaviyo Profile Import API cuando cambian los datos, con una espera de 2 segundos para agrupar cambios.
  • Sincronización inicial en bloque: al activar Custom Fields por primera vez, se ejecuta una importación en bloque mediante Klaviyo Profile Bulk Import Jobs API, con tandas de 500 clientes. Solo se incluyen los valores disponibles de cada cliente que cumple los requisitos.

Consulta Registra eventos de Wallet en Klaviyo para enviar también eventos de JeriCommerce a Klaviyo y usarlos en activadores de flujos y analíticas.