Integration

Después de conectar Shopify en Clerk.io, esta página es tu referencia para la configuración de sincronización específica de Shopify en my.clerk.io > Data > Configuration.

Utiliza esta guía junto con Get Started y Sync Data.

Referencia de configuración #

Esta es una referencia completa para la configuración de sincronización de Shopify en my.clerk.io > Data > Configuration.

Método de sincronización #

Elige qué tipo de conector de Shopify estás utilizando. Usa Shopify para una app creada en el Dev Dashboard de Shopify. Usa Shopify (Legacy Custom App) solo para una app existente creada en el panel de administración de Shopify.

Dominio de Shopify #

El dominio actual del .myshopify.com de la tienda, por ejemplo example-store.myshopify.com. Usa este valor en lugar del dominio público personalizado. Puedes encontrarlo en Shopify > Settings > Domains.

Client ID #

Para el método de sincronización Shopify actual, utiliza el Client ID de la página Settings de la app Clerk.io en el Dev Dashboard de Shopify.

Client Secret #

Para el método de sincronización Shopify actual, utiliza el Client Secret de la misma página del Dev Dashboard de Shopify. Mantén esta clave privada y compártela solo a través de un canal seguro aprobado.

Credenciales Legacy #

Para Shopify (Legacy Custom App), utiliza la API Key, API Access Token y API Secret Key de la app personalizada existente. Consulta Legacy Custom App para los pasos de configuración legacy.

Tamaño de imagen predeterminado #

Controla qué resolución de imagen de Shopify importa Clerk.io.

Formatos comunes:

• 800x800
• 800x

Shopify genera los tamaños de imagen según demanda. Si la proporción de la imagen de origen es diferente, Shopify devuelve el tamaño más cercano posible.

Configuración de mercados #

Utiliza la siguiente configuración cuando la tienda de Shopify tenga varios mercados, idiomas, dominios o ubicaciones de inventario. Los valores deben coincidir con la configuración de Shopify antes de iniciar una nueva sincronización.

Shop Market #

Utiliza esto cuando la tienda emplea Shopify Markets. Escribe el nombre del mercado exactamente como está configurado en Shopify (por ejemplo Denmark, Europe o United States).

Los mercados pueden afectar los productos disponibles, los precios, los idiomas y el contexto del inventario.

Shop Locale #

Utiliza esto para configuraciones multi-idioma. Escribe el código de idioma estandarizado de 2 letras (por ejemplo da, sv, es).

Utiliza el código de idioma, no el de país.

Si no estás seguro de qué locale usar, pregunta a Shopify Sidekick los locales configurados en la tienda.

Prefijar URLs con el locale #

Controla si las URLs localizadas incluyen el prefijo del camino del locale.

Ejemplo:

• Sí: /da/nombre-del-producto
• No: /nombre-del-producto

Forzar URLs relativas #

Controla si Clerk.io importa URLs relativas o URLs absolutas completas.

• Sí: fuerza rutas relativas
• No: permite la URL completa con dominio

Ubicaciones de inventario #

Lista separada por comas de una o varias ubicaciones de inventario desde donde sincronizar en Shopify.

Utiliza esto cuando la disponibilidad del producto varía según almacén/ubicación.

Configuración de datos #

Utiliza las siguientes opciones para controlar qué datos de Shopify importa Clerk.io y cómo se procesan.

Atributos personalizados #

Lista separada por comas de atributos adicionales de Shopify a importar, incluyendo meta fields y otros atributos personalizados.

Incluir páginas #

Importa páginas de Shopify como objetos de página en Clerk.io, incluyendo contenidos como páginas de blog y otras páginas CMS.

Incluir todos los productos sin stock #

Si está habilitado, los productos que están completamente agotados también se importan.

Incluir productos con “Continuar vendiendo sin stock” #

Controla si se importan productos que utilizan el comportamiento de Shopify “continuar vendiendo cuando no hay stock”.

Estado de publicación de Shopify #

Controla qué estados de publicación de producto son elegibles para importar.

Uso típico:

• solo productos publicados
• todos los productos (incluyendo los no publicados)

Estado de publicación de categorías de Shopify #

Igual que el anterior, pero para el estado de publicación de la categoría.

Estado de publicación de páginas de Shopify #

Igual que el anterior, pero para el estado de publicación de la página.

Hora de sincronización #

Establece la ventana de programación para la próxima ejecución de sincronización (UTC).

Habilitar actualizaciones en tiempo real #

Si está activado, Clerk.io recibe actualizaciones de Shopify a medida que ocurren cambios (por ejemplo, de stock o precio), en lugar de esperar al siguiente ciclo de sincronización completo.

Importar solo datos de variantes en stock #

Controla si los atributos relacionados con variantes deben incluir solo variantes en stock.

Ejemplo de salida de variantes:

• variant_names: ["Xs", "M"]
• variant_option_size: ["Xs", "M"]
• variant_stocks: [1, 7]
• variants: ["55970989179259", "55970989244795"]

Cuando la opción está en Sí, las listas de variantes solo incluyen variantes en stock.

Separar opciones de variantes #

Divide las opciones de variantes en atributos separados para que cada opción pueda utilizarse independientemente en filtros y diseños.

Historial de pedidos #

Controla cuántos datos históricos de pedidos se importan por ejecución.

Los rangos disponibles incluyen:

• 1 mes
• 3 meses
• 6 meses
• 1 año
• todo el tiempo

Un enfoque común es importar todo el tiempo la primera vez y luego un periodo más corto (por ejemplo 1 mes) para las importaciones recurrentes.

Importar etiquetas #

Controla la estrategia de importación de etiquetas.

Modos disponibles:

• importar todas las etiquetas
• excluir etiquetas específicas
• incluir etiquetas específicas
• no importar etiquetas

Etiquetas específicas #

Etiquetas separadas por comas usadas cuando Import Tags está configurado para incluir/excluir etiquetas específicas.

Separador de etiquetas desestructuradas #

Carácter utilizado para dividir el nombre y el valor de la etiqueta al desestructurarla.

Ejemplo:

• Etiqueta: sale_10
• Separador: _

Prefijo de etiquetas desestructuradas #

Prefijo eliminado de las etiquetas desestructuradas antes de almacenar el valor.

Usar sale_10 con el separador _ y el prefijo sale permite usar 10 como valor.

Incluir estado de suscriptor #

Importa el estado de suscripción de los clientes (estado de newsletter/suscripción) cuando está disponible en Shopify.

Importar paquetes y estados de pedido #

Importa información de paquetes/seguimiento y valores de estado del pedido desde Shopify.

Estos datos son utilizados por Chat para responder preguntas sobre envíos y estado de pedidos.

Desinstalación #

A continuación, encontrarás una guía para eliminar los scripts de seguimiento y pasos generales para desinstalar Clerk.io de tu tienda de Shopify.

Eliminando scripts de seguimiento #

Para eliminar el seguimiento de Clerk.io de tu tienda, deberás eliminar tanto los scripts de seguimiento de visitantes como los de ventas de tus archivos de tema de Shopify y de la sección “Additional Scripts”.

• Primero, elimina los scripts de seguimiento de visitantes del archivo de tema donde inicialmente insertaste el código durante la configuración.

El seguimiento de visitantes probablemente se encuentre en el archivo “theme.liquid” o “index.liquid” de la tienda.

Puedes acceder a este archivo iniciando sesión en el portal de administración de Shopify, selecciona “Tienda online” > “Temas”. Luego, bajo “Tema en vivo”, elige “Editar código” en el menú desplegable “Acciones”.

Ubica tu archivo principal de tema, luego encuentra el script de seguimiento de visitantes y elimínalo:

• Luego, deberás eliminar ambos scripts de la sección “Additional Scripts”.

Puedes encontrar esto en tu portal de administración de Shopify haciendo clic en “Settings” en la esquina inferior izquierda. Luego, simplemente elimina ambos scripts del cuadro de texto “Additional Scripts”.

Actualizando permisos de la app privada #

También puedes cambiar los permisos de la app privada de Clerk.io que creaste durante la configuración para asegurar que no haya acceso a los campos de datos especificados.

Puedes encontrar los permisos de la API de tu app iniciando sesión en el portal de administración de Shopify, seleccionando “Apps” > “Manage Private Apps” > “Clerk.io”.

En “Admin API Permissions”, ajusta cada uno de estos menús desplegables donde actualmente dice “Read Access” a “No Access”:

Actualizando my.clerk.io #

También puedes eliminar la Shopify API Key, la contraseña y el secret del backend de tu tienda en my.clerk.io.

Inicia sesión, elige “Data” en el menú lateral izquierdo y ve a “Configuration”. Asegúrate de hacer clic en “Save” al finalizar: