Documentazione · Operazioni e manutenzione
Manutenzione settimanale
Questo documento descrive le attività di manutenzione che dovrebbero essere eseguite una volta alla settimana su un sito di produzione in cui è in esecuzione il plugin ADP Car Market Hub. Queste attività vanno più in profondità rispetto ai controlli giornalieri e sono progettate per mantenere l'inventario, i log e la configurazione in ottimo stato nel tempo.
Quando utilizzare questo documento
Leggere questo documento se si gestisce un sito live che utilizza il plugin e si desidera mantenere un'installazione stabile e ben monitorata. La manutenzione settimanale viene in genere eseguita da un amministratore del sito o da un referente IT della concessionaria.
Panoramica
I controlli giornalieri confermano che i processi in background siano in esecuzione. La manutenzione settimanale esamina i risultati di tali processi in modo più dettagliato: volume dei log, qualità dell'importazione, stato della pipeline dei lead, tendenze di analytics e affidabilità del cron. Offre inoltre l'opportunità di agire su eventuali problemi che si sono accumulati nel corso della settimana.
Requisiti
- Account amministratore con la funzionalità
manage_as24_imports. - Accesso a WordPress Admin → ADP Car Market Hub.
- Accesso alla bacheca di amministrazione di WordPress (Bacheca → In sintesi o al widget della bacheca del plugin stesso, se abilitato).
Attività settimanali
1. Esaminare il log di importazione completo
- Aprire ADP Car Market Hub → Logs.
- Impostare il campo Righe su un valore più alto (ad esempio, 500 o 1000) e fare clic su Ricarica per visualizzare una cronologia più ampia.
- Cercare pattern ricorrenti: errori ripetitivi, fallimenti API continui o Listing ID che falliscono costantemente.
- Se il file di log è molto grande, valutare se la registrazione dettagliata (verbose logging) debba rimanere abilitata. La registrazione dettagliata (configurabile nell'area Logs o Impostazioni) registra una riga per ogni veicolo e per ogni azione sulle immagini. Su cataloghi di grandi dimensioni, ciò può generare un volume di log significativo.
- Se i vecchi errori sono stati risolti, svuotare il file di log utilizzando il pulsante Svuota file di log per iniziare con una base pulita per la settimana successiva.
2. Verificare i conteggi di importazione
- Aprire ADP Car Market Hub → Riferimento a importazione e limiti e verificare il riepilogo dello Stato dell'ultima esecuzione (inseriti, aggiornati, saltati, errori).
- Confrontare il conteggio totale dei veicoli locali (mostrato nella riga KPI della Dashboard) con quello previsto in base all'inventario degli annunci di AutoScout24.
- Se il conteggio locale è inferiore al previsto, verificare se l'opzione Sincronizzazione completa è abilitata (sotto le impostazioni di Automazione / Importazione). Quando è abilitata, i veicoli che non sono più presenti nell'elenco di AutoScout24 vengono eliminati automaticamente dal sito locale dopo ogni importazione. Se i veicoli vengono eliminati in modo imprevisto, verificare se questa impostazione è appropriata per il proprio flusso di lavoro.
- Verificare se vi sono veicoli bloccati nello stato di bozza quando invece dovrebbero essere pubblicati. Lo stato predefinito dell'articolo è configurato in Impostazioni → Stato predefinito dell'articolo.
3. Valutare e gestire i lead
- Aprire ADP Car Market Hub → Leads.
- Esaminare i lead che non sono ancora stati elaborati. Contrassegnarli come Contattato, Chiuso o Spam a seconda dei casi.
- Se compare un numero elevato di lead di spam, valutare la possibilità di rivedere la configurazione del modulo di contatto. Nelle impostazioni del modulo lead è disponibile una casella di controllo per il consenso GDPR.
- Verificare che le email di notifica dei lead raggiungano il destinatario corretto. Controllare l'impostazione Email del destinatario dei lead se le email vengono inviate all'indirizzo errato.
4. Controllare le tendenze di analytics (se analytics è abilitato)
- Aprire ADP Car Market Hub → Analytics.
- Esaminare il selettore del periodo (7, 14, 30, 90 o 180 giorni) e analizzare le tendenze delle visualizzazioni di pagina, i veicoli con le migliori prestazioni e tutti gli eventi di Business Intelligence (ricerche con filtri, aperture del modulo di contatto, lead inviati).
- Identificare gli annunci con visualizzazioni insolitamente basse. Questi potrebbero trarre vantaggio da miglioramenti dei contenuti, immagini migliori o adeguamenti dei prezzi.
- Confermare che i dati di analytics vengano raccolti. Se il pixel di tracciamento non si attiva, verificare che Analytics sia abilitato nelle impostazioni della scheda Analytics e che un plugin di gestione del consenso (se in uso) non stia bloccando l'endpoint di tracciamento.
5. Verificare l'affidabilità del cron
- Aprire ADP Car Market Hub → System & Help.
- Esaminare l'indicatore di stato del Cron esterno se si utilizza la modalità cron del server. Il plugin registra il timestamp dell'ultimo ping esterno. Se l'ultimo ping è più vecchio del previsto, verificare la configurazione del processo cron del server.
- Confermare che la pianificazione dell'importazione nella scheda Riferimento a importazione e limiti corrisponda ai requisiti operativi. Le pianificazioni disponibili includono: ogni ora, ogni 6 ore, due volte al giorno, giornaliera e un intervallo personalizzato configurabile (minimo 15 minuti).
- Se le importazioni sono in esecuzione ma i download delle immagini sono in ritardo, valutare se la dimensione del batch o la frequenza del cron della Coda immagini necessitano di modifiche.
6. Esaminare la coda delle immagini
- Aprire ADP Car Market Hub → System & Help.
- Ispezionare la dimensione corrente della coda delle immagini. Un sito in salute mostrerà una coda piccola o vuota.
- Se la coda è cresciuta durante la settimana, utilizzare il pulsante Avvia coda immagini ora nella scheda Riferimento a importazione e limiti per elaborarla, quindi verificare se il worker della coda immagini è pianificato correttamente.
- Il worker della coda immagini elabora 30 immagini per batch per impostazione predefinita. Sui siti con cataloghi di grandi dimensioni, potrebbero essere necessarie più esecuzioni consecutive.
Note operative
- La rotazione dei log avviene automaticamente quando il file di log supera i 10 MB. I log archiviati vengono eliminati dopo 7 giorni. Se si desidera conservare i log più a lungo, scaricare o copiare i file di log archiviati prima che vengano eliminati.
- La tabella di analytics (
{prefix}as24ci_analytics) viene ripulita automaticamente da un processo WP-Cron giornaliero in base al periodo di Conservazione dei dati di analytics configurato (predefinito 180 giorni). Verificare questo periodo di conservazione nelle impostazioni della scheda Analytics. - Le esecuzioni di importazione pianificate acquisiscono un blocco temporaneo (transient lock) che viene rilasciato automaticamente al completamento dell'importazione. Se un blocco persiste per più di 40 minuti, viene rimosso automaticamente al successivo tentativo di esecuzione.
- Il plugin registra il timestamp dell'ultima esecuzione dell'importazione nella tabella delle opzioni di WordPress (
as24ci_last_run_time). Questo valore viene utilizzato per mostrare l'indicatore dell'ultima esecuzione nella Dashboard e nelle schede Riferimento a importazione e limiti.
Risoluzione dei problemi
| Sintomo | Causa probabile | Verifica |
|---|---|---|
| Il file di log cresce molto rapidamente | Registrazione dettagliata abilitata su un catalogo di grandi dimensioni | Disabilitare la registrazione dettagliata nelle Impostazioni o nella scheda Logs |
| I veicoli scompaiono dal sito | Sincronizzazione completa abilitata; veicoli rimossi da AutoScout24 | Verificare l'impostazione Sincronizzazione completa nella scheda Riferimento a importazione e limiti; confermare che sia intenzionale |
| Il conteggio dei lead non corrisponde al volume delle richieste | L'invio delle email fallisce silenziosamente | Verificare la configurazione email di WordPress; verificare l'email del destinatario dei lead |
| Analytics non mostra dati | Tracciamento di analytics disabilitato o gestione del consenso che blocca gli eventi | Abilitare analytics nella scheda Analytics; controllare le impostazioni CMP/consenso |
| Il cron non viene eseguito come pianificato | WP-Cron disabilitato o il sito ha un traffico ridotto; cron del server non configurato | Controllare lo stato del cron nella scheda System & Help; passare alla modalità cron del server se necessario |