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

  1. Aprire ADP Car Market Hub → Dashboard.
  2. 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.
  3. 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.
  4. 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

  1. Aprire ADP Car Market Hub → Logs.
  2. 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.
  3. 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).
  4. Un pannello degli errori vuoto rappresenta lo stato di salute previsto.

3. Esaminare i nuovi lead

  1. Aprire ADP Car Market Hub → Leads (o navigare alla scheda Leads all'interno dell'amministrazione del plugin).
  2. Esaminare tutti i lead con stato Nuovo arrivati dal giorno precedente.
  3. Assegnare uno stato (Contattato, Chiuso o Spam) ai lead elaborati in modo che la coda rimanga gestibile.
  4. 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

  1. Aprire ADP Car Market Hub → System & Help.
  2. 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.
  3. 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

  1. Aprire ADP Car Market Hub → System & Help.
  2. La riga dello stato della connessione conferma se il plugin è in grado di raggiungere l'API di AutoScout24 con le credenziali attualmente configurate.
  3. Uno stato di Connesso a AutoScout24 – token valido e API raggiungibile rappresenta lo stato di salute previsto.
  4. 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'impostazioneOpzione pertinenteScopo
Scheda Riferimento a importazione e limitiImportazione automatica abilitataAbilita o disabilita le importazioni pianificate automatiche
Scheda Riferimento a importazione e limitiPianificazioneFrequenza di importazione (oraria, ogni 6 ore, due volte al giorno, giornaliera o intervallo personalizzato)
Scheda Riferimento a importazione e limitiNumero massimo di veicoli per esecuzioneLimita il numero di veicoli elaborati in una singola esecuzione cron (0 = illimitato)
Scheda Riferimento a importazione e limitiModalità coda immaginiSe abilitata, solo la prima immagine viene scaricata immediatamente; le immagini rimanenti vengono messe in coda
Scheda ImpostazioniEmail del destinatario del leadIndirizzo email di override per le notifiche dei lead
Scheda LogsRegistrazione dettagliataSe 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 .htaccess e un file index.php silenzioso.
  • 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

SintomoCausa probabileControllo
L'ora dell'ultima importazione è più vecchia del previstoWP-Cron non si attiva o il sito ha un traffico ridottoEsaminare la modalità cron nella scheda System & Help; valutare il passaggio al cron del server
Errori nel log dopo un'importazioneCredenziali API scadute o non valide, o problema di reteControllare lo stato della connessione API nella scheda System & Help; verificare le credenziali in Impostazioni
Non compare alcun nuovo lead nonostante l'attività dei visitatoriModulo di contatto non configurato o invio email non riuscitoTestare il modulo di contatto manualmente; controllare l'impostazione dell'email del destinatario del lead
La coda delle immagini cresce ma non diminuisceL'hook cron della coda delle immagini non è in esecuzioneAttivare 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 obsoletiCache transitoriaAttendere tre minuti affinché la cache di tre minuti scada, quindi ricaricare

Documenti correlati