Publicar tu aplicación en Shopify App Store

La Shopify App Store alberga más de 10,000 aplicaciones que compiten por la atención de los comerciantes; sin embargo, obtener la aprobación (y el descubrimiento) de una aplicación es un proceso que hace tropezar incluso a los desarrolladores experimentados. El equipo de revisión de Shopify rechaza aproximadamente el 40% de los primeros envíos, la mayoría por razones evitables que están bien documentadas pero ampliamente ignoradas.

Esta guía proporciona el manual de presentación completo: requisitos técnicos, estándares de diseño, optimización de listados y estrategias de crecimiento que hacen que las aplicaciones pasen de cero instalaciones a ingresos recurrentes mensuales consistentes.

Conclusiones clave

• El proceso de revisión de Shopify demora entre 10 y 15 días hábiles en promedio; planifique su cronograma de lanzamiento en consecuencia
• El cumplimiento del sistema de diseño Polaris no es negociable para las secciones de aplicaciones integradas
• La calidad del listado de aplicaciones afecta directamente la conversión de los resultados de búsqueda a las instalaciones: invierta en ello
• La calidad del flujo de incorporación es un criterio de revisión: la primera experiencia debe ser intuitiva sin la ayuda del personal de Shopify.
• Requisitos de transparencia de precios: todos los cargos deben utilizar la API de Shopify Billing, no se permiten pagos fuera de la plataforma
• La documentación de cumplimiento de privacidad (GDPR, CCPA) debe ser precisa y completa
• Una calificación de revisión de 4.0+ en los primeros 6 meses es fundamental para una visibilidad sostenida de la App Store
• Los análisis del Panel de socios revelan exactamente dónde los comerciantes abandonan su embudo de instalación.

---

Requisitos previos para la configuración de la aplicación y la cuenta de socio

Antes de enviar, tu cuenta de Shopify Partner y la configuración de la aplicación deben estar completas.

Requisitos de la cuenta de socio:

1. Cuenta de Shopify Partner verificada en partners.shopify.com
2. Cuenta bancaria conectada para pagos de ingresos
3. Autenticación de dos factores habilitada
4. Se acepta el acuerdo de socio (incluido el reparto de ingresos: Shopify se queda con el 20 % de las tarifas de suscripción, el 0 % en aplicaciones gratuitas para siempre o más de 1 millón de dólares de ingresos anuales según la reestructuración del reparto de ingresos)

Configuración de la aplicación en el Panel de socios:

Vaya a Aplicaciones > Crear aplicación. Configurar:

• Nombre de la aplicación: único, descriptivo, sin "Shopify" en el nombre (política de marcas comerciales)
• URL de la aplicación: la URL de tu aplicación de producción (debe usar HTTPS)
• URL de redireccionamiento permitidas: incluya todas las URL de devolución de llamada utilizadas en su flujo de OAuth
• Ámbitos: solicite solo los alcances mínimos necesarios; las solicitudes excesivas de alcance provocan el rechazo de la revisión
• Proxy de aplicación (si corresponde): configure la ruta URL y la URL de destino

Webhooks de cumplimiento del RGPD (obligatorios para todas las aplicaciones):

# shopify.app.toml
[[webhooks.subscriptions]]
topics = ["customers/data_request"]
uri = "/webhooks/gdpr/customers-data-request"

[[webhooks.subscriptions]]
topics = ["customers/redact"]
uri = "/webhooks/gdpr/customers-redact"

[[webhooks.subscriptions]]
topics = ["shop/redact"]
uri = "/webhooks/gdpr/shop-redact"

Estos tres puntos finales deben devolver 200 en 5 segundos y realmente procesar las solicitudes de eliminación/exportación de datos. El equipo de revisión prueba estos puntos finales. Devolver 200 sin implementar la funcionalidad provoca la eliminación posterior a la aprobación.

---

Requisitos de revisión técnica

El equipo de revisión de Shopify realiza comprobaciones técnicas manuales y automatizadas. Pase todos estos antes de enviarlos.

Autenticación y seguridad:

Requisitos de uso de API:

• Nunca utilices versiones de API obsoletas; utiliza siempre una versión de los últimos 12 meses.
• Manejar la tasa de API que limita con elegancia (las respuestas 429 deben activar un reintento, no mostrar errores a los comerciantes)
• Nunca realice llamadas API en nombre de comerciantes después de la desinstalación
• Limpiar todos los datos del comerciante dentro de las 48 horas posteriores a la recepción de un webhook shop/redact

Parámetros de rendimiento de la aplicación:

• Carga inicial de la aplicación integrada: menos de 3 segundos en hardware comercial promedio
• No hay errores de JavaScript en la consola del navegador durante el uso normal
• Todas las páginas se muestran correctamente en Chrome, Firefox, Safari y Edge.
• Responsiva móvil si su aplicación tiene componentes orientados al cliente

Revisión del flujo de incorporación:

El equipo de revisión instala su aplicación y evalúa la experiencia de primera ejecución sin documentación. Su incorporación debe:

1. Explique claramente qué hace la aplicación en la primera pantalla.
2. Guíe a los nuevos usuarios a través de los pasos de configuración necesarios.
3. No es necesario contactar al soporte para completar la configuración inicial.
4. Utilice los componentes Polaris CalloutCard o Banner para las indicaciones de incorporación

---

Estándares de diseño y UX

Los requisitos de diseño de Shopify se aplican estrictamente porque la coherencia de la experiencia del comerciante en todo el administrador es un valor central de la plataforma.

Uso obligatorio de Polaris:

Todos los elementos de la interfaz de usuario dentro de la aplicación integrada (representados dentro del iframe del administrador de Shopify) deben usar componentes Polaris. Prohibido específicamente:

• Componentes de botones personalizados que no coinciden con los estilos Polaris Button
• Entradas de formulario personalizadas que no coinciden con los estilos Polaris TextField, Select, Checkbox
• Esquemas de colores personalizados que se desvían de los tokens de diseño Polaris
• Estados de carga personalizados que no utilizan Polaris Spinner o SkeletonPage

Navegación mediante puente de aplicaciones:

Las aplicaciones integradas deben utilizar App Bridge para las acciones de navegación. El uso de etiquetas window.location.href o <a> para la navegación dentro del contexto incrustado rompe la experiencia del comerciante. Uso:

import { useNavigate } from "@remix-run/react";

// For in-app navigation
const navigate = useNavigate();
navigate("/app/settings");

// For external links (opens in new tab, respecting embedded context)
import { useAppBridge } from "@shopify/app-bridge-react";
const app = useAppBridge();
// Use Redirect action for external URLs

Estados de error:

El equipo de revisión prueba específicamente las condiciones de error. Cada formulario debe manejar:

• Errores de red (muestra Banner con mensaje de error, no una página en blanco)
• Errores de validación (en línea, al lado del campo correspondiente)
• Estados vacíos (use el componente Polaris EmptyState con una acción)
• Estados de carga (use SkeletonPage para cargas iniciales, Spinner para acciones)

Requisitos de accesibilidad:

• Todas las imágenes deben tener texto alternativo descriptivo.
• Los elementos interactivos deben poder navegarse mediante el teclado.
• El contraste de color debe cumplir con los estándares WCAG AA (manejados por Polaris si se usan correctamente)
• Etiquetas de lector de pantalla en todos los botones de solo íconos

---

Optimización de listados para el descubrimiento de App Store

La lista de su aplicación es una página de ventas. Los comerciantes que encuentran su aplicación mediante búsqueda o navegación por categorías toman decisiones de instalación basadas en la calidad de su listado en cuestión de segundos.

Optimización del nombre de la aplicación:

El nombre de su aplicación aparece en los resultados de búsqueda y debe comunicar el beneficio principal. "Automatización de marketing por correo electrónico" tiene una mejor clasificación para búsquedas relevantes que "MailBooster Pro". Mantenga los nombres con menos de 30 caracteres para una visualización clara en los resultados de búsqueda.

Lema de la aplicación:

Una frase, 60 caracteres máximo. Lidera con el beneficio, no con la característica. "Recuperar un 15 % más de carritos abandonados" supera a los "correos electrónicos de recuperación automatizada de carritos".

Estructura de descripción de la aplicación:

Paragraph 1 (above the fold): Core value proposition and primary use case.
What problem does your app solve? For whom? What is the primary outcome?

Paragraph 2: Key features and how they deliver the benefit.

Paragraph 3: Social proof — merchants using the app, notable results, reviews.

Feature list (bullet points): 5-8 specific features with brief descriptions.

Paragraph 4: Integration information, compatibility notes.

Paragraph 5: Support and documentation resources.

Requisitos de captura de pantalla:

• Mínimo 3 capturas de pantalla, máximo 8
• Resolución: 1600x900 píxeles mínimo
• Muestre su aplicación en uso, no gráficos de marketing ni diagramas de funciones.
• La primera captura de pantalla es la más importante: aparece en los resultados de búsqueda.
• Anota capturas de pantalla para resaltar características clave
• Incluya un tutorial en vídeo (de 30 a 90 segundos): las aplicaciones con vídeo convierten un 40 % mejor

Selección de categorías y palabras clave:

Elija la categoría más específica que describa con precisión su aplicación. Las aplicaciones mal categorizadas se penalizan en el ranking de búsqueda. Para palabras clave: incluya sinónimos, descripciones de casos de uso y planteamientos de problemas que los comerciantes realmente buscan. No llenes tu descripción con palabras clave: el algoritmo de Shopify es sofisticado y penaliza la densidad antinatural.

---

Estrategia de página de precios

La arquitectura de precios tiene un impacto significativo en las tasas de conversión de instalación y en la tasa de abandono.

Rendimiento del modelo Freemium:

Las aplicaciones con un nivel gratuito tienen tasas de instalación entre 3 y 5 veces más altas que las aplicaciones de pago. Los niveles gratuitos crean un embudo de conversión: el comerciante realiza instalaciones gratuitas → experimenta valor → actualizaciones para funciones avanzadas. Diseñe su nivel gratuito para que sea realmente útil pero limitado de una manera que haga que la actualización sea natural (límites de uso, puertas de funciones, límites de recuento de comerciantes).

Prácticas recomendadas para la página de precios:

• Mostrar todos los planes con una tabla de comparación de características clara
• Resalte el plan recomendado (la mayoría de las aplicaciones hacen que el nivel medio sea "Popular")
• Incluya una garantía de devolución de dinero si ofrece planes pagos
• Utilice el precio mensual como visualización principal incluso si el anual está disponible
• Nunca muestre precios que difieran de los que cobra la API de facturación: el rechazo de reseñas es automático

Implementación de la API de facturación de Shopify:

Todos los cargos deben pasar por la API de facturación de Shopify. Los enlaces de pago fuera de la plataforma (Stripe, PayPal) están prohibidos para las funciones dentro de la aplicación. Es posible que tengas pagos fuera de la plataforma para servicios profesionales, pero las funciones de la aplicación deben estar protegidas detrás de los planes de API de facturación.

// billing configuration example for tiered pricing
billing: {
  "Starter": {
    amount: 9.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
    trialDays: 14,
  },
  "Professional": {
    amount: 29.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
    trialDays: 14,
  },
  "Enterprise": {
    amount: 99.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
  }
}

---

El proceso de envío de reseñas

Lista de verificación previa al envío:

• [] La aplicación se instala limpiamente en una tienda de desarrollo nueva
• [] El flujo de OAuth se completa sin errores
• [] Todos los webhooks GDPR devuelven 200 y se procesan correctamente
• [] La aplicación se desinstala limpiamente (sesión eliminada, sin datos huérfanos)
• [] El flujo de incorporación guía a los nuevos usuarios a través de la configuración sin ayuda externa
• [] Todos los componentes Polaris utilizados para la interfaz de usuario integrada
• [] La aplicación se carga en menos de 3 segundos en una conexión acelerada
• [] La URL de la política de privacidad está activa y es precisa
• [] Las capturas de pantalla de la lista de aplicaciones muestran la interfaz de usuario real de la aplicación
• [] La página de precios está completa y coincide con la configuración de la API de facturación.
• [] No hay errores de consola durante el funcionamiento normal de la aplicación
• [] Limitación de velocidad manejada con elegancia
• [] Prueba en múltiples navegadores (Chrome, Firefox, Safari, Edge)

Enviando para revisión:

En el Panel de socios, navegue hasta su aplicación > Distribución > Enviar para revisión. Proporcionar:

1. Instrucciones de prueba: pasos exactos que debe seguir el equipo de revisión para instalar y utilizar cada función
2. Credenciales de prueba: detalles de inicio de sesión para cualquier integración de terceros a la que se conecte su aplicación
3. Tutorial en vídeo (opcional pero recomendado para aplicaciones complejas): demostración de 2 a 5 minutos
4. Notas del registro de cambios (para actualizaciones): qué cambió y por qué

Después del envío:

• La revisión comienza dentro de los 3 días hábiles posteriores al envío
• Los comentarios de la revisión inicial suelen llegar dentro de 10 a 15 días hábiles.
• Si es rechazado, recibirá comentarios específicos: aborde todos los puntos antes de volver a enviar
• La cola de reenvío es más rápida (normalmente de 5 a 7 días hábiles)

---

Estrategias de crecimiento posteriores al lanzamiento

La aprobación es el primer día, no la línea de meta. El crecimiento sostenido de la App Store requiere una gestión activa.

Generación de reseñas:

Las aplicaciones con menos de 10 reseñas tienen tasas de conversión significativamente más bajas que las aplicaciones con más de 50 reseñas. Implemente una solicitud de revisión en la aplicación después de que un comerciante alcance un hito significativo (primeros 100 correos electrónicos enviados, primer carrito recuperado, primer pedido sincronizado). Utilice el flujo de solicitud de reseña nativo de Shopify:

// Trigger in-app review prompt via App Bridge
import { Modal, TitleBar } from "@shopify/app-bridge/actions";

// Display after user achieves milestone
const modal = Modal.create(app, {
  title: "Leave a review",
  url: `https://apps.shopify.com/your-app/reviews`,
});
modal.dispatch(Modal.Action.OPEN);

Cadencia de lanzamiento de funciones:

Las aplicaciones que lanzan actualizaciones con frecuencia tienen una clasificación más alta en el filtro "Nuevas y actualizadas" de Shopify y demuestran un mantenimiento activo, una señal de compra clave para los comerciantes. Intente realizar al menos una actualización significativa cada 4 a 6 semanas.

Calidad de soporte:

Los monitores Shopify admiten tiempos de respuesta y tasas de resolución. Las aplicaciones con tiempos de respuesta de soporte de más de 48 horas ven una degradación en la puntuación de las reseñas. Utilice la bandeja de entrada de soporte integrada de Shopify (accesible desde el Panel de socios) para obtener soporte de nivel 1, con derivación al correo electrónico/Slack para problemas complejos.

Optimización de la App Store (ASO):

Realice un seguimiento de la clasificación de sus palabras clave en la búsqueda de la App Store mensualmente. Utilice los análisis del Panel de socios para identificar qué términos de búsqueda generan impresiones e instalaciones. Pruebe A/B el título y el eslogan de la lista de su aplicación; incluso las pequeñas mejoras en la tasa de conversión aumentan significativamente a escala.

---

Preguntas frecuentes

¿Cuánto tiempo lleva la revisión de Shopify App Store?

Las revisiones iniciales suelen tardar entre 10 y 15 días hábiles (2 a 3 semanas). Los nuevos envíos después de abordar los comentarios de rechazo demoran entre 5 y 7 días hábiles. Las aplicaciones complejas con integraciones de terceros o alcances de permisos inusuales pueden tardar más, ya que los revisores necesitan más tiempo para verificar la funcionalidad. Planifique su cronograma de lanzamiento con un margen de 8 semanas desde el envío hasta la disponibilidad pública: 2 semanas para la primera revisión, 2 semanas para abordar los comentarios, 1 semana para la revisión del nuevo envío y 3 semanas de margen para problemas inesperados.

¿Cuáles son los motivos más comunes de rechazo del App Store?

Las cinco razones de rechazo más comunes son: (1) No se siguen los estándares de diseño de Polaris en las secciones integradas, (2) Los webhooks del RGPD no se implementaron correctamente, (3) Solicitudes excesivas de alcance de API no justificadas por la funcionalidad de la aplicación, (4) El flujo de incorporación requiere documentación externa para completarse, (5) La estructura de precios incluye opciones de pago fuera de la plataforma para funciones dentro de la aplicación. Aborde los cinco de manera proactiva antes de enviarlos para reducir significativamente la probabilidad de rechazo.

¿Puedo incluir mi aplicación como gratuita y agregar planes pagos más adelante?

Sí, y esta es una estrategia recomendada. Inicie gratis para generar un volumen de instalación inicial y revisiones, luego introduzca planes pagos una vez que tenga más de 50 comerciantes activos y una calificación de más de 4 estrellas. Utilice las capacidades de protección de la API de facturación de Shopify para permitir que los usuarios existentes conserven el acceso gratuito si lo desean. Un lanzamiento gratuito genera reseñas y pruebas sociales que mejoran significativamente las tasas de conversión cuando se activan los planes pagos.

¿Qué sucede si mi aplicación infringe las políticas después de la aprobación?

Shopify monitorea las aplicaciones publicadas para verificar el cumplimiento de las políticas. Las infracciones pueden resultar en: advertencia con fecha límite de reparación requerida, suspensión de la App Store (las instalaciones existentes continúan pero no nuevas instalaciones) o eliminación de la App Store (todas las instalaciones pierden el acceso). Las infracciones comunes posteriores a la aprobación incluyen: codificación de credenciales API descubierta a través de auditorías de seguridad, enlaces de pago fuera de la plataforma encontrados en la interfaz de usuario de la aplicación e infracciones de retención de datos (almacenamiento de datos del comerciante después de la desinstalación).

¿Qué importancia tiene la calificación de la aplicación para su visibilidad?

La calificación es uno de los factores más importantes en el algoritmo de clasificación de la App Store de Shopify. Las aplicaciones inferiores a 4.0 se suprimen significativamente en los resultados de búsqueda y en la exploración de categorías. Las aplicaciones con calificaciones de 4.7+ aparecen en secciones seleccionadas de "Mejores selecciones". Supervise activamente sus reseñas, responda a las críticas negativas de manera profesional y con soluciones, e implemente un flujo sistemático de solicitud de reseñas para mantener una calificación saludable a lo largo del tiempo.

---

Próximos pasos

Crear una aplicación que pase la revisión de Shopify y crezca hasta alcanzar un MRR sostenible requiere experiencia en los estándares técnicos de Shopify, la optimización de los listados de la App Store y la estrategia de adquisición de comerciantes.

Los servicios de desarrollo de aplicaciones Shopify de ECOSIRE cubren el recorrido completo desde la arquitectura hasta la aprobación de la App Store: desarrollo técnico, preparación de revisiones, optimización de listados y soporte de crecimiento posterior al lanzamiento. Nuestras aplicaciones tienen una tasa de aprobación del primer envío del 92 %.

Empieza a crear tu aplicación Shopify con ECOSIRE: habla con nuestro equipo de desarrollo sobre el concepto de tu aplicación.