Cuando activas Custom Fields en la integración de Shopify, JeriCommerce crea y mantiene metacampos de cliente en el espacio de nombres jericommerce.

Los encontrarás en Shopify Admin > Customers > [Customer] > Metafields. También están disponibles en Shopify Liquid, Shopify Flow y la API de Shopify.

Consulta Campos personalizados: propiedades de cliente sincronizadas para ver la lista completa de propiedades sincronizadas, su significado y cuándo se sincroniza cada una.

Claves de metacampos de Shopify

Todos los metacampos están en el espacio de nombres jericommerce. Se crean las siguientes claves para cada cliente:

Clave de metacampo
jericommerce.balance
jericommerce.birthdate
jericommerce.download-wallet-pass-url
jericommerce.tier-name
jericommerce.tier-balance
jericommerce.tier-entered-at
jericommerce.tier-expires-at

Activar Custom Fields

En JeriCommerce, ve a Settings → Integrations → Shopify, activa Custom Fields y guarda. La sincronización masiva inicial completa los valores disponibles de los perfiles de clientes existentes que cumplen los requisitos.

Cuando se importa un cliente o se vincula un perfil existente de JeriCommerce con un cliente de Shopify, JeriCommerce guarda primero los datos del perfil y después añade a la cola un trabajo en segundo plano independiente para sincronizar los campos disponibles para ese cliente. Los campos pueden aparecer cuando se ejecute ese trabajo.

La importación inicial se ejecuta en fases en segundo plano, en este orden: Users, Loyalty y Custom Fields. Si Shopify omite un campo del perfil, JeriCommerce conserva el valor existente.

Cómo funciona la sincronización con Shopify

  • En tiempo real: cada metacampo se actualiza mediante una mutación GraphQL customerUpdate de Shopify cuando cambian los datos (con una espera de 2 segundos).
  • Sincronización masiva inicial: cuando se activa Custom Fields por primera vez, una operación masiva genera un archivo JSONL y lo sube mediante Staged Uploads y la Bulk Mutation API de Shopify. Solo se incluyen los valores disponibles de cada cliente que cumple los requisitos.

Etiquetas de clientes

Además de los metacampos, JeriCommerce administra dos etiquetas de cliente para registrar el estado de instalación del Wallet Pass. Solo puede haber una etiqueta a la vez.

Etiqueta Cuándo se asigna
JericommercePassInstalled Cuando el cliente guarda el Wallet Pass en Apple Wallet o Google Wallet
JericommercePassUninstalled Cuando el cliente elimina el Wallet Pass de Apple Wallet

Estas etiquetas aparecen en la lista de etiquetas del cliente en Shopify Admin y pueden usarse en segmentos, flujos y automatizaciones de Shopify.

Relacionado: Shopify Flows and Events, donde se explica cómo usar eventos de JeriCommerce como activadores en Shopify Flow.