Cómo Localizar tu Tienda Shopify con IntlPull: La Guía Completa (2026)

Por Qué Tu Tienda Shopify Necesita Localización

El 76% de los compradores en línea prefieren comprar en su idioma nativo. El 40% nunca comprará en un sitio que no esté en su idioma.

Shopify impulsa más de 4.6 millones de tiendas en todo el mundo, pero la mayoría vende solo en inglés. Esa es una oportunidad masiva desperdiciada.

Esto es lo que la localización hace con tus métricas:

Ejemplo real: Una marca de moda que vendía en EE.UU. se expandió a Alemania y Francia usando IntlPull. En 3 meses: +312% en ingresos internacionales, +89% en tráfico orgánico de mercados no anglófonos.

Esta guía te guía a través de cada paso para localizar tu tienda Shopify con IntlPull, desde la instalación hasta tu primera venta multilingüe.

---

El Problema con las Herramientas de Traducción Integradas de Shopify

Shopify ofrece Translate & Adapt, una aplicación gratuita de primera mano. Funciona para casos básicos, pero los comerciantes constantemente enfrentan estos límites:

Lo Que Translate & Adapt Puede Hacer

• Auto-traducir hasta 2 idiomas (100M caracteres/año)
• Traducir títulos de productos, descripciones, colecciones y páginas
• Adaptar contenido para mercados regionales (ej. inglés EE.UU. vs Reino Unido)

Lo Que No Puede Hacer

La brecha es clara: Shopify maneja bien la moneda y los mercados, pero la capa de traducción necesita una herramienta profesional.

---

Cómo IntlPull Resuelve la Localización de Shopify

IntlPull es un Sistema de Gestión de Traducciones (TMS) diseñado específicamente para desarrolladores y equipos modernos de ecommerce. La integración con Shopify proporciona:

Capacidades Principales

┌─────────────────────────────────────────────────┐
│                  IntlPull TMS                    │
│                                                  │
│  ┌──────────┐  ┌───────────┐  ┌──────────────┐  │
│  │ Motor IA │  │ Flujos de │  │ Memoria de   │  │
│  │ Traduc.  │  │ Revisión  │  │ Traducción   │  │
│  └────┬─────┘  └─────┬─────┘  └──────┬───────┘  │
│       │              │               │           │
│  ┌────┴──────────────┴───────────────┴────┐      │
│  │    Motor de Sincronización Bidireccional│      │
│  └────┬────────────────────────────┬──────┘      │
│       │                            │             │
│  ┌────▼─────────┐   ┌─────────────▼──────┐      │
│  │Locales Tema  │   │ Contenido Dinámico │      │
│  │Archivos JSON │   │ Productos/Pags/etc │      │
│  └────┬─────────┘   └─────────────┬──────┘      │
└───────┼────────────────────────────┼─────────────┘
        │                            │
   ┌────▼────────────────────────────▼────┐
   │       Tu Tienda Shopify              │
   │  Temas · Productos · Colecciones     │
   │  Páginas · Navegación · Metafields   │
   └──────────────────────────────────────┘

Lo que hace diferente a IntlPull:

1. Sincronización bidireccional — Extrae traducciones de Shopify a IntlPull, o envía de IntlPull a Shopify. O ambas.
2. Archivos de locales de tema — Sincroniza los archivos .json reales que impulsan la interfaz de tu tienda (botones, etiquetas, navegación, mensajes de error).
3. Contenido dinámico — Traduce productos, colecciones, páginas y artículos a través de la API Translate & Adapt de Shopify.
4. Más de 37 idiomas — Traducción IA con múltiples proveedores (Google, DeepL, OpenAI, Gemini) — no limitado a 2.
5. Memoria de traducción — Nunca pagues por traducir la misma frase dos veces.
6. Flujos de revisión — Prepara, revisa, aprueba traducciones antes de que se publiquen.
7. Auto-sincronización — Activada por webhooks. Cuando el contenido cambia en Shopify, IntlPull sincroniza automáticamente.
8. Selector de idioma — Extensión de tema lista para usar con 4 estilos de visualización.

---

Paso 1: Instalar la Aplicación IntlPull para Shopify

Desde la Tienda de Aplicaciones de Shopify

1. Ve a la Tienda de Aplicaciones de Shopify y busca "IntlPull"
2. Haz clic en Agregar aplicación
3. Revisa los permisos y haz clic en Instalar

Permisos Requeridos

Nota de seguridad: IntlPull nunca almacena tu token de acceso de Shopify en texto plano. Todos los tokens están cifrados en reposo.

---

Paso 2: Conectar Tu Proyecto IntlPull

Después de la instalación, verás la página de Configuración dentro de tu Admin de Shopify.

Crear o Vincular un Proyecto

1. Inicia sesión en IntlPull (o crea una cuenta)
2. Crea un nuevo proyecto o selecciona uno existente
3. Copia tu clave API del proyecto (comienza con ip_live_...)
4. Pégala en la pantalla de configuración de la app de Shopify
5. Haz clic en "Conectar"

Configurar Idioma de Origen

Establece el idioma de origen de tu tienda (generalmente en para inglés). Esto le indica a IntlPull cuál idioma es tu "base" — todas las traducciones se derivan de él.

Elegir Dirección de Sincronización

Recomendado: Comienza con Pull para importar tus traducciones existentes, revísalas en IntlPull, luego cambia a Bidireccional para gestión continua.

---

Paso 3: Agregar Idiomas a Tu Tienda

Habilitar Idiomas en Shopify

Antes de que IntlPull pueda sincronizar traducciones, los idiomas deben estar habilitados en Shopify:

1. Ve a Configuración → Idiomas en tu Admin de Shopify
2. Haz clic en Agregar idioma
3. Selecciona los idiomas que deseas (ej. español, francés, alemán, japonés)
4. Haz clic en Guardar

O Agregar Idiomas a través de IntlPull

IntlPull puede agregar idiomas a tu tienda Shopify automáticamente:

TypeScriptCopy
1// Usando la API de IntlPull
2POST /api/v1/projects/{projectId}/language-settings/bulk
3{
4  "languages": [
5    { "language_code": "es", "language_name": "Spanish" },
6    { "language_code": "fr", "language_name": "French" },
7    { "language_code": "de", "language_name": "German" },
8    { "language_code": "ja", "language_name": "Japanese" }
9  ],
10  "auto_translate": true
11}

Soporte de Idiomas

IntlPull soporta más de 37 idiomas con traducción IA de alta calidad:

---

Paso 4: Sincronizar Archivos de Locales de Tema

Aquí es donde IntlPull brilla sobre otras herramientas de traducción de Shopify.

¿Qué Son los Archivos de Locales de Tema?

Cada tema de Shopify tiene un directorio /locales que contiene archivos JSON que impulsan la interfaz de la tienda:

themes/
└── tu-tema/
    └── locales/
        ├── en.default.json      ← Idioma de origen
        ├── es.json              ← Traducciones al español
        ├── fr.json              ← Traducciones al francés
        ├── de.json              ← Traducciones al alemán
        └── ja.json              ← Traducciones al japonés

Estructura de un Archivo de Locale

JSONCopy
1{
2  "general": {
3    "accessibility": {
4      "skip_to_content": "Saltar al contenido",
5      "close": "Cerrar"
6    },
7    "search": {
8      "placeholder": "Buscar en nuestra tienda",
9      "submit": "Buscar",
10      "no_results": "No hay resultados para \"{{ terms }}\""
11    }
12  },
13  "products": {
14    "product": {
15      "add_to_cart": "Añadir al carrito",
16      "sold_out": "Agotado",
17      "quantity": "Cantidad",
18      "size_guide": "Guía de tallas"
19    }
20  },
21  "cart": {
22    "general": {
23      "title": "Tu carrito",
24      "empty": "Tu carrito está vacío",
25      "continue_shopping": "Continuar comprando",
26      "checkout": "Finalizar compra"
27    }
28  }
29}

Estas son las cadenas que tus clientes realmente ven — "Añadir al carrito", "Finalizar compra", "Tu carrito está vacío". Si estas no están traducidas, tu tienda se ve medio localizada.

Sincronizar con IntlPull

1. En la configuración de la app de Shopify, habilita "Sincronizar Locales de Tema"
2. IntlPull extraerá todos los archivos de locales de tu tema activo
3. Cada clave JSON se convierte en una clave de traducción en tu proyecto IntlPull:

Namespace: theme.general.search
Key: placeholder
Value (en): "Search our store"
Value (es): "Buscar en nuestra tienda"
Value (fr): "Rechercher dans notre boutique"
Value (de): "In unserem Shop suchen"

4. Edita traducciones en el editor de IntlPull con contexto completo
5. Envía de vuelta a Shopify con un clic

Manejo de Actualizaciones de Tema

Cuando los temas de Shopify se actualizan, pueden aparecer nuevas claves de locale. IntlPull maneja esto automáticamente:

• Nuevas claves se detectan y marcan como "sin traducir"
• Claves eliminadas se preservan en IntlPull (eliminación suave)
• Valores de origen cambiados activan alertas de re-traducción
• Auto-traducir puede llenar nuevas claves instantáneamente usando IA

---

Paso 5: Traducir Contenido Dinámico

El contenido dinámico incluye todo lo que no está en archivos de tema:

Tipos de Contenido

Cómo IntlPull Sincroniza Contenido Dinámico

1. IntlPull llama a la API GraphQL de Shopify (v2026-01)
2. Obtiene todos los recursos traducibles con paginación
3. Crea claves de traducción de IntlPull mapeadas a GIDs de recursos de Shopify
4. Traduces en IntlPull (IA, manual o profesional)
5. IntlPull envía traducciones de vuelta via mutación registerTranslations

Ejemplo: Traducir un Producto

Origen (Inglés):

JSONCopy
1{
2  "title": "Men's Running Shoes - Lightweight Sneakers",
3  "description": "Breathable mesh upper with cushioned EVA midsole...",
4  "seo_title": "Buy Men's Running Shoes | Free Shipping",
5  "seo_description": "Lightweight running shoes for men..."
6}

Después de traducción con IntlPull al alemán:

JSONCopy
1{
2  "title": "Herren Laufschuhe - Leichte Sportschuhe",
3  "description": "Atmungsaktives Mesh-Obermaterial mit gedämpfter EVA-Mittelsohle...",
4  "seo_title": "Herren Laufschuhe kaufen | Kostenloser Versand",
5  "seo_description": "Leichte Laufschuhe für Herren..."
6}

Consejo SEO: IntlPull te permite personalizar títulos y descripciones SEO por idioma. No solo traduzcas — optimiza para términos de búsqueda locales. Los alemanes buscan "Laufschuhe kaufen", no "running shoes buy".

Organización de Namespaces

IntlPull organiza el contenido de Shopify con namespaces claros:

shopify.theme.general.*       → Cadenas UI del tema
shopify.theme.products.*      → Cadenas del tema relacionadas con productos
shopify.theme.cart.*          → Cadenas del tema relacionadas con carrito
shopify.products.{gid}.*     → Contenido de producto individual
shopify.collections.{gid}.*  → Contenido de colección individual
shopify.pages.{gid}.*        → Contenido de página individual

Esto facilita filtrar, buscar y gestionar traducciones a escala.

---

Paso 6: Configurar el Selector de Idioma

IntlPull incluye una Extensión de Aplicación de Tema que agrega un selector de idioma profesional a tu tienda.

Instalación

1. Abre el Editor de Temas de Shopify
2. Hay dos opciones de colocación:

Opción A: Bloque de Aplicación (Colocación en Tema)

1. Navega a tu sección de encabezado o pie de página
2. Haz clic en "Agregar bloque"
3. Selecciona "Selector de Idioma" bajo la app IntlPull
4. Configura estilo, posición y colores

Opción B: Embed Flotante (Siempre Visible)

1. Haz clic en "App embeds" en la barra lateral del Editor de Temas
2. Habilita "Selector de Idioma (Flotante)"
3. Elige posición (abajo-izquierda, abajo-derecha, arriba-izquierda, arriba-derecha)

Estilos de Visualización

Opciones de Personalización

- Color de fondo
- Color de texto
- Color de resaltado de idioma activo
- Radio de borde
- Tamaño de fuente
- Mostrar/ocultar nombres de idiomas
- Mostrar/ocultar iconos de banderas
- Dirección del dropdown (arriba/abajo)

Nota de rendimiento: El selector de idioma es una Extensión de Aplicación de Tema de Shopify — se carga asincrónicamente, agrega cero JavaScript a tu carga de página inicial, y no requiere llamadas API externas desde la tienda.

---

Paso 7: Habilitar Auto-Sincronización

Configúralo y olvídalo. IntlPull puede sincronizar traducciones automáticamente cuando el contenido cambia.

Cómo Funciona la Auto-Sincronización

Tienda Shopify                  IntlPull
    │                               │
    │  Cambio de contenido          │
    │  (nuevo producto, actualiza   │
    │   de tema)                    │
    │                               │
    ├──── Webhook ─────────────────►│
    │     (verificado HMAC-SHA256)  │
    │                               │
    │                          ┌────┤
    │                          │ Detectar cambios
    │                          │ Auto-traducir nuevas claves
    │                          │ Marcar texto origen cambiado
    │                          └────┤
    │                               │
    │◄───── Enviar traducciones ────┤
    │                               │

Eventos de Webhook

IntlPull escucha estos eventos de webhook de Shopify:

Habilitar Auto-Sincronización

1. En la app de Shopify de IntlPull, ve a Configuración
2. Activa "Auto-Sincronización"
3. Elige alcance de sincronización:
   • Solo locales de tema — más rápido, menos intensivo en recursos
   • Solo contenido dinámico — productos, colecciones, páginas
   • Sincronización completa — todo

Consejo: Comienza con "Solo locales de tema" para auto-sincronización, y activa manualmente sincronizaciones de contenido completo según sea necesario. Esto mantiene tu procesamiento de webhooks rápido y evita llamadas API innecesarias.

---

Paso 8: Mejores Prácticas de Flujo de Trabajo de Traducción

El Enfoque Híbrido (Recomendado)

No todo el contenido necesita la misma calidad de traducción:

Usar Memoria de Traducción

La memoria de traducción de IntlPull guarda cada traducción aprobada. Beneficios:

• "Añadir al carrito" traducido una vez → reutilizado en todos los productos automáticamente
• Terminología consistente → "Checkout" siempre se traduce de la misma manera
• Ahorro de costos → las frases repetidas no consumen créditos de traducción IA
• Aplicación de glosario → los términos de marca permanecen consistentes

Flujo de Revisión

1. Nueva clave detectada (auto o manual)
      │
      ▼
2. Auto-traducción IA (estado borrador)
      │
      ▼
3. Revisor edita en editor de IntlPull
   (con contexto, capturas, glosario)
      │
      ▼
4. Aprobado → enviado a Shopify
      │
      ▼
5. Memoria de traducción actualizada

Operaciones Masivas

Para tiendas con miles de productos:

TypeScriptCopy
1// Importar traducciones existentes desde CSV
2POST /api/v1/projects/{projectId}/import
3{
4  "format": "csv",
5  "language": "es",
6  "strategy": "merge"  // No sobrescribir traducciones existentes
7}
8
9// Exportar para traductores profesionales
10POST /api/v1/projects/{projectId}/export
11{
12  "format": "xliff",   // Formato estándar de la industria
13  "languages": ["de", "fr", "ja"],
14  "status": "untranslated"  // Solo exportar lo que falta
15}

---

Paso 9: SEO Multilingüe para Shopify

La localización sin SEO es una oportunidad perdida. Así es como maximizar el tráfico orgánico.

Etiquetas Hreflang

Shopify Markets genera automáticamente etiquetas hreflang para tus idiomas habilitados:

HTMLCopy
1<link rel="alternate" hreflang="en" href="https://tutienda.com/" />
2<link rel="alternate" hreflang="es" href="https://tutienda.com/es/" />
3<link rel="alternate" hreflang="fr" href="https://tutienda.com/fr/" />
4<link rel="alternate" hreflang="de" href="https://tutienda.com/de/" />
5<link rel="alternate" hreflang="x-default" href="https://tutienda.com/" />

Estructura de URL

Shopify usa el enfoque de subdirectorio por defecto:

tutienda.com/           → Español (predeterminado)
tutienda.com/en/        → Inglés
tutienda.com/fr/        → Francés
tutienda.com/de/        → Alemán
tutienda.com/ja/        → Japonés

Este es en realidad el enfoque recomendado para la mayoría de las tiendas — consolida la autoridad del dominio y es más fácil de gestionar.

Lista de Verificación SEO para Cada Idioma

Investigación de Palabras Clave Locales

No traduzcas palabras clave — investígalas:

Inglés: "running shoes"         → 110,000 búsquedas mensuales
Alemán:  "Laufschuhe"            → 74,000 búsquedas mensuales
         "Laufschuhe kaufen"     → 12,000 búsquedas mensuales (¡alta intención!)
         "Joggingschuhe"         → 8,100 búsquedas mensuales

Francés:  "chaussures de course"  → 33,000 búsquedas mensuales
         "chaussures running"    → 27,000 búsquedas mensuales

La traducción IA de IntlPull preserva el contexto, pero siempre revisa el contenido crítico para SEO con conocimiento del mercado local.

---

Paso 10: Monitorear y Optimizar

Métricas del Dashboard de IntlPull

Después de conectar, monitorea esto en tu proyecto IntlPull:

Integración con Analytics de Shopify

Cruza referencias de cobertura de traducción con analytics de Shopify:

• Tasa de conversión por idioma — ¿Está funcionando tu traducción al alemán?
• Tasa de rebote por mercado — ¿Rebote alto en páginas francesas? Verifica calidad de traducción
• Ingresos por mercado — Rastrea ROI por mercado localizado
• Abandono de carrito por idioma — Checkout sin traducir = ventas perdidas

Problemas Comunes y Soluciones

---

Avanzado: Usando el CLI de IntlPull

Para desarrolladores que prefieren la línea de comandos:

Instalación

TerminalCopy
npm install -g @intlpull/cli

Configuración

JSONCopy
1// .intlpull.json
2{
3  "projectId": "tu-id-proyecto",
4  "framework": "shopify",
5  "sourceLanguage": "en",
6  "outputDir": "./locales",
7  "namespaces": ["theme", "products"]
8}

Comandos Comunes

TerminalCopy
1# Extraer todas las traducciones de IntlPull
2intlpull pull
3
4# Enviar cambios locales a IntlPull
5intlpull push
6
7# Verificar estado de traducción
8intlpull status
9
10# Auto-traducir claves faltantes
11intlpull translate --languages es,fr,de,ja
12
13# Exportar para traductores profesionales
14intlpull export --format xliff --languages de --status untranslated

Integración CI/CD

Agrega a tu pipeline de despliegue:

YAMLCopy
1# .github/workflows/sync-translations.yml
2name: Sync Translations
3on:
4  push:
5    branches: [main]
6    paths:
7      - 'locales/**'
8
9jobs:
10  sync:
11    runs-on: ubuntu-latest
12    steps:
13      - uses: actions/checkout@v4
14      - run: npm install -g @intlpull/cli
15      - run: intlpull push
16        env:
17          INTLPULL_API_KEY: ${{ secrets.INTLPULL_API_KEY }}

---

Precios y ROI

Precios de IntlPull para Tiendas Shopify

IntlPull ofrece planes diseñados para ecommerce:

Cálculo de ROI

Ingresos promedio tienda Shopify:         $50,000/mes (solo EE.UU.)
Potencial mercado internacional:           +60% mercado direccionable
Mejora conversión conservadora:            +13% (datos propios de Shopify)

Ingresos mensuales adicionales:           $50,000 × 0.60 × 0.13 = $3,900/mes
Costo plan Pro de IntlPull:               $49/mes

ROI: 7,857% — se paga solo el primer día.

---

Migración desde Otras Apps de Traducción

¿Ya usas Weglot, Langify o Transcy? IntlPull hace la migración sencilla:

Pasos de Migración

1. Exporta tus traducciones actuales (CSV o JSON)
2. Importa a IntlPull vía dashboard o CLI
3. Conecta la integración de Shopify
4. Envía para verificar que todas las traducciones están en su lugar
5. Elimina la app antigua

Comparación de Funciones

---

Resumen: Tu Lista de Verificación de Localización

Aquí está tu lista de verificación completa paso a paso:

• Instalar app de Shopify de IntlPull
• Conectar tu proyecto IntlPull con clave API
• Establecer dirección de sincronización (comenzar con Pull → cambiar a Bidireccional)
• Habilitar idiomas en Shopify (Configuración → Idiomas)
• Sincronizar archivos de locales de tema (cadenas UI, navegación, carrito, checkout)
• Sincronizar contenido dinámico (productos, colecciones, páginas)
• Configurar selector de idioma (dropdown, banderas, píldoras o inline)
• Habilitar auto-sincronización para actualizaciones de traducción en tiempo real
• Configurar flujo de trabajo de traducción (IA + revisión humana para contenido crítico)
• Optimizar SEO por idioma (palabras clave locales, meta descripciones)
• Monitorear tasas de conversión por mercado en Analytics de Shopify
• Configurar CLI/CI/CD para flujos de trabajo de desarrollador (opcional)

No necesitas hacer todo a la vez. Comienza con locales de tema y tus 3 idiomas objetivo principales. Agrega mercados a medida que veas resultados.

---

Preguntas Frecuentes

¿Cuánto tarda la sincronización inicial?

Para una tienda típica con 100-500 productos, la primera sincronización completa toma 2-5 minutos. La sincronización de locales de tema es casi instantánea.

¿IntlPull afecta el rendimiento de mi tienda?

No. El selector de idioma es una Extensión de Aplicación de Tema de Shopify que se carga asincrónicamente. Todo el procesamiento de traducción ocurre del lado del servidor en la infraestructura de IntlPull.

¿Puedo usar traductores profesionales con IntlPull?

Sí. Exporta contenido sin traducir como XLIFF (estándar de la industria), envía a tu agencia de traducción, importa los resultados. IntlPull soporta formatos JSON, YAML, XLIFF, PO, CSV, Android XML e iOS Strings.

¿Qué pasa si desinstalo la app?

Tus traducciones permanecen en Shopify. IntlPull limpia sus datos de integración pero no elimina ningún contenido de tu tienda.

¿IntlPull soporta Shopify Plus?

Sí. IntlPull funciona con todos los planes de Shopify — Basic, Shopify, Advanced y Plus.

¿Puedo traducir el checkout?

Shopify pre-traduce el checkout a 33 idiomas. Para extensiones de checkout personalizadas (Shopify Plus), IntlPull también puede gestionar esas traducciones.

---

Comienza a Localizar Hoy

Tus competidores ya están vendiendo en múltiples idiomas. Cada día que esperas, estás dejando ingresos internacionales sobre la mesa.

Instala IntlPull para Shopify → y comienza tu primera sincronización en menos de 5 minutos.

¿Preguntas? Contáctanos en support@intlpull.com o únete a nuestra comunidad de Discord.