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. La mayoría de las configuraciones deben usar Shopify a través del flujo Dev Dashboard.

Dominio de Shopify #

El dominio .myshopify.com de la tienda, por ejemplo example-store.myshopify.com. Puedes encontrarlo en el administrador de Shopify y en la URL de la tienda.

Shopify API Key #

La clave API de la aplicación de Shopify que creaste para Clerk.io en el Dev Dashboard de Shopify.

Shopify API Access Token #

El token de acceso de la misma aplicación de Shopify. Clerk.io lo usa para leer los datos de sincronización.

Shopify API Secret Key #

La clave secreta API de la misma aplicación de Shopify.

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 fuente difiere, Shopify devuelve el tamaño más cercano disponible.

Mercado de la tienda #

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

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

Localización de la tienda #

Utiliza esto para configuraciones multilenguaje. Ingresa el código de localización estándar de 2 letras del idioma (por ejemplo da, sv, es).

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

Si no estás seguro de qué localización usar, pregunta a Shopify Sidekick por las localizaciones configuradas en la tienda.

Prefijar URLs con localización #

Controla si las URLs localizadas incluyen el prefijo de ruta de localización.

Ejemplo:

• Sí: /da/product-name
• No: /product-name

Forzar URLs relativas #

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

• Sí: forzar rutas relativas
• No: permitir URL completa con dominio

Atributos personalizados #

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

Ubicaciones de inventario #

Lista separada por comas de una o más ubicaciones de inventario de donde sincronizar desde Shopify.

Utiliza esto cuando la disponibilidad de productos difiere por almacén/ubicación.

Incluir páginas #

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

Incluir todos los productos sin stock #

Si está habilitado, se siguen importando los productos totalmente sin stock.

Incluir productos configurados para continuar vendiendo sin stock #

Controla si se importan productos que usan el comportamiento de Shopify “continuar vendiendo cuando estén sin 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 (incluidos los no publicados)

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

Igual que lo anterior, pero para el estado de publicación de las categorías.

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

Igual que lo anterior, pero para el estado de publicación de las páginas.

Tiempo de sincronización #

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

Activar actualizaciones en tiempo real #

Si está habilitado, Clerk.io recibe actualizaciones de Shopify a medida que ocurren los cambios (por ejemplo, cambios de stock o precio), en vez de esperar al próximo ciclo de sincronización completo.

Solo importar datos de variantes en stock #

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

Ejemplo de salida de variante:

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

Cuando la configuración es Sí, las listas de variantes solo incluyen variantes en stock.

Separar opciones de variante #

Separa las opciones de variante en atributos independientes para que cada opción pueda usarse por separado en filtrado y diseño.

Historial de pedidos #

Controla cuántos datos históricos de pedidos se importan en cada 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” en la primera importación, 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 para descomponer etiquetas #

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

Ejemplo:

• Etiqueta: sale_10
• Separador: _

Prefijo para descomponer etiquetas #

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

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

Incluir estado de suscriptor #

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

Importar paquetes y estados de pedido #

Importa información de paquetes/seguimiento y estados de pedido desde Shopify.

Estos datos son usados por Chat al responder preguntas de envío y estado de pedido.

Desinstalación #

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

Eliminación de scripts de tracking #

Para eliminar el tracking de Clerk de tu tienda online, deberás eliminar tanto los scripts de Visitor Tracking como de Sales Tracking de los archivos de tema de Shopify y de la sección " Additional Scripts".

• Primero, elimina los scripts de Visitor Tracking del archivo de tema donde colocaste inicialmente el código de inserción durante la configuración.

El Visitor Tracking probablemente se encuentra en el archivo “theme.liquid”, “index.liquid” de tu tienda online.

Puedes acceder a este archivo iniciando sesión en tu portal de administración de Shopify, luego selecciona “Online Store” > “Themes”. Después, en “Live Theme”, elige “Edit Code” en el menú desplegable “Actions”.

Ubica el archivo principal del tema, busca el script de Visitor Tracking y elimínalo:

• A continuación, deberás eliminar ambos scripts de tracking de la sección " Additional Scripts".

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

Actualización de permisos de la aplicación privada #

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

Puedes encontrar los permisos API de tu aplicación iniciando sesión en tu 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 diga actualmente “Read Access” a “No Access”:

Actualización de my.clerk.io #

También puedes eliminar la Shopify API Key, password y secret del backend my.clerk.io de tu tienda.

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