Marketplace

¿Qué es el Marketplace de AdoqIA?

El Marketplace de AdoqIA es un catálogo público donde los productos de todas las tiendas participantes se muestran en un solo lugar. Los compradores pueden buscar productos, comparar precios entre tiendas y acceder directamente a la tienda del vendedor para completar su compra.

Beneficios principales:

• Tus productos son visibles para compradores que no conocen tu tienda.
• Los compradores comparan precios y eligen dónde comprar.
• La sincronización es automática: no necesitas publicar manualmente.
• Puedes destacar productos para mayor visibilidad.

🚀 Cómo activar tu participación

Paso 1: Accede al módulo

Ve a Dashboard → Marketplace desde el menú lateral.

Paso 2: Solicita activación

1. Haz clic en "Activar mi tienda en el Marketplace".
2. Se abre un formulario donde puedes agregar una descripción opcional de tu negocio.
3. Presiona "Activar participación".

Paso 3: Espera la aprobación

Tu solicitud queda en estado "Pendiente de aprobación". El equipo de AdoqIA revisa tu tienda en un plazo de 24 a 48 horas hábiles.

Mientras esperas, prepara tu tienda:

• Agrega imágenes de calidad a tus productos.
• Completa las descripciones con detalles relevantes.
• Configura tu tienda online con banner, logo y datos de contacto.

Paso 4: Mapea tus categorías

Una vez aprobada tu participación, tus productos se publican automáticamente solo si están mapeados a una categoría del marketplace.

📂 Mapeo de categorías

El marketplace tiene sus propias categorías (Tecnología, Ropa, Hogar, etc.). Para que tus productos aparezcan correctamente, debes relacionar tus categorías internas con las del marketplace.

Cómo mapear

1. Ve a Dashboard → Marketplace → Categorías.
2. Verás una tabla con tus categorías internas a la izquierda.
3. Para cada una, selecciona la categoría del marketplace correspondiente del menú desplegable.
4. Haz clic en "Guardar mapeos".

Reglas importantes

• Los productos sin categoría mapeada no aparecen en el marketplace.
• Puedes mapear varias categorías internas a la misma categoría del marketplace.
• No puedes duplicar un mapeo (una categoría interna solo puede apuntar a una del marketplace).
• Si tienes categorías sin mapear, verás un indicador de advertencia con la cantidad.

Ejemplo

| Tu categoría | Categoría del Marketplace | |---|---| | Celulares | Tecnología | | Notebooks | Tecnología | | Zapatillas | Ropa y Moda | | Sin mapear | ⚠️ No se publica |

🔄 Sincronización automática de productos

Una vez activo y con categorías mapeadas, tus productos se sincronizan automáticamente:

• Productos nuevos que crees con is_visible: true y status: active aparecen en el marketplace en menos de 2 minutos.
• Cambios de precio, stock o descripción se reflejan automáticamente.
• Productos eliminados o desactivados se retiran del marketplace.
• Si desactivas tu tienda online, todos tus listings se ocultan temporalmente.

Límites por plan

| Plan | Productos en marketplace | |------|:------------------------:| | Free | Máximo 20 (ordenados por sort_order) | | Premium | Sin límite | | Enterprise | Sin límite |

Si estás en el plan Free y tienes más de 20 productos activos, solo los primeros 20 se publican. Verás un banner indicándote esta situación con la opción de actualizar tu plan.

⭐ Listados destacados

Los listados destacados te permiten posicionar tu tienda o un producto específico en posiciones preferenciales dentro del marketplace.

Tipos de destacado

| Tipo | Qué hace | |------|----------| | Tienda destacada | Tu tienda aparece en la sección "Tiendas destacadas" de la landing | | Producto destacado | Tu producto recibe un badge de "Destacado" y mayor visibilidad en su categoría |

Cómo crear un destacado

1. Ve a Dashboard → Marketplace → Destacados.
2. Haz clic en "Nuevo destacado".
3. Selecciona:

- Tipo: Tienda o Producto. - Producto (si eligiste producto): elige de la lista de tus productos activos. - Categoría: en qué categoría del marketplace quieres destacar. - Duración: 7, 14 o 30 días.

1. Presiona enviar.

Estados de un destacado

| Estado | Significado | |--------|-------------| | 🟢 Activo | Se está mostrando en el marketplace | | 🟡 En cola | Hay demasiados destacados en esa categoría (cap 20%), se activará cuando haya espacio | | ⚪ Expirado | Ya venció su periodo de duración |

Métricas de un destacado

Para cada destacado activo puedes ver:

• Impresiones: cuántas veces se mostró.
• Clicks: cuántas veces hicieron clic.
• Visitas a tienda: cuántos compradores visitaron tu tienda desde el destacado.
• CTR (Click-Through Rate): porcentaje de clicks sobre impresiones.
• Días restantes: cuántos días le quedan activo.

Accede a las métricas haciendo clic en un destacado activo desde la lista.

🛒 Cómo se ve tu tienda para los compradores

Los compradores del marketplace pueden:

1. Ver la landing con productos populares, tiendas destacadas y categorías.
2. Buscar productos por nombre con autocompletado.
3. Filtrar por categoría, precio, stock y calificación.
4. Ver el detalle de un producto con tabla de comparación de precios entre tiendas.
5. Comprar haciendo clic en "Comprar" que los redirige a tu tienda online.
6. Ver tu perfil con logo, nombre, ubicación, rating, reseñas y cantidad de productos.

Tu perfil público muestra:

• Nombre de tu tienda
• Logo
• Ciudad y país
• Calificación promedio y número de reseñas
• Cantidad de productos activos
• Tiempo promedio de respuesta
• Fecha de ingreso al marketplace
• Badge "Tienda destacada" si tu rating es ≥ 4.5

🖼️ Preparar tu tienda para vender más

Imágenes de productos

• Usa fotos reales con buena iluminación y fondo limpio.
• Resolución mínima recomendada: 800×800 px.
• Formato: JPEG o PNG (el sistema los optimiza a WebP automáticamente).
• Los productos sin imagen muestran un ícono genérico y reciben menos clicks.

Descripciones

• Incluye características, materiales, dimensiones y peso.
• Menciona usos prácticos y para quién es el producto.
• Evita texto en mayúsculas o con muchos signos de exclamación.

Precios

• En el marketplace tus precios se muestran lado a lado con los de otras tiendas.
• Si tu precio es el más bajo, se destaca con un badge verde "Mejor precio".
• Mantén tus precios actualizados para no perder ventas por precio desactualizado.

Presentación de tu tienda online

El marketplace también muestra tu perfil de tienda. Para causar buena impresión:

1. Banner: sube un banner atractivo en Dashboard → Tienda Online (recomendado: 1920×600px).
2. Logo: configura un logo claro y profesional.
3. Colores: personaliza los colores de tu tienda para reforzar tu marca.
4. Mensaje de bienvenida: agrega un texto corto que invite a explorar.
5. Redes sociales: agrega Instagram, Facebook y especialmente WhatsApp para que los compradores puedan contactarte fácilmente.
6. Datos de contacto: asegúrate de que tu teléfono y dirección estén actualizados.

❌ Desactivar participación

Si deseas retirarte del marketplace:

1. Ve a Dashboard → Marketplace.
2. Haz clic en "Desactivar participación".
3. Confirma en el modal de advertencia.

Consecuencias:

• Todos tus productos se retiran inmediatamente del marketplace.
• Tu perfil de tienda ya no es visible.
• Puedes reactivar en cualquier momento.

🔒 Control de acceso

• Solo usuarios con rol Propietario o Administrador pueden gestionar la participación en el marketplace.
• Las opciones de marketplace aparecen en el sidebar solo si tienes una participación activa o pendiente.
• Las rutas /dashboard/marketplace/* redirigen al dashboard si no tienes permisos.

⚠️ Posibles errores y soluciones

"Ya tienes una participación activa o pendiente"

Causa: Intentaste activar pero ya tienes una solicitud en proceso. Solución: Espera la revisión de tu solicitud actual. Si fue rechazada, puedes volver a solicitar.

"Demasiadas solicitudes"

Causa: Excediste el límite de peticiones (60 por minuto). Solución: Espera unos minutos antes de intentar de nuevo.

Los productos no aparecen en el marketplace

Causas posibles:

1. Tu participación no está aprobada → verifica el estado en Dashboard → Marketplace.
2. No mapeaste categorías → ve a Dashboard → Marketplace → Categorías y mapea.
3. Los productos no tienen is_visible: true o status: active.
4. Estás en plan Free y ya tienes 20 productos publicados.
5. La sincronización tarda hasta 2 minutos después de un cambio.

Las imágenes no se muestran

Causas posibles:

1. El producto no tiene imagen cargada → sube una desde Dashboard → Productos.
2. La URL de la imagen no es válida (error del CDN) → vuelve a subir la imagen.

"No se pudo cargar" o "Error inesperado"

Causa: Problema temporal de conexión con el servidor. Solución: Espera unos segundos y usa el botón "Reintentar".

El botón "Comprar" no lleva al producto correcto

Causa: El slug del producto cambió después de la sincronización. Solución: Edita el producto en tu tienda y guarda para forzar una resincronización.

📊 Estados de participación

| Estado | Significado | Qué puedes hacer | |--------|-------------|-----------------| | No registrado | No tienes participación | Solicitar activación | | Pendiente | En revisión por el equipo | Preparar tu tienda mientras esperas | | Activo | Tus productos están publicados | Gestionar categorías, destacados, métricas | | Suspendido | Tu participación fue suspendida | Contactar soporte para resolver | | Rechazado | Tu solicitud fue rechazada | Corregir los motivos y volver a solicitar | | Inactivo | Desactivaste tu participación | Reactivar cuando quieras |

❓ Preguntas frecuentes

¿Tiene costo participar en el marketplace?

No. La participación básica es gratuita. El plan Free permite hasta 20 productos. Los listados destacados tienen un costo según la duración elegida.

¿Los compradores compran en mi tienda o en el marketplace?

En tu tienda. El marketplace es un catálogo comparativo — cuando el comprador hace clic en "Comprar", se redirige a tu tienda online donde completa el pedido normalmente.

¿Puedo elegir qué productos aparecen en el marketplace?

Todos los productos activos y visibles se sincronizan automáticamente (hasta el límite de tu plan). Si no quieres que un producto aparezca, márcalo como no visible o desactívalo.

¿Cómo mejoro mi calificación?

La calificación se basa en las reseñas de compradores. Para mejorarla:

• Responde rápido a consultas.
• Cumple con los tiempos de entrega.
• Ofrece productos con descripciones honestas.
• Resuelve problemas de manera proactiva.

¿Qué pasa si cambio el precio de un producto?

El nuevo precio se refleja en el marketplace en menos de 2 minutos. Si tu precio es el más bajo entre las tiendas que venden el mismo producto, se resalta con un badge.

¿Puedo tener una tienda online sin participar en el marketplace?

Sí. La tienda online (tutienda.adoqia.com) funciona independientemente. El marketplace es opcional.

¿Puedo desactivar y reactivar el marketplace?

Sí. Puedes desactivar tu participación en cualquier momento y reactivarla después. Tus mapeos de categorías se conservan.

¿Los productos agotados aparecen en el marketplace?

Sí, pero con un indicador visual de "Agotado" y el botón de compra deshabilitado. Los compradores pueden ver que existe pero no pueden comprarlo hasta que repongas stock.