Shopify: Solución de problemas de autenticación

Esta guía de solución de problemas explica cómo completar la conexión de Shopify con Dataslayer cuando la sección Distribution no está disponible o aparece un Internal Server Error durante la autenticación.

Sigue los pasos que se indican a continuación para configurar correctamente la aplicación y establecer una conexión estable.

Issue 1: ¿No aparece la sección Método de distribución (Distribution)?

Si no encuentras la opción Método de distribución en el Dev Dashboard de Shopify, sigue este proceso de configuración alternativo:

Paso 1: Accede al DEV Dashboard de Shopify.

1. Ve a https://accounts.shopify.com/store-login y procede con tu inicio de sesión.
2. En el menú de navegación, localiza y haz clic en la sección App and sales channel settings. Luego, haz clic en el botón Develop App. 
   
   
3.  Una vez en la sección App Development, haz clic en el botón Build Apps in Dev Dashboard. 
   
   

Paso 2: Crear una nueva aplicación

Por defecto, verás una lista de tus aplicaciones actuales. Para crear una nueva, haz clic en Crear aplicación .

Paso 3: Definir el nombre de la aplicación

Introduce un nombre para tu aplicación. Este nombre es interno y puede ser cualquier cosa que te ayude a identificar la integración.

Paso 4: Crea una nueva versión de la aplicación para solicitar permisos.

1.  De regreso al DEV Dashboard, ve a Versions en el menú de la izquierda y luego haga clic en Create a version para la aplicación. 
   
   
2. Copia la URL que se detalla a continuación y pégala en la casilla de URLs:
   
   - https://query-manager.dataslayer.ai/shopify/init
   
   
   
   Asegúrate de que la opción "Embed app in Shopify Admin " NO esté habilitada:
   
   
   
   
3. Baja un poco hasta encontrar la casilla de Redirect URLs y pega las siguientes 2 URLs:
   
   https://query-manager.dataslayer.ai/shopify/init, https://query-manager.dataslayer.ai/shopify/save_token_subscriptions 
   
   
   
   
4. Ahora, necesitaremos solicitar acceso a todos los pedidos. La mayoría de los clientes requieren al menos un año de datos históricos, por lo que este paso es muy recomendable.
   
   Si no aparece el botón Request Access, es posible que ya tenga acceso al permiso de read_all_orders. Puedes pasar directamente al paso 5.
   
   1. Dirígete a la sección Acceso y haz clic en “Solicitar acceso” en la descripción.
      
      
   2. En la siguiente página, en la sección " Leer todos los pedidos" , haga clic en el botón "Solicitar acceso" .
      
      
   3. Se le pedirá que proporcione una justificación. Por ejemplo: "60 días no son útiles para el análisis".
   4. Una vez enviada, el estado de la solicitud debería mostrar un mensaje como: Tu aplicación puede acceder al historial completo de pedidos de una tienda .

Paso 5: Configurar permisos (scopes)

1. Ahora, de vuelta en la página actualizada del Panel de control para desarrolladores, puede definir los ámbitos necesarios navegando a la sección Access y haciendo clic en  Select Scopes.
   
   
   
   Estos son los permisos necesarios para el análisis completo y la extracción de datos:
   1. read_analytics
   2. read_customers
   3. read_fulfillments
   4. read_inventory
   5. read_orders
   6. read_products (Necesario para recuperar información del producto)
   7. read_all_orders (Solo visible después de solicitar acceso en el paso anterior)
   8. read_marketing_events (Obligatorio para la categoría Eventos de Marketing)
2. Una vez seleccionados todos los permisos mencionados, haga clic en Listo.
   
   
   
   

Paso 6: Publicar la versión de la aplicación

Una vez configurados los permisos:

1. Haga clic en Release en la parte superior de la página.
2. En la ventana emergente que aparecerá, puede dejar los campos en blanco o proporcionar un nombre de versión. Luego, haga clic en Release.
   
   

Paso 7: Utiliza el campo Custom Install URL

Después de crear la versión de la aplicación:

• NO instales aún la aplicación de Shopify
• Ve a la sección Hub de Dataslayer, busca la fuente de datos de Shopify
  
  
  
  
• Localiza el campo Custom Install URL
  
  
  

Entonces:

1. Copia la URL de instalación de la sección Installs de tu Dev Dashboard de Shopify (usa el botón de copiar).
   
   
   
   
2. Pegalo en el campo Custom Install URL en Dataslayer
   
   
3. Completa:
   • Shop Name (solo el nombre de la tienda, sin https:// ni .myshopify.com )
   • Client ID y Client secret
     Esta información se muestra en la sección Settings del Dev Dashboard.
     
     
     
4. Haz clic en Connect
   
   
5. Serás redirigido a la página de inicio de sesión de Shopify:
   
   • Selecciona tu tienda
   • Instala la aplicación
     
     
     
     

¡Listo! Una vez instalada, la conexión aparecerá en el Hub.

Issue 2: Error interno del servidor durante la conexión

Si encuentras un Internal Server Error, verifica lo siguiente:

• App URL y Redirect URLs correctamente configuradas
  Asegúrate de que coincidan exactamente con:
  • App URL:
    https://query-manager.dataslayer.ai/shopify/init
  • Redirect URLs:
    https://query-manager.dataslayer.ai/shopify/save_toke, https://query-manager.dataslayer.ai/shopify/save_token_subscriptions

• “Embed app in Shopify Admin” NO debe estar habilitado
  Esta opción puede interferir con el flujo de autenticación
• Usar el nombre original de la tienda (importante)
  
  Usar el nombre actualizado o de visualización puede causar errores de autenticación. Esto aplica específicamente al campo Shop Name.
  
  Asegúrate de ingresar el nombre original de la tienda en Shopify, no uno renombrado o actualizado.

Esto completa la configuración de autenticación de Shopify. Siguiendo cada paso y verificando que todos los campos estén correctamente definidos, deberías poder establecer una conexión estable entre Shopify y Dataslayer.

Como siempre, no dudes en ponerte en contacto con nosotros a través del chat en vivo en nuestro sitio web o por correo electrónico si aún tienes dudas o preguntas ¡Estaremos encantados de ayudarte!