Tutorial: de cero a buscando con Mibizum
Una guía guiada para dejar el buscador funcionando en una tienda Shopify, de principio a fin. Si solo quieres la referencia de cada campo, ve a Configuración.
Antes de empezar
Necesitas:
- Una tienda Shopify con un tema de Online Store 2.0.
- Una cuenta de Mibizum con un catálogo (origen de datos) y sus dos claves de API: la privada (indexación) y la pública (búsqueda).
Paso 1. Instalar la app
Instala Mibizum Search desde el App Store (ver Instalación). Al abrirse dentro del admin de Shopify arranca el asistente de configuración.
Hasta aquí no ha cambiado nada en tu escaparate: la app está instalada pero inerte.
Paso 2. Conectar (con el asistente)
El asistente te lleva por los pasos en orden. En Conectar Mibizum:
- Pega tu clave de indexación (privada) y tu clave de búsqueda (pública) desde el panel de Mibizum (tu catálogo → API keys).
- Opcionalmente, indica el slug del origen de datos (por ejemplo
products). Vacío = el primer catálogo de tu cuenta. - Pulsa Conectar.
La clave de indexación se guarda cifrada en el servidor y nunca llega al navegador. ¿No tienes claves todavía? El asistente incluye un enlace para abrir el panel de Mibizum.
Paso 3. Indexar el catálogo
En el paso Sincronizar tu catálogo pulsa Iniciar sincronización. La app exporta tu catálogo completo en segundo plano (con la API de operaciones masivas de Shopify) y lo publica en Mibizum. Puedes seguir trabajando mientras se ejecuta; a partir de ahí, los cambios se sincronizan solos por webhooks.
Para ver el progreso, ve a Indexación en el menú de la app: verás el estado y el número de documentos en el índice.
Paso 4. Activar el widget
En el paso Activar el widget del escaparate:
- Abre el editor de temas de tu tienda.
- Ve a Insertados de apps (App embeds) y activa Mibizum Search.
- Vuelve a la app y confirma con He activado el widget.
A partir de ahí aparece el buscador instantáneo sobre la caja de búsqueda de tu tema, con la clave pública (la privada nunca llega al navegador).
Paso 5. Probar la búsqueda
Busca un producto en tu escaparate. El buscador instantáneo muestra resultados de Mibizum según escribes. Si algo fallara en el motor, tu tienda sigue funcionando con la búsqueda nativa del tema: nunca un error.
Paso 6. Etiquetas (opcional)
En Badges activa las del sistema (Agotado, Últimas unidades, Oferta, Nuevo, Destacado) y, si quieres, crea badges por colección o por atributo (etiqueta o metacampo). Al guardar se reindexa para que las etiquetas viajen en los documentos. Ver Badges.
Si algo no va
Ve a Mantenimiento o al FAQ.