Manual del usuario

Este manual proporciona una guía práctica para utilizar el plugin ADP Car Market Hub WordPress. Está dirigido al personal del concesionario, clientes B2B y a cualquier persona que interactúe con el plugin en su día a día, desde la revisión de los vehículos importados y la gestión de leads hasta la comprensión de lo que se muestra a los clientes en el frontend.

Cuándo utilizar este documento

Lea este documento si usted:

• Es un administrador o editor responsable de mantener el inventario de vehículos en un sitio WordPress equipado con este plugin.
• Necesita entender qué hace el plugin y cómo funcionan sus áreas principales.
• Desea aprender a navegar por la interfaz de administración, supervisar las importaciones, revisar los leads y comprobar el frontend.

Para un enfoque más profundo en las responsabilidades administrativas, los permisos y la salud del sistema, consulte el Manual del administrador.

---

Descripción general

ADP Car Market Hub conecta un sitio WordPress a la API de AutoScout24 e importa los listados de vehículos como entradas de WordPress. Gestiona el ciclo de vida completo de un listado de vehículos: obtención de datos de la API, almacenamiento en WordPress, visualización en el frontend y registro de las consultas de los clientes.

El plugin utiliza un tipo de contenido personalizado dedicado (as24ci_car) y 15 taxonomías de atributos de vehículos (marca, tipo de carrocería, tipo de combustible, transmisión, estado, entre otros). Esto hace que los datos de los vehículos estén disponibles a través de las páginas de archivo nativas de WordPress, páginas de taxonomía y shortcodes.

Los vehículos importados se crean como entradas de WordPress con el estado publish o draft, dependiendo del valor predeterminado configurado. Todas las imágenes asociadas se descargan y se adjuntan a la entrada. Los metadatos del vehículo (precio, kilometraje, especificaciones del motor, equipamiento y más) se almacenan en los metadatos de la entrada (post meta) y en una tabla de base de datos dedicada.

El plugin añade tres menús de nivel superior a la barra lateral de administración de WordPress, agrupados directamente debajo del Escritorio de WordPress:

• CMH Center — el espacio de trabajo principal del plugin (Dashboard, Car Importer, Leads, Content Studio, Settings y todas las demás herramientas).
• CMH Cars — el propio inventario de vehículos (el tipo de contenido as24ci_car), donde se listan, editan y publican los registros individuales de los vehículos.
• CMH Team — contactos de ventas del concesionario gestionados por el plugin que pueden mostrarse en las páginas de detalles del vehículo y utilizarse para enrutar los leads.

Las etiquetas mantienen el prefijo de marca fijo "CMH" y traducen únicamente la palabra posterior (por ejemplo, "CMH Zentrale" / "CMH Fahrzeuge" / "CMH Team" en alemán).

---

Requisitos o prerrequisitos

Antes de utilizar el plugin, se debe cumplir con lo siguiente:

• Se requiere WordPress 6.2 o posterior y PHP 8.1 o posterior.
• El plugin debe estar instalado y activado por un administrador de WordPress.
• Las credenciales de la API (API Base URL, Seller ID(s), Client ID, Client Secret, Token URL y Audience) deben obtenerse de AutoScout24 o de su socio de integración e introducirse en la pestaña Settings. Sin credenciales válidas, no se podrán importar vehículos.
• El sitio WordPress debe ser capaz de realizar conexiones HTTPS salientes al endpoint de la API configurado.
• Para la importación de imágenes, el servidor web debe tener permisos de escritura en el directorio de subidas (uploads) de WordPress.

---

Instrucciones paso a paso

Navegar al plugin

1. Inicie sesión en el escritorio de administración de WordPress.
2. En la barra lateral izquierda, haga clic en CMH Center para expandir el menú principal del plugin. (CMH Cars y CMH Team son otros dos menús de nivel superior situados directamente debajo).
3. El menú CMH Center contiene los siguientes elementos, ordenados según el flujo de trabajo del concesionario (primero los puntos de entrada operativos diarios, luego el análisis de negocio, las herramientas de marketing y salida, las áreas de diseño y configuración, y finalmente las herramientas técnicas, registros, sistema y soporte). El orden es el mismo en todos los idiomas, aunque las etiquetas visibles estén traducidas. Para obtener una referencia completa pantalla por pantalla, consulte la Referencia de administración y la Descripción general del menú de administración.

Las funciones opcionales (AI Assistant, Content Studio, Analytics, Market Insights, Search Alerts, Locations, EnVKV / Energy, PDF Manager) solo resultan útiles una vez que se proporciona la configuración correspondiente; las entradas del menú en sí siempre están presentes. Content Studio y algunas áreas operativas también pueden requerir una licencia activa antes de poder utilizarse.

Menús CMH Cars y CMH Team

Dos menús de nivel superior adicionales se sitúan directamente debajo de CMH Center:

• CMH Cars enumera todos los vehículos importados (el tipo de contenido as24ci_car). Abra CMH Cars → All Cars para revisar, editar, publicar o enviar a la papelera registros de vehículos individuales. Los borradores de vehículos se gestionan aquí, no en la pantalla estándar de Entradas de WordPress.
• CMH Team gestiona los contactos de ventas del concesionario administrados por el plugin. Puede añadir miembros del equipo (nombre, foto, correo electrónico, teléfono), establecer contactos predeterminados globales y por ubicación, asignar un contacto a coches individuales y definir reglas de asignación automática. El contacto resuelto se muestra en la página de detalles del vehículo y se utiliza como destinatario preferente para los leads. Los miembros del equipo nunca necesitan su propio inicio de sesión en WordPress. Consulte CMH Team y enrutamiento de contactos.

Uso del Dashboard

La pestaña Dashboard proporciona una descripción general a nivel de negocio del inventario de vehículos:

• Fila de KPIs – muestra métricas clave como el total de vehículos publicados, borradores, vehículos añadidos en los últimos 7 días e indicadores de interacción de los clientes.
• Preparación del vehículo (Vehicle Readiness) – muestra indicadores de integridad, como vehículos a los que les faltan imágenes o descripciones cortas.
• Requiere atención (Needs Attention) – destaca problemas que requieren acción en el inventario actual.
• Gráfico de tendencia del inventario (Inventory Trend) – muestra los nuevos vehículos importados a lo largo del tiempo.
• Gráfico de interés del cliente (Customer Interest) – muestra las visitas a las páginas a lo largo del tiempo (requiere que la función Analytics esté habilitada).
• Vehículos con mejor rendimiento (Top Performing Vehicles) – enumera los vehículos por visitas o leads.
• Leads recientes (Recent Leads) – muestra las últimas consultas de clientes recibidas a través del formulario de contacto.

Los datos del Dashboard se almacenan en caché durante aproximadamente 3 minutos. Recargue la página para actualizarlos.

Uso del Car Importer

La pestaña Car Importer muestra todos los listados disponibles de las cuentas de vendedor (AutoScout24 Seller ID) configuradas.

1. Navegue a ADP Car Market Hub → Car Importer.
2. La página muestra dos tablas: - Vehículos importados – listados que ya están presentes en WordPress. - Vehículos pendientes – listados disponibles en la API que aún no se han importado.
3. Utilice el cuadro de búsqueda para filtrar los listados por marca, modelo u otros identificadores.
4. Para importar un solo vehículo, haga clic en el botón Import junto al listado.
5. Para volver a importar (actualizar) un vehículo ya importado, haga clic en el botón Re-import.
6. Para eliminar un solo vehículo de WordPress, haga clic en el botón Delete. Esto elimina permanentemente la entrada y sus imágenes adjuntas.
7. Para importar o eliminar varios vehículos, utilice las casillas de verificación y el menú desplegable de acciones en lote.
8. Utilice el control Elementos por página para ajustar el número de listados mostrados.

Ejecutar una importación completa manual

Una importación completa manual (Batch-Wizard) procesa todos los listados remotos uno por uno:

1. Navegue a ADP Car Market Hub → Import & Limits.
2. Haga clic en Trigger now (o el botón equivalente que se muestra en esa pestaña) para iniciar el Batch-Wizard.
3. Una barra de progreso muestra el número de vehículos procesados, el tiempo restante estimado y el estado actual.
4. Puede pausar, reanudar o abortar la importación en cualquier momento.
5. Una vez completada la importación, el resumen de estado muestra cuántos vehículos se agregaron, actualizaron o ignoraron.

Revisar leads

Los leads son los envíos de formularios de contacto de los clientes recibidos a través de las páginas de detalles de los vehículos.

1. Navegue a ADP Car Market Hub → Leads.
2. La lista de leads muestra la fecha de envío, el nombre del cliente, el correo electrónico, el número de teléfono, el mensaje y el vehículo sobre el que se realizó la consulta.
3. Cada lead tiene un estado: New, Contacted, Closed o Spam. Cambie el estado a medida que procese cada consulta.
4. Para exportar todos los leads (o los leads filtrados) a un archivo CSV, haga clic en el botón Export CSV. El archivo incluye un BOM UTF-8 para su correcta visualización en Microsoft Excel.
5. Para eliminar un lead, utilice la acción de eliminar situada junto a él.

Comprobar el frontend

Una vez importados los vehículos, estos aparecen en el frontend de acuerdo con la configuración de enlaces permanentes y plantillas de su WordPress:

• La página de archivo de vehículos enumera todos los vehículos publicados en un diseño de cuadrícula basado en tarjetas con controles de filtrado.
• Las páginas de detalles de vehículos individuales muestran el listado completo: galería de imágenes, tabla de especificaciones, lista de equipamiento, descripción, precio, formulario de contacto, calculadora de financiación (si está habilitada) y formulario de prueba de conducción (si está habilitado).
• La página de comparación (a través del shortcode [as24ci_compare]) permite a los visitantes comparar los vehículos seleccionados uno al lado del otro.
• La página de favoritos (a través del shortcode [as24ci_favorites]) muestra los vehículos que un visitante ha guardado.

Para verificar la página de archivo de vehículos:

1. Desde la administración de WordPress, abra Páginas y compruebe que la página de archivo existe y está publicada.
2. Confirme que los vehículos individuales están publicados en CMH Cars → All Cars, luego haga clic en Ver para abrir la página del frontend y confirmar que los vehículos se muestran correctamente.
3. Si la página está vacía o muestra un error, compruebe la pestaña Settings para confirmar que las credenciales de la API y los Seller IDs son correctos, y revise la pestaña Logs para buscar errores de importación.

---

---

Referencia de configuración

Los siguientes ajustes son relevantes para los usuarios habituales. La documentación completa de la configuración se encuentra en la sección 04-admin-reference.

---

Notas operativas

• Detección de cambios: El importador almacena un hash de contenido y un hash de imagen para cada vehículo importado. Durante las importaciones repetidas, se omiten los vehículos cuyos datos no hayan cambiado. Esto mantiene la rapidez de las ejecuciones de importación.
• Full Sync: Cuando Full Sync está activado en la pestaña Import & Limits, cualquier vehículo que ya no esté presente en el anuncio remoto de AutoScout24 se eliminará permanentemente de WordPress, incluidas sus imágenes adjuntas. Active esta opción solo si desea que el inventario local refleje exactamente la API en vivo.
• Cola de imágenes: Durante las importaciones programadas (cron), solo se descarga inmediatamente la primera imagen de cada vehículo. Las imágenes restantes se procesan de forma asíncrona mediante un gestor de colas en segundo plano. Esto evita errores de tiempo de espera de ejecución de PHP durante importaciones grandes. La cola se procesa aproximadamente cada 5 minutos.
• Vehículos en borrador: Los vehículos importados con el estado de publicación draft se almacenan en WordPress pero no son visibles públicamente en el frontend. Se pueden revisar y publicar manualmente desde la lista CMH Cars → All Cars.
• Taxonomías: Los datos de los vehículos se almacenan en 15 taxonomías nativas de WordPress. Los archivos de taxonomía (por ejemplo, todos los vehículos de una marca específica) están disponibles sin configuración adicional.
• Traducciones: El plugin es totalmente traducible a través del dominio de texto adp-car-market-hub. Las traducciones deben proporcionarse por separado.
• Rotación de logs: El archivo de registro del plugin se rota automáticamente cuando supera los 10 MB. Los archivos de registro anteriores se archivan con una marca de tiempo.

---

Resolución de problemas

---

Documentos relacionados

• Manual del administrador
• Flujos de trabajo de uso diario
• Vehicle Import Workflow
• Lead Management Workflow
• Flujo de trabajo de uso en el frontend