Documentazione · Iniziare

Lista di controllo per la messa in linea

Questo documento è la lista di controllo per la messa in produzione di ADP Car Market Hub. Raccoglie tutti gli elementi trasversali che dovrebbero essere confermati prima che gli importi automatici vengano abilitati sul sito WordPress live di un cliente, in modo che il lancio sia prevedibile e reversibile.

Completa anziché sostituire la Prima configurazione: la Prima configurazione descrive come configurare il plugin passo dopo passo; questo documento descrive come verificare che la configurazione sia sicura per passare al funzionamento live.

Quando utilizzare questo documento

Utilizza questo documento se sei:

Un'agenzia o un partner di implementazione che sta per rilasciare una nuova installazione di ADP Car Market Hub a un cliente.
Un amministratore WordPress che promuove una configurazione di staging convalidata a un sito di produzione.
Un team di hosting responsabile di confermare che l'ambiente di produzione sia dimensionato e configurato per gli importi pianificati.
Un responsabile delle operazioni che esegue un rilancio controllato dopo una migrazione del server, un cambio di dominio, un rinnovo del certificato o un aggiornamento importante del plugin.

Il pubblico è tecnico: un amministratore WordPress con accesso completo al back-office, che lavora insieme (ove applicabile) al provider di hosting e a chiunque possieda l'accesso API AutoScout24 per il concessionario.

Panoramica

Una messa in produzione live per ADP Car Market Hub non è una singola azione — l'abilitazione degli importi automatici è l'ultimo passo di una catena che dipende da:

Prontezza dell'ambiente di hosting e PHP.
Credenziali API corrette e di proprietà della concessionaria.
Un Test di connessione riuscito e ripetibile e almeno un'importazione di prova andata a buon fine.
Un frontend che è stato revisionato rispetto ai dati reali dei veicoli importati.
Impostazioni legali, sulla privacy e sul consenso che corrispondono alle politiche pubblicate dalla concessionaria.
Un percorso di rollback documentato se qualcosa fallisce dopo il lancio.

La lista di controllo qui sotto è raggruppata per argomento. Ogni elemento dovrebbe essere spuntato o esplicitamente accettato con un motivo documentato prima che il sito venga aperto al traffico reale con importazioni live.

Requisiti prima di procedere con la lista di controllo

Conferma che tutti i seguenti elementi siano pronti prima di aprire questa lista di controllo:

Il plugin è installato e attivato sul sito di produzione (vedi Guida all'installazione).
Esiste un ambiente di staging configurato e la stessa configurazione è stata replicata in produzione (vedi Staging to Live Migration).
Le credenziali API per l'account del concessionario sono disponibili tramite un canale sicuro (vedi Configurazione delle credenziali API, AutoScout24 API Setup, External API Credentials).
Il sito dispone di un backup recente e ripristinabile che include il database e wp-content/.
Le parti interessate (concessionaria, agenzia, hosting) hanno concordato una finestra temporale di messa in produzione in cui monitorare le prime importazioni.

Istruzioni passo dopo passo

Completa le sezioni in ordine. Non abilitare la pianificazione automatica finché ogni elemento applicabile non è stato confermato.

1. Ambiente e infrastruttura

[ ] WordPress soddisfa la versione minima del plugin (Requires at least: 6.2) e PHP soddisfa il requisito minimo (Requires PHP: 8.1). Vedi Requisiti tecnici di sistema.
[ ] Le estensioni PHP richieste sono presenti: openssl, curl, mbstring, json e una tra gd o imagick. Vedi Requisiti di PHP e database.
[ ] Le connessioni HTTPS in uscita verso l'host API AutoScout24 configurato sono consentite dal firewall di hosting e da qualsiasi WAF a monte del sito. Vedi Requisiti di API, rete e SSL.
[ ] Il bundle CA del server considera attendibile la catena di certificati dell'host API (nessun errore di convalida SSL/TLS durante il Test di connessione).
[ ] La directory wp-content/uploads/ è scrivibile dall'utente del server web e wp-content/uploads/as24ci-logs/ è creata o creabile per la registrazione dei log del plugin.
[ ] È disponibile spazio su disco sufficiente per la libreria multimediale prevista (immagini dei veicoli importate, comprese eventuali varianti WebP se la conversione è abilitata).
[ ] Le risorse del server (memoria, tempo massimo di esecuzione, database) sono dimensionate per il catalogo previsto. Vedi Requisiti di hosting.
[ ] Tutte le voci della Lista di controllo pre-installazione sono confermate.
[ ] Car Market Hub → System & Help non mostra badge rossi.

2. Configurazione del plugin

[ ] La licenza è stata attivata su Car Market Hub → Settings (scheda License Activation). Le schede di amministrazione del plugin non mostrano più la schermata "License required", confermando che le aree premium sono sbloccate. Vedi Prima configurazione.
[ ] Le impostazioni principali del plugin su Car Market Hub → Settings sono state salvate e riflettono l'ambiente di produzione, non quello di staging.
[ ] API Base URL, Seller ID (uno o più), Client ID e Client Secret sono popolati nella sorgente AutoScout24 di Car Market Hub → Universal Import (l'hub centrale per tutte le sorgenti dati). Il Client Secret è memorizzato crittografato a riposo. Se l'inventario del concessionario proviene da un'altra sorgente live come carcuro, conferma invece che tale sorgente sia Connected in quella sezione. Vedi Universal Import Reference.
[ ] La valuta predefinita (sotto General Settings in Settings) corrisponde alla valuta dei prezzi del concessionario.
[ ] Le opzioni delle immagini (se importare le immagini, numero massimo di immagini per veicolo, conversione WebP opzionale e qualità) sono impostate deliberatamente e non lasciate ai valori predefiniti non verificati.
[ ] Lo stato predefinito dell'articolo e l'autore predefinito dell'articolo per i veicoli appena importati sono appropriati per la produzione.
[ ] L'opzione Default pages è abilitata (in modo da creare le pagine Cars, Compare Cars e Favorites) o gestita esplicitamente dalle pagine del concessionario utilizzando i shortcode documentati.
[ ] I filtri, le mappature, il design e gli stili, e qualsiasi personalizzazione del layout sono stati esaminati su dati reali di veicoli importati, non su contenuti segnaposto.

3. Connessione API

[ ] Il Test di connessione API su Car Market Hub → Tools si completa con successo sul sito di produzione, a fronte delle credenziali API di produzione. Vedi Test di connessione.
[ ] Se sono configurati più Seller ID, è stata eseguita una simulazione (Dry Run) da Tools e restituisce dati per ogni Seller ID configurato.
[ ] Nessun errore di autenticazione, autorizzazione o SSL appare in Car Market Hub → Logs per il Test di connessione e la simulazione più recenti.
[ ] Le credenziali in produzione non sono gli stessi valori temporanei utilizzati durante i primi test di staging; le credenziali di produzione ruotate, ove applicabile, sono state testate nuovamente.

4. Importazioni di prova e qualità dei dati

[ ] Almeno un'importazione manuale di un singolo veicolo tramite Car Market Hub → Car Importer è andata a buon fine, inclusi gli allegati immagine.
[ ] Un'importazione manuale completa tramite il Batch-Wizard su Car Market Hub → Import & Limits è stata completata senza errori. Il Batch-Wizard supporta la pausa, il ripristino e l'interruzione se necessario.
[ ] Il numero di veicoli importati corrisponde alle aspettative per i Seller ID configurati (verifica rispetto all'inventario AutoScout24 del concessionario).
[ ] Un campione rappresentativo di veicoli importati è stato esaminato per: titolo, prezzo, valuta, chilometraggio, elenco degli equipaggiamenti, numero di immagini e ordine delle immagini.
[ ] Full Sync è abilitato solo dopo che l'importazione di prova ha confermato che tutti i veicoli previsti arrivano correttamente. Full Sync elimina in modo permanente gli articoli dei veicoli locali e le relative immagini per qualsiasi annuncio non più restituito dall'API.

5. Pianificazione ed elaborazione in background

[ ] L'intervallo di importazione automatica desiderato (orario, ogni 6 ore, due volte al giorno, giornaliero o personalizzato) è stato scelto e riflette le aspettative di aggiornamento dei dati del concessionario.
[ ] Se WP-Cron non è affidabile sull'host (ad esempio perché le visite alle pagine sono troppo scarse o l'host limita il cron interno), viene configurato un vero processo cron di sistema a fronte dell'endpoint REST protetto da token del plugin. Vedi Server Cron Setup e Cron e elaborazione in background.
[ ] La coda delle immagini è abilitata per mantenere le esecuzioni cron entro i limiti di timeout di PHP su cataloghi di grandi dimensioni. Lo stato della coda su System & Help mostra un progresso regolare dopo l'importazione di prova.
[ ] Le impostazioni di robustezza del cron (numero massimo di veicoli per esecuzione cron) sono dimensionate per il catalogo e i limiti di esecuzione PHP dell'host.
[ ] Il comportamento della cache dei token è stato verificato: un nuovo test dopo la rotazione delle credenziali ha successo (svuotando la cache dei token da Tools se necessario).

6. Frontend ed esperienza del cliente

[ ] La pagina di archivio Cars viene visualizzata correttamente con veicoli reali, inclusi filtri, paginazione, ordinamento e miniature delle immagini.
[ ] Almeno una pagina del singolo veicolo è stata esaminata da cima a fondo: galleria, tabella dei dettagli del veicolo, elenco degli equipaggiamenti, formattazione del prezzo, modulo di contatto (con la casella di controllo del consenso) e qualsiasi funzionalità opzionale (calcolatore di finanziamento, modulo di prova su strada, condivisione social) abilitata.
[ ] L'invio di un modulo di contatto di prova appare sotto Car Market Hub → Leads e attiva l'email del destinatario configurato.
[ ] Se i Search Alerts sono abilitati, è stata completata un'iscrizione di prova, inclusa l'email di conferma Double-Opt-In. Vedi Search Alerts Double Opt-In.
[ ] Se l'AI Assistant è abilitato, i testi generati dall'intelligenza artificiale su almeno un veicolo sono stati esaminati e sono accettabili per la pubblicazione.
[ ] Le traduzioni / stringhe di lingua sul frontend riflettono la lingua del sito; le stringhe mancanti sono state gestite tramite il flusso di lavoro di traduzione standard di WordPress. Vedi Translation and PoEdit Guide.

7. Aspetti legali, privacy e consenso

[ ] Il sito ha una privacy policy pubblicata che copre i dati raccolti dal plugin (dati del modulo di contatto, eventi di analisi opzionali, iscrizioni opzionali agli avvisi di ricerca). Vedi GDPR / DSGVO Notes e Data Storage Overview.
[ ] L'etichetta della casella di controllo del consenso del modulo di contatto, lo stato obbligatorio e i campi visibili sotto Car Market Hub → Leads corrispondono alla privacy policy del concessionario. Vedi Lead Data and Consent.
[ ] Se la prenotazione della prova su strada è abilitata, i giorni feriali disponibili, la fascia oraria giornaliera, la durata dello slot e le date di esclusione riflettono l'effettiva disponibilità della concessionaria.
[ ] La concessionaria ha accettato che i dati importati dei lead e degli avvisi di ricerca saranno memorizzati nel database di WordPress ed è responsabile di eventuali obblighi di conservazione o esportazione ai sensi della legge applicabile.

8. Prestazioni, memorizzazione nella cache e SEO

[ ] Qualsiasi cache di pagina o di oggetto (cache lato server, CDN, plugin di cache) è stata configurata in modo che l'archivio dei veicoli e le pagine dei singoli veicoli mostrino dati aggiornati dopo ogni importazione e che le richieste di amministrazione non vengano servite dalla cache.
[ ] Se una CDN serve le immagini da wp-content/uploads/, sono attive eliminazioni della cache delle immagini o tempi di permanenza in cache brevi in modo che le immagini appena importate diventino visibili tempestivamente.
[ ] Il sito è raggiungibile sul dominio di produzione finale tramite HTTPS e le opzioni Site Address / WordPress Address di WordPress puntano a quel dominio.
[ ] Il sito non è impostato su "Scoraggia i motori di ricerca dall'effettuare l'indicizzazione di questo sito" (a meno che non sia l'intento esplicito della concessionaria).
[ ] Esiste una sitemap XML (fornita dal core di WordPress o da un plugin SEO) e gli URL dei nuovi veicoli seguono la struttura canonica della concessionaria.
[ ] Nella configurazione di produzione non rimangono URL di staging, indirizzi email di prova o testi di consenso di prova.

9. Operazioni, monitoraggio e supporto

[ ] La sezione Car Market Hub → Logs è stata aperta e il comportamento di rotazione è chiaro. La directory dei log wp-content/uploads/as24ci-logs/ è scrivibile. Vedi Logging and Monitoring.
[ ] È stato concordato con il cliente un programma per i controlli di routine: revisione giornaliera dei lead e delle importazioni (Daily Operation), Weekly Maintenance e Monthly Maintenance.
[ ] Le procedure di Import Monitoring e Image Queue Maintenance sono comprese da chiunque gestirà il sito.
[ ] Una procedura di backup e ripristino è documentata ed è stata testata almeno una volta. Vedi Backup and Restore.
[ ] Il canale di aggiornamento del plugin è concordato (caricamento da amministratore di un nuovo file ZIP o sostituzione tramite SFTP della cartella del plugin) e corrisponde al Update Process.
[ ] Esiste un piano di rollback documentato: come disabilitare la pianificazione, come disattivare il plugin senza perdere dati e come ripristinare da backup se necessario.
[ ] L'operatività quotidiana è stata delegata agli utenti appropriati tramite i ruoli e le funzionalità del plugin. Vedi Access Control and Capabilities.
[ ] I canali di contatto per il supporto sono documentati lato cliente: chi gestisce i problemi di WordPress, chi gestisce l'hosting, chi possiede l'account API di AutoScout24 e come inoltrare le richieste ad AD Promotion se necessario.
[ ] Le informazioni necessarie per aprire un ticket di supporto sono note in anticipo. Vedi Support Information Checklist.

10. Azioni finali per la messa online

Solo dopo aver spuntato ogni voce applicabile sopra indicata:

Esegui nuovamente il Test di connessione sul sito di produzione come controllo di integrità finale.
Abilita le importazioni automatiche su Car Market Hub → Import & Limits con l'intervallo scelto.
Avvia un'importazione manualmente (o attendi la prima esecuzione pianificata) e monitora i Logs fino al completamento.
Ricontrolla il frontend sul dominio di produzione, inclusi l'invio di un modulo di contatto reale e, se applicabile, un'iscrizione reale agli avvisi di ricerca.
Passa alla routine di monitoraggio concordata e informa il cliente che le importazioni sono ora attive.

Riferimento di configurazione

Questo documento non introduce nuove impostazioni; fa solo riferimento alla configurazione documentata altrove. Le pagine più rilevanti sono:

Campi di connessione API e sorgenti dati: vedi Configurazione delle credenziali API e il Universal Import Reference.
Pianificazione e limiti di importazione: vedi Prima configurazione (Passo 5) e Cron e elaborazione in background.
Campi dei lead e del consenso: vedi Lead Data and Consent.
Cron del server e trigger esterni: vedi Server Cron Setup.

Note operative

Reversibilità. Disabilitare la pianificazione automatica su Import & Limits interrompe le nuove importazioni senza rimuovere i veicoli già importati. La disattivazione del plugin disabilita le sue funzionalità ma mantiene i veicoli importati, le opzioni, i lead e i dati analitici nel database. I dati vengono rimossi al momento della disinstallazione solo quando è abilitata la relativa impostazione di pulizia. Vedere Disinstallazione e pulizia dei dati.
Full Sync al lancio. In genere è più sicuro avviare il sito con Full Sync disabilitato, osservare un ciclo di importazione completo e abilitare Full Sync solo quando l'inventario importato risulta costantemente completo. Abilitare Full Sync prematuramente può eliminare in modo permanente i veicoli che erano semplicemente assenti da una risposta API temporanea. In caso di dubbi, verificare questo comportamento nella versione corrente del plugin prima della pubblicazione.
Modifiche al dominio e all'URL. Se il sito viene lanciato su un nuovo dominio (ad esempio passando da staging.example.com a www.example.com), assicurarsi che gli URL di WordPress, qualsiasi livello di cache e qualsiasi servizio esterno che si collega al sito siano allineati prima di abilitare le importazioni. Vedere Migrazione da staging a live.
Lanci silenziosi. Per i lanci delicati, valutare la possibilità di abilitare le importazioni automatiche al di fuori dell'orario di lavoro e monitorare il primo ciclo di cron tramite la vista Logs prima che i clienti possano raggiungere le nuove pagine.
Consegna della documentazione. Fornire al cliente le pagine pertinenti del Manuale utente e della sezione Operazioni e manutenzione, in modo che comprendano il flusso di lavoro quotidiano di cui stanno assumendo la gestione.

Risoluzione dei problemi

Sintomo al go-live	Causa probabile	Cosa controllare
Il Test di connessione fallisce in produzione ma ha avuto successo in staging.	Le credenziali di produzione sono diverse, la rete di produzione è più restrittiva o il server di produzione ha un pacchetto CA diverso.	Reinserire le credenziali, confermare le connessioni HTTPS in uscita verso l'host API con il provider di hosting e verificare gli errori SSL. Vedere Test di connessione e Errori di connessione API.
Le importazioni pianificate non si avviano dopo aver abilitato la pianificazione.	WP-Cron è disabilitato o limitato sull'host.	Configurare un cron job di sistema (server cron) puntando all'endpoint REST del plugin. Vedere Configurazione del server cron e Errori di cron.
La prima importazione in produzione elimina veicoli che dovrebbero ancora esistere.	Full Sync è stato abilitato prima che l'inventario importato fosse confermato come completo.	Disabilitare Full Sync, ripristinare i veicoli interessati dal backup e riabilitare Full Sync solo dopo aver osservato un ciclo di importazione completo e andato a buon fine.
Le pagine dei veicoli vengono visualizzate senza immagini, o le immagini appaiono gradualmente.	La coda delle immagini è in fase di elaborazione in background (comportamento previsto) o i timeout di PHP interrompono i download.	Monitorare lo stato della coda delle immagini su System & Help; avviare Run image queue now. Vedere Errori di importazione delle immagini e Manutenzione della coda delle immagini.
Le email dei lead non vengono recapitate.	Il sito non riesce a inviare email, l'indirizzo del destinatario è errato o l'host blocca l'SMTP in uscita.	Verificare l'email del destinatario sotto Leads e la configurazione della posta in uscita del sito. Vedere Errori relativi a email e lead.
Le pagine memorizzate nella cache continuano a mostrare il vecchio inventario dei veicoli.	La cache della pagina o la CDN sta servendo contenuti obsoleti.	Configurare l'invalidazione della cache o TTL più brevi per gli URL interessati.
I visitatori atterrano su URL di staging dopo il lancio.	Collegamenti obsoleti, URL del sito WordPress errato o DNS non ancora propagato.	Confermare le opzioni WordPress Indirizzo sito (URL) e Indirizzo WordPress (URL), e verificare la propagazione del DNS per il dominio di produzione.

Per una diagnostica più ampia basata sui sintomi, consultare la sezione Risoluzione dei problemi.