Documentazione · Iniziare

Lista di controllo per la messa online

Questo documento rappresenta 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 sta promuovendo 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 importante aggiornamento del plugin.

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

Panoramica

La messa in servizio in produzione per ADP Car Market Hub non è una singola azione — l'abilitazione degli importi automatici è l'ultimo* passaggio di una catena che dipende da:

Prontezza dell'ambiente di hosting e PHP.
Credenziali API corrette e di proprietà del concessionario.
Un Test di connessione andato a buon fine e ripetibile e almeno un importo di prova riuscito.
Un frontend che sia stato revisionato rispetto ai dati reali dei veicoli importati.
Impostazioni legali, sulla privacy e sul consenso che corrispondano alle politiche pubblicate dal concessionario.
Un percorso di rollback documentato se qualcosa dovesse fallire 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 gli importi 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 la Guida all'installazione).
Esiste un ambiente di staging configurato e la stessa configurazione è stata replicata in produzione (vedi Migrazione da staging a live).
Le credenziali API per l'account del concessionario sono disponibili attraverso un canale sicuro (vedi Configurazione delle credenziali API, Configurazione API AutoScout24, Credenziali API esterne).
Il sito dispone di un backup recente e ripristinabile che include il database e wp-content/.
Le parti interessate (concessionario, agenzia, hosting) hanno concordato una finestra temporale di messa in servizio in cui monitorare i primi importi.

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 del 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 i log del plugin.
[ ] È disponibile spazio su disco sufficiente per la libreria multimediale prevista (immagini dei veicoli importate, incluse 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 "Licenza richiesta", 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.
[ ] I campi API Base URL, Seller ID (uno o più), Client ID e Client Secret sono compilati su Settings.
[ ] La valuta predefinita corrisponde alla valuta dei prezzi del concessionario.
[ ] Le opzioni relative alle 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 che vengano create le pagine Cars, Compare Cars e Favorites) o gestita esplicitamente tramite le pagine del concessionario utilizzando gli shortcode documentati.
[ ] I filtri, le mappature, il design, gli stili e qualsiasi personalizzazione del layout sono stati verificati 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, utilizzando le 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, la ripresa e l'annullamento se necessario.
[ ] Il numero di veicoli importati corrisponde alle aspettative per i Seller ID configurati (verificare 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.
[ ] La sincronizzazione completa (Full Sync) viene abilitata solo dopo che l'importazione di prova ha confermato che tutti i veicoli previsti arrivano correttamente. La sincronizzazione completa elimina in modo permanente gli articoli dei veicoli locali e le relative immagini per qualsiasi annuncio non più restituito dall'API.

5. Pianificazione e 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), è configurato un vero cron job di sistema sul server che punta all'endpoint REST protetto da token del plugin. Vedi Configurazione del cron del server e Cron ed elaborazione in background.
[ ] La coda delle immagini è abilitata per mantenere le esecuzioni del 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 del cron) sono dimensionate per il catalogo e per 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 utente

[ ] La pagina d'archivio Cars viene visualizzata correttamente con veicoli reali, inclusi filtri, paginazione, ordinamento e miniature delle immagini.
[ ] Almeno una pagina del singolo veicolo è stata esaminata interamente: 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 abilitata (calcolatore di finanziamento, modulo di richiesta prova su strada, condivisione social).
[ ] L'invio di un modulo di contatto di prova appare sotto Car Market Hub → Leads e attiva l'email del destinatario configurato.
[ ] Se gli avvisi di ricerca sono abilitati, è stata completata un'iscrizione di prova, inclusa l'email di conferma Double-Opt-In. Vedi Double Opt-In per gli avvisi di ricerca.
[ ] Se l'AI Assistant è abilitato, i testi generati dall'intelligenza artificiale su almeno un veicolo sono stati esaminati e risultano accettabili per la pubblicazione.
[ ] Le traduzioni / stringhe di testo sul frontend riflettono la lingua del sito; le stringhe mancanti sono state gestite tramite il flusso di lavoro di traduzione standard di WordPress. Vedi Guida alla traduzione e a PoEdit.

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 analitici opzionali, iscrizioni opzionali agli avvisi di ricerca). Vedi Note su GDPR / DSGVO e Panoramica sulla conservazione dei dati.
[ ] 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 Dati dei lead e consenso.
[ ] Se la prenotazione della prova su strada è abilitata, i giorni della settimana disponibili, la fascia oraria giornaliera, la durata dello slot e le date di chiusura riflettono l'effettiva disponibilità della concessionaria.
[ ] La concessionaria ha accettato che i dati dei lead importati 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, caching e SEO

[ ] Qualsiasi cache di pagina o di oggetti (cache lato server, CDN, plugin di caching) è 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 amministrative non vengano servite dalla cache.
[ ] Se una CDN distribuisce 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 Indirizzo sito / Indirizzo WordPress in 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'esplicita intenzione della concessionaria).
[ ] Esiste una sitemap XML (fornita dal core di WordPress o da un plugin SEO) e i nuovi URL dei 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 dei log è stato compreso. La directory dei log wp-content/uploads/as24ci-logs/ è scrivibile. Vedi Log e monitoraggio.
[ ] È stato concordato con il cliente un programma per i controlli di routine: revisione giornaliera dei lead e delle importazioni (Operatività quotidiana), Manutenzione settimanale e Manutenzione mensile.
[ ] Il Monitoraggio delle importazioni e la Manutenzione della coda delle immagini sono compresi da chiunque gestirà il sito.
[ ] Una procedura di backup e ripristino è documentata ed è stata testata almeno una volta. Vedi Backup e ripristino.
[ ] Il canale di aggiornamento del plugin è concordato (caricamento amministrativo di un nuovo file ZIP o sostituzione tramite SFTP della cartella del plugin) e corrisponde al Processo di aggiornamento.
[ ] Esiste un piano di rollback documentato: come disabilitare la pianificazione, come disattivare il plugin senza perdere dati e come ripristinare da un backup se necessario.
[ ] L'operatività quotidiana è stata delegata agli utenti appropriati tramite i ruoli e i permessi del plugin. Vedi Controllo degli accessi e permessi.
[ ] 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 segnalazioni ad AD Promotion se necessario.
[ ] Le informazioni necessarie per aprire un ticket di supporto sono note in anticipo. Vedi Lista di controllo per le informazioni di supporto.

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 finale di integrità.
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: vedi Configurazione delle credenziali API.
Pianificazione e limiti di importazione: vedi Prima configurazione (Passo 5) e Cron ed elaborazione in background.
Campi dei lead e del consenso: vedi Dati dei lead e consenso.
Cron del server e trigger esterni: vedi Configurazione del cron del server.

Note operative

Reversibilità. Disabilitare la pianificazione automatica su Import & Limits arresta i nuovi importi senza rimuovere i veicoli già importati. La disattivazione del plugin ne disabilita le funzionalità ma mantiene i veicoli importati, le opzioni, i lead e i dati analitici nel database. I dati vengono rimossi all'arresto/disinstallazione solo quando è abilitata la corrispondente impostazione di pulizia. Vedere Disinstallazione e pulizia dei dati.
Full Sync al lancio. In genere è più sicuro lanciare con Full Sync disabilitato, osservare un ciclo di importazione completo e abilitare Full Sync solo quando l'inventario importato è costantemente completo. Abilitare Full Sync prematuramente può eliminare definitivamente i veicoli che erano semplicemente mancanti da una risposta API transitoria. Verificare questo comportamento nella versione corrente del plugin prima della pubblicazione in caso di dubbi.
Modifiche a domini e 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 caching 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 lanci delicati, considerare l'abilitazione delle 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 responsabilità.

Risoluzione dei problemi

Sintomo al go-live	Causa probabile	Cosa controllare
Il Test di connessione fallisce in produzione ma è passato in staging.	Le credenziali di produzione differiscono, la rete di produzione è più restrittiva o il server di produzione ha un bundle CA diverso.	Reinserire le credenziali, confermare l'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 sta elaborando 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 può 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 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.	Link obsoleti, URL del sito WordPress errato o DNS non ancora propagato.	Confermare le opzioni Indirizzo sito (URL) e Indirizzo WordPress (URL) di WordPress, e verificare la propagazione del DNS per il dominio di produzione.

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