Documentación · Primeros pasos

Lista de comprobación para la puesta en marcha

Este documento es la lista de comprobación de preparación para producción de ADP Car Market Hub. Recopila todos los elementos transversales que deben confirmarse antes de que se activen las importaciones automáticas en el sitio de producción de WordPress de un cliente, de modo que el lanzamiento sea predecible y reversible.

Complementa en lugar de reemplazar a First Setup: First Setup describe cómo configurar el plugin paso a paso; este documento describe cómo verificar que la configuración es segura para pasar a la operación en vivo.

Cuándo utilizar este documento

Utilice este documento si es:

Una agencia o socio de implementación a punto de lanzar un nuevo despliegue de ADP Car Market Hub para un cliente.
Un administrador de WordPress que está promocionando una configuración de staging validada a un sitio de producción.
Un equipo de hosting responsable de confirmar que el entorno de producción está dimensionado y configurado para las importaciones programadas.
Un responsable de operaciones que ejecuta un relanzamiento controlado después de una migración de servidor, cambio de dominio, renovación de certificado o actualización importante del plugin.

El público objetivo es técnico: un administrador de WordPress con acceso completo al back-office, que trabaja conjuntamente (cuando corresponda) con el proveedor de hosting y con quien posea el acceso a la API de AutoScout24 para el concesionario.

Descripción general

Una puesta en marcha en producción para ADP Car Market Hub no es una única acción: habilitar las importaciones automáticas es el último paso de una cadena que depende de:

La preparación del entorno de hosting y PHP.
Credenciales de API correctas y propiedad del concesionario.
Una Prueba de conexión exitosa y repetible y al menos una importación de prueba exitosa.
Un frontend que haya sido revisado con datos de vehículos reales e importados.
Ajustes legales, de privacidad y de consentimiento que coincidan con las políticas publicadas del concesionario.
Una ruta de rollback documentada si algo falla después del lanzamiento.

La siguiente lista de comprobación está agrupada por temas. Cada elemento debe marcarse o aceptarse explícitamente con un motivo documentado antes de que el sitio se abra al tráfico real con importaciones en vivo.

Requisitos antes de trabajar con la lista de comprobación

Confirme que todo lo siguiente está en su lugar antes de abrir esta lista de comprobación:

El plugin está instalado y activado en el sitio de producción (consulte la Guía de instalación).
Existe un entorno de staging configurado y se ha replicado la misma configuración en producción (consulte Staging to Live Migration).
Las credenciales de la API para la cuenta del concesionario están disponibles a través de un canal seguro (consulte la Configuración de credenciales de la API, AutoScout24 API Setup y External API Credentials).
El sitio tiene una copia de seguridad actual y restaurable que incluye la base de datos y wp-content/.
Las partes interesadas (concesionario, agencia, hosting) han acordado una ventana de tiempo de puesta en marcha para supervisar las primeras importaciones.

Instrucciones paso a paso

Trabaje en las secciones en orden. No active la programación automática hasta que se haya confirmado cada elemento aplicable.

1. Entorno e infraestructura

[ ] WordPress cumple con la versión mínima del plugin (Requires at least: 6.2) y PHP cumple con el mínimo (Requires PHP: 8.1). Consulte los Requisitos técnicos del sistema.
[ ] Las extensiones de PHP requeridas están presentes: openssl, curl, mbstring, json y una de gd o imagick. Consulte los Requisitos de PHP y base de datos.
[ ] El firewall de hosting y cualquier WAF delante del sitio permiten HTTPS saliente hacia el host de la API AutoScout24 configurado. Consulte los Requisitos de API, red y SSL.
[ ] El paquete de CA del servidor confía en la cadena de certificados del host de la API (sin errores de validación de SSL/TLS durante la Prueba de conexión).
[ ] El directorio wp-content/uploads/ tiene permisos de escritura para el usuario del servidor web, y wp-content/uploads/as24ci-logs/ está creado o se puede crear para el registro de logs del plugin.
[ ] Hay suficiente espacio en disco disponible para la biblioteca de medios proyectada (imágenes de vehículos importadas, incluyendo cualquier variante WebP si la conversión está activada).
[ ] Los recursos del servidor (memoria, tiempo máximo de ejecución, base de datos) están dimensionados para el catálogo previsto. Consulte los Requisitos de hosting.
[ ] Se confirman todas las entradas de la Lista de comprobación previa a la instalación.
[ ] Car Market Hub → System & Help no muestra insignias rojas.

2. Configuración del plugin

[ ] La licencia se ha activado en Car Market Hub → Settings (tarjeta License Activation). Las pestañas de administración del plugin ya no muestran la pantalla "License required", lo que confirma que las áreas premium están desbloqueadas. Consulte los Primeros pasos.
[ ] Los ajustes principales del plugin en Car Market Hub → Settings se han guardado y reflejan el entorno de producción, no el de pruebas (staging).
[ ] El API Base URL, el Seller ID (uno o más), el Client ID y el Client Secret están completados en la fuente AutoScout24 de Car Market Hub → Universal Import (el centro neurálgico para todas las fuentes de datos). El Client Secret se almacena encriptado en reposo. Si el inventario del concesionario proviene de otra fuente en vivo como carcuro, confirme que esa fuente está Connected allí en su lugar. Consulte la Referencia de Universal Import.
[ ] La moneda predeterminada (bajo General Settings en Settings) coincide con la moneda de precios del concesionario.
[ ] Las opciones de imagen (si se deben importar imágenes, número máximo de imágenes por vehículo, conversión opcional a WebP y calidad) se han configurado de forma deliberada y no se han dejado en los valores predeterminados sin verificar.
[ ] El estado de publicación predeterminado y el autor predeterminado de la entrada para los vehículos recién importados son adecuados para producción.
[ ] La opción Default pages está activada (de modo que se crean las páginas Cars, Compare Cars y Favorites) o se gestiona explícitamente mediante las propias páginas del concesionario utilizando los shortcodes documentados.
[ ] Se han revisado los filtros, los mapeos, el diseño y los estilos, y cualquier personalización de diseño sobre datos reales de vehículos importados, no sobre contenido de relleno.

3. Conexión de la API

[ ] La Prueba de conexión de la API en Car Market Hub → Tools se completa con éxito en el sitio de producción, contra las credenciales de la API de producción. Consulte la Prueba de conexión.
[ ] Si se han configurado varios Seller IDs, se ha ejecutado un Dry Run (simulación) desde Tools y devuelve datos para cada Seller ID configurado.
[ ] No aparecen errores de autenticación, autorización o SSL en Car Market Hub → Logs para la Prueba de conexión y el Dry Run más recientes.
[ ] Las credenciales en producción no son los mismos valores desechables utilizados durante las primeras pruebas de staging; las credenciales de producción rotadas, cuando corresponda, se han vuelto a probar.

4. Importaciones de prueba y calidad de los datos

[ ] Al menos una importación manual de un solo vehículo a través de Car Market Hub → Car Importer ha tenido éxito, incluyendo los archivos adjuntos de imagen.
[ ] Se ha completado sin errores una importación manual completa a través del Batch-Wizard en Car Market Hub → Import & Limits. El Batch-Wizard permite pausar, reanudar y abortar si es necesario.
[ ] El número de vehículos importados coincide con lo esperado para los Seller IDs configurados (verifique contra el inventario AutoScout24 del concesionario).
[ ] Se ha revisado una muestra representativa de vehículos importados para verificar: título, precio, moneda, kilometraje, lista de equipamiento, recuento de imágenes y orden de las imágenes.
[ ] Full Sync solo se activa después de que la importación de prueba confirme que todos los vehículos esperados llegan correctamente. Full Sync elimina de forma permanente las entradas de vehículos locales y sus imágenes para cualquier anuncio que ya no devuelva la API.

5. Programación y procesamiento en segundo plano

[ ] Se ha elegido el intervalo de importación automática deseado (cada hora, cada 6 horas, dos veces al día, diariamente o personalizado) y refleja las expectativas de actualización de datos del concesionario.
[ ] Si WP-Cron no es fiable en el host (por ejemplo, porque las visitas a las páginas son demasiado escasas o el host limita el cron interno), se configura una tarea cron real del servidor contra el endpoint REST protegido por token del plugin. Consulte la Configuración de cron del servidor y Cron y procesamiento en segundo plano.
[ ] La cola de imágenes está activada para mantener las ejecuciones de cron dentro de los límites de tiempo de PHP en catálogos grandes. El estado de la cola en System & Help muestra un progreso saludable después de la importación de prueba.
[ ] Los ajustes de robustez de cron (número máximo de vehículos por ejecución de cron) están dimensionados para el catálogo y los límites de ejecución de PHP del host.
[ ] Se ha verificado el comportamiento de la caché de tokens: una nueva prueba tras la rotación de credenciales tiene éxito (limpiando la caché de tokens desde Tools si es necesario).

6. Frontend y experiencia del cliente

[ ] La página de archivo Cars se renderiza correctamente con vehículos reales, incluyendo filtros, paginación, ordenación y miniaturas de imágenes.
[ ] Se ha revisado de principio a fin al menos una página de vehículo individual: galería, tabla de detalles del vehículo, lista de equipamiento, formato de precio, formulario de contacto (con la casilla de verificación de consentimiento) y cualquier característica opcional (calculadora de financiación, formulario de prueba de conducción, compartir en redes sociales) que esté activada.
[ ] El envío de un formulario de contacto de prueba aparece en Car Market Hub → Leads y activa el correo electrónico del destinatario configurado.
[ ] Si las alertas de búsqueda están activadas, se ha completado una suscripción de prueba, incluido el correo electrónico de confirmación de doble opt-in. Consulte el Doble opt-in de alertas de búsqueda.
[ ] Si el AI Assistant está activado, se han revisado los resultados generados por IA en al menos un vehículo y son aceptables para su publicación.
[ ] Las traducciones / cadenas de idioma en el frontend reflejan el idioma del sitio; las cadenas que faltaban se han solucionado a través del flujo de trabajo de traducción estándar de WordPress. Consulte la Guía de traducción y PoEdit.

7. Aspectos legales, privacidad y consentimiento

[ ] El sitio tiene una política de privacidad publicada que cubre los datos que recopila el plugin (datos del formulario de contacto, eventos de analítica opcionales, suscripciones opcionales a alertas de búsqueda). Consulte las Notas sobre RGPD / DSGVO y la Descripción general del almacenamiento de datos.
[ ] La etiqueta de la casilla de consentimiento del formulario de contacto, su estado obligatorio y los campos visibles en Car Market Hub → Leads coinciden con la política de privacidad del concesionario. Consulte Datos de leads y consentimiento.
[ ] Si la reserva de pruebas de conducción está activada, los días de la semana disponibles, la franja horaria diaria, la duración de las citas y las fechas de exclusión reflejan la disponibilidad real del concesionario.
[ ] El concesionario ha aceptado que los datos importados de leads y alertas de búsqueda se almacenarán en la base de datos de WordPress y es responsable de cualquier obligación de retención o exportación según la legislación aplicable.

8. Rendimiento, caché y SEO

[ ] Cualquier caché de página u objeto (caché del lado del servidor, CDN, plugin de caché) se ha configurado de modo que el archivo de vehículos y las páginas de vehículos individuales muestren datos actualizados después de cada importación, y que las solicitudes de administración no se sirvan desde la caché.
[ ] Si una CDN sirve imágenes desde wp-content/uploads/, se han establecido purgas de imágenes o tiempos de vida de caché cortos para que las imágenes recién importadas sean visibles de inmediato.
[ ] El sitio es accesible en el dominio de producción final a través de HTTPS, y las opciones de Site Address / WordPress Address de WordPress apuntan a ese dominio.
[ ] El sitio no está configurado para "Disuadir a los motores de búsqueda de indexar este sitio" (a menos que esa sea la intención explícita del concesionario).
[ ] Existe un mapa del sitio XML (proporcionado por el núcleo de WordPress o por un plugin de SEO) y las nuevas URL de los vehículos siguen la estructura canónica del concesionario.
[ ] No quedan URL de staging, direcciones de correo electrónico de prueba ni textos de consentimiento de prueba en la configuración de producción.

9. Operaciones, monitorización y soporte

[ ] Se ha abierto Car Market Hub → Logs y se comprende el comportamiento de rotación. El directorio de logs wp-content/uploads/as24ci-logs/ tiene permisos de escritura. Consulte Registro de logs y monitorización.
[ ] Se ha acordado con el cliente un calendario para las comprobaciones rutinarias: revisión diaria de leads e importaciones (Operación diaria), Mantenimiento semanal y Mantenimiento mensual.
[ ] La Monitorización de importaciones y el Mantenimiento de la cola de imágenes son comprendidos por quien vaya a operar el sitio.
[ ] Se ha documentado y probado al menos una vez un procedimiento de copia de seguridad y restauración. Consulte Copia de seguridad y restauración.
[ ] Se ha acordado el canal de actualización del plugin (subida de un nuevo ZIP por el administrador o sustitución de la carpeta del plugin por SFTP) y coincide con el Proceso de actualización.
[ ] Existe un plan de rollback documentado: cómo desactivar la programación, cómo desactivar el plugin sin perder datos y cómo restaurar desde una copia de seguridad si es necesario.
[ ] Se ha delegado la operación diaria a los usuarios correspondientes a través de los roles y capacidades del plugin. Consulte Control de acceso y capacidades.
[ ] Las vías de contacto para soporte están documentadas en el lado del cliente: quién gestiona los problemas de WordPress, quién gestiona el hosting, quién es el propietario de la cuenta de la API de AutoScout24 y cómo escalar a AD Promotion si es necesario.
[ ] Se conoce de antemano la información necesaria para abrir un ticket de soporte. Consulte la Lista de comprobación de información de soporte.

10. Acciones finales para la puesta en marcha

Solo después de haber marcado cada uno de los elementos aplicables anteriores:

Vuelva a ejecutar la Prueba de conexión en el sitio de producción como comprobación final de seguridad.
Active las importaciones automáticas en Car Market Hub → Import & Limits con el intervalo elegido.
Active una importación manualmente (o espere a la primera ejecución programada) y observe los Logs hasta que se complete.
Vuelva a comprobar el frontend en el dominio de producción, incluyendo el envío de un formulario de contacto real y, si corresponde, una suscripción real a Alertas de búsqueda.
Entregue el sistema a la rutina de monitorización acordada e informe al cliente de que las importaciones ya están activas.

Referencia de configuración

Este documento no introduce nuevos ajustes; solo hace referencia a la configuración documentada en otros lugares. Las páginas más relevantes son:

Campos de conexión de la API y fuentes de datos: consulte la Configuración de credenciales de la API y la Referencia de Universal Import.
Programación de importaciones y límites: consulte los Primeros pasos (Paso 5) y Cron y procesamiento en segundo plano.
Campos de leads y consentimiento: consulte Datos de leads y consentimiento.
Cron del servidor y activadores externos: consulte la Configuración de cron del servidor.

Notas operativas

Reversibilidad. Desactivar la programación automática en Import & Limits detiene las nuevas importaciones sin eliminar los vehículos ya importados. Desactivar el plugin deshabilita sus funciones pero mantiene los vehículos importados, las opciones, los leads y los datos de analítica en la base de datos. Los datos se eliminan al desinstalar solo cuando la configuración de limpieza correspondiente está activada. Consulte Desinstalación y limpieza de datos.
Full Sync en el lanzamiento. Por lo general, es más seguro realizar el lanzamiento con Full Sync desactivado, observar un ciclo de importación completo y activar Full Sync solo una vez que el inventario importado sea consistentemente completo. Activar Full Sync de forma prematura puede eliminar permanentemente vehículos que simplemente faltaban en una respuesta transitoria de la API. Verifique este comportamiento en la versión actual del plugin antes de publicar si tiene dudas.
Cambios de dominio y URL. Si el sitio se va a lanzar en un nuevo dominio (por ejemplo, pasando de staging.example.com a www.example.com), asegúrese de que las URL de WordPress, cualquier capa de caché y cualquier servicio externo que enlace al sitio estén alineados antes de activar las importaciones. Consulte Migración de Staging a Live.
Lanzamientos silenciosos. Para lanzamientos delicados, considere activar las importaciones automáticas fuera del horario comercial y observar el primer ciclo de cron a través de la vista de Logs antes de que los clientes puedan acceder a las nuevas páginas.
Entrega de documentación. Proporcione al cliente las páginas relevantes del Manual del usuario y de la sección Operaciones y mantenimiento, para que comprendan el flujo de trabajo diario del que se están haciendo cargo.

Resolución de problemas

Síntoma en la puesta en marcha	Causa probable	Qué comprobar
La Prueba de conexión falla en producción pero pasó en staging.	Las credenciales de producción difieren, la red de producción es más restrictiva o el servidor de producción tiene un paquete de CA diferente.	Vuelva a introducir las credenciales, confirme el HTTPS saliente hacia el host de la API con el proveedor de hosting y revise los errores de SSL. Consulte Prueba de conexión y Errores de conexión de la API.
Las importaciones programadas no se inician tras activar la programación.	WP-Cron está desactivado o limitado en el host.	Configure una tarea cron del servidor contra el endpoint REST del plugin. Consulte Configuración de Cron del servidor y Errores de Cron.
La primera importación en producción elimina vehículos que aún deberían existir.	Se activó Full Sync antes de confirmar que el inventario importado estaba completo.	Desactive Full Sync, restaure los vehículos afectados desde la copia de seguridad y vuelva a activar Full Sync solo después de observar un ciclo de importación completo y correcto.
Las páginas de vehículos se renderizan sin imágenes, o las imágenes aparecen gradualmente.	La cola de imágenes se está procesando en segundo plano (comportamiento esperado) o los tiempos de espera de PHP interrumpen las descargas.	Observe el estado de la cola de imágenes en System & Help; ejecute Run image queue now. Consulte Errores de importación de imágenes y Mantenimiento de la cola de imágenes.
Los correos electrónicos de leads no se entregan.	El sitio no puede enviar correos, la dirección del destinatario es incorrecta o el host bloquea el SMTP saliente.	Verifique el correo electrónico del destinatario en Leads y la configuración de correo saliente del sitio. Consulte Errores de correo electrónico y leads.
Las páginas en caché siguen mostrando el inventario de vehículos antiguo.	La caché de página o la CDN están sirviendo contenido obsoleto.	Configure la invalidación de caché o TTLs más cortos para las URL afectadas.
Los visitantes aterrizan en URL de staging después del lanzamiento.	Enlaces obsoletos, URL del sitio WordPress incorrecta o DNS aún no propagado.	Confirme las opciones de WordPress Dirección del sitio y Dirección de WordPress, y verifique la propagación de DNS para el dominio de producción.

Para diagnósticos más amplios basados en síntomas, consulte la sección de Resolución de problemas.