Documentazione · Operazioni e manutenzione
Operatività quotidiana
Questo documento descrive i controlli quotidiani di routine che un amministratore del sito o un gestore della concessionaria dovrebbe eseguire per confermare che il plugin ADP Car Market Hub funzioni correttamente su un sito WordPress in produzione.
Quando utilizzare questo documento
Leggere questo documento se si è responsabili della gestione quotidiana di un sito attivo che utilizza il plugin per importare e visualizzare gli annunci di veicoli da AutoScout24. Questi controlli sono progettati per essere completati rapidamente e per individuare i problemi prima che interessino i visitatori o i lead.
Panoramica
Il plugin esegue i processi di importazione automaticamente utilizzando WP-Cron o un cron del server esterno, scarica le immagini dei veicoli in modo asincrono tramite una coda di immagini e memorizza gli eventi dei visitatori e le richieste dei clienti nel database di WordPress. I controlli quotidiani confermano che questi processi in background funzionino come previsto e che non si siano accumulati errori.
Il pannello di amministrazione di WordPress fornisce una scheda Dashboard e una scheda Logs che mostrano i dati operativi più rilevanti in un unico posto.
Requisiti
- Account amministratore con la funzionalità
manage_as24_imports, che viene concessa agli amministratori di WordPress all'attivazione del plugin. - Accesso a Amministrazione di WordPress → ADP Car Market Hub (il menu di amministrazione del plugin).
Controlli quotidiani
1. Confermare l'ultima esecuzione dell'importazione
- Aprire ADP Car Market Hub → Dashboard.
- Individuare la riga dei KPI. Mostra il numero totale di veicoli importati, i nuovi veicoli aggiunti negli ultimi sette giorni e il timestamp dell'esecuzione dell'importazione più recente.
- Verificare che il timestamp dell'ultima importazione corrisponda alla pianificazione prevista. Se l'importazione non è stata eseguita dall'ultimo intervallo previsto, verificare le impostazioni di automazione o la configurazione del cron.
- Per ulteriori dettagli, aprire ADP Car Market Hub → Riferimento a importazione e limiti e controllare l'ora di Ultima esecuzione e lo Stato dell'ultima esecuzione (inseriti, aggiornati, saltati, errori).
2. Controllare la presenza di errori di importazione
- Aprire ADP Car Market Hub → Logs.
- Il pannello Errori recenti mostra le voci di livello di errore più recenti dal file di log corrente. Se sono presenti errori, leggerli e verificarne la causa.
- Il pannello Avvisi recenti mostra le voci di livello di avviso che potrebbero indicare un funzionamento degradato (ad esempio, errori parziali delle immagini o risposte di limite di frequenza dell'API).
- Un pannello degli errori vuoto rappresenta lo stato di salute previsto.
3. Esaminare i nuovi lead
- Aprire ADP Car Market Hub → Leads (o navigare alla scheda Leads all'interno dell'amministrazione del plugin).
- Esaminare tutti i lead con stato Nuovo arrivati dal giorno precedente.
- Assegnare uno stato (Contattato, Chiuso o Spam) ai lead elaborati in modo che la coda rimanga gestibile.
- Verificare che le email di notifica dei lead siano state recapitate controllando la casella di posta dell'indirizzo del destinatario configurato. Il destinatario è impostato in Impostazioni → Email del destinatario del lead.
4. Verificare la coda delle immagini
- Aprire ADP Car Market Hub → System & Help.
- Individuare la sezione della coda delle immagini. Quando la coda delle immagini è abilitata, le immagini rimanenti vengono elaborate in modo asincrono dopo ogni importazione. Un piccolo accumulo in coda è normale. Un accumulo molto grande o bloccato (la scheda System & Help mostra un avviso quando la coda supera la soglia configurata) potrebbe indicare che l'hook cron della coda delle immagini non si sta attivando.
- Se la dimensione della coda è inaspettatamente alta, utilizzare il pulsante Attiva coda immagini ora nella scheda Riferimento a importazione e limiti per elaborarla manualmente, quindi verificare la configurazione del cron.
5. Controllare la connessione API
- Aprire ADP Car Market Hub → System & Help.
- La riga dello stato della connessione conferma se il plugin è in grado di raggiungere l'API di AutoScout24 con le credenziali attualmente configurate.
- Uno stato di Connesso a AutoScout24 – token valido e API raggiungibile rappresenta lo stato di salute previsto.
- Se lo stato mostra un errore, verificare le impostazioni di Client ID, Client Secret e Seller ID in ADP Car Market Hub → Impostazioni.
Riferimento di configurazione
| Posizione dell'impostazione | Opzione pertinente | Scopo |
|---|---|---|
| Scheda Riferimento a importazione e limiti | Importazione automatica abilitata | Abilita o disabilita le importazioni pianificate automatiche |
| Scheda Riferimento a importazione e limiti | Pianificazione | Frequenza di importazione (oraria, ogni 6 ore, due volte al giorno, giornaliera o intervallo personalizzato) |
| Scheda Riferimento a importazione e limiti | Numero massimo di veicoli per esecuzione | Limita il numero di veicoli elaborati in una singola esecuzione cron (0 = illimitato) |
| Scheda Riferimento a importazione e limiti | Modalità coda immagini | Se abilitata, solo la prima immagine viene scaricata immediatamente; le immagini rimanenti vengono messe in coda |
| Scheda Impostazioni | Email del destinatario del lead | Indirizzo email di override per le notifiche dei lead |
| Scheda Logs | Registrazione dettagliata | Se abilitata, registra una riga per ogni veicolo e ogni azione sulle immagini |
Note operative
- Il plugin utilizza un blocco transitorio (
as24ci_cron_import_running) per impedire esecuzioni di importazione sovrapposte. Se un'esecuzione precedente si è interrotta in modo imprevisto, il blocco viene rimosso automaticamente dopo il suo TTL (40 minuti). - Il file di log è memorizzato nella directory uploads di WordPress sotto
as24ci-logs/adp-car-market-hub.log. La directory è protetta dall'accesso web pubblico tramite un file.htaccesse un fileindex.phpsilenzioso. - I file di log vengono ruotati automaticamente quando superano i 10 MB. Gli archivi ruotati vengono eliminati dopo 7 giorni.
- I dati della scheda Dashboard sono memorizzati nella cache per tre minuti. Se è stata appena avviata un'importazione manuale, attendere alcuni minuti prima di controllare i conteggi.
Risoluzione dei problemi
| Sintomo | Causa probabile | Controllo |
|---|---|---|
| L'ora dell'ultima importazione è più vecchia del previsto | WP-Cron non si attiva o il sito ha un traffico ridotto | Esaminare la modalità cron nella scheda System & Help; valutare il passaggio al cron del server |
| Errori nel log dopo un'importazione | Credenziali API scadute o non valide, o problema di rete | Controllare lo stato della connessione API nella scheda System & Help; verificare le credenziali in Impostazioni |
| Non compare alcun nuovo lead nonostante l'attività dei visitatori | Modulo di contatto non configurato o invio email non riuscito | Testare il modulo di contatto manualmente; controllare l'impostazione dell'email del destinatario del lead |
| La coda delle immagini cresce ma non diminuisce | L'hook cron della coda delle immagini non è in esecuzione | Attivare manualmente la coda delle immagini dalla scheda Riferimento a importazione e limiti; controllare lo stato di salute del cron del server o di WP-Cron |
| I conteggi della Dashboard sembrano obsoleti | Cache transitoria | Attendere tre minuti affinché la cache di tre minuti scada, quindi ricaricare |