Flussi di lavoro per l'uso quotidiano

Questo documento descrive i flussi di lavoro operativi che gli amministratori e il personale della concessionaria eseguono regolarmente per gestire l'inventario dei veicoli tramite il plugin ADP Car Market Hub. Copre il controllo delle importazioni, la revisione dei lead, la convalida del frontend e il monitoraggio dello stato del sistema.

Quando utilizzare questo documento

Leggi questo documento se:

• Sei responsabile del funzionamento quotidiano o settimanale di un sito di annunci di veicoli gestito da questo plugin.
• Hai bisogno di una lista di controllo pratica per verificare che le importazioni siano state eseguite correttamente, che i lead vengano ricevuti e che il frontend mostri correttamente l'inventario.
• Desideri capire cosa cercare e dove guardare quando qualcosa sembra non funzionare.

Per la guida completa alla configurazione e all'installazione, consulta il Manuale dell'amministratore.

---

Panoramica

In condizioni operative normali, il plugin ADP Car Market Hub funziona in modo ampiamente automatico. L'importatore pianificato recupera i dati aggiornati dei veicoli dall'API di AutoScout24 a intervalli configurati, scarica le immagini in una coda in background e mantiene l'inventario di WordPress sincronizzato con l'annuncio attivo.

Tuttavia, il personale operativo dovrebbe verificare regolarmente che:

1. I cicli di importazione vengano completati con successo.
2. I nuovi veicoli e quelli aggiornati siano visibili sul frontend.
3. I lead dei clienti vengano ricevuti ed elaborati.
4. Il registro del plugin non contenga errori non risolti.
5. La coda delle immagini non stia accumulando un arretrato significativo.

---

Flusso di lavoro 1: Controllo dello stato dell'importazione

Esegui questo controllo quotidianamente o dopo ogni ciclo di importazione pianificato.

Passaggi

1. Accedi alla bacheca di amministrazione di WordPress.
2. Naviga su ADP Car Market Hub → Dashboard.
3. Esamina la riga dei KPI: - Controlla Veicoli totali per confermare che il conteggio dell'inventario sia quello previsto. - Controlla Nuovi (ultimi 7 giorni) per vedere quanti veicoli sono stati aggiunti di recente.
4. Esamina il grafico Andamento dell'inventario per confermare che i cicli di importazione abbiano prodotto risultati nell'ultima settimana.
5. Esamina la sezione Richiede attenzione per eventuali problemi da risolvere, come veicoli senza immagini o descrizioni brevi mancanti.
6. Naviga su ADP Car Market Hub → Importazione e limiti.
7. Verifica l'ora dell'ultima importazione e lo stato dell'ultima importazione visualizzati nella scheda. Conferma che l'esecuzione più recente si sia completata senza errori.
8. Se l'ora dell'ultima esecuzione appare inaspettatamente vecchia (ad esempio, più di 24 ore fa con una pianificazione oraria), controlla se il cron è in esecuzione. Vedi il flusso di lavoro Verifica dello stato del cron di seguito.

Cosa cercare

• Il timestamp dell'ultima importazione deve essere in linea con la pianificazione configurata (ad esempio, all'incirca ogni ora per una pianificazione oraria).
• Il numero di veicoli importati deve riflettere il tuo inventario di AutoScout24.
• Nessun avviso di errore persistente nella scheda Importazione e limiti.

---

Flusso di lavoro 2: Revisione del registro del plugin

Esegui questo controllo quotidianamente o immediatamente quando si sospetta un errore di importazione.

Passaggi

1. Naviga su ADP Car Market Hub → Log.
2. Esamina il pannello Errori recenti nella parte superiore della pagina. Questo mostra le voci di registro di livello errore più recenti dalle ultime 2.000 righe del file di log.
3. Esamina il pannello Avvisi recenti per problemi non critici che potrebbero comunque richiedere attenzione.
4. Se sono presenti errori o avvisi, annota i relativi timestamp e contenuti.
5. Scorri verso il basso fino al Visualizzatore di log per vedere il file di log non elaborato e cercare il contesto relativo a voci specifiche.
6. Regola il campo Righe se hai bisogno di visualizzare una cronologia più ampia, quindi fai clic su Ricarica.

Pattern di log comuni da monitorare

Se identifichi errori che non possono essere risolti esaminando le impostazioni, esporta il file di diagnostica dalla scheda Strumenti e contatta il supporto.

---

Flusso di lavoro 3: Revisione e gestione dei lead

Esegui questo controllo quotidianamente o con una frequenza adeguata al volume delle tue richieste.

Passaggi

1. Naviga su ADP Car Market Hub → Lead.
2. Esamina l'elenco dei lead. I nuovi lead hanno lo stato Nuovo.
3. Per ogni nuovo lead: - Controlla il nome del cliente, l'indirizzo email, il numero di telefono e il messaggio. - Nota a quale veicolo si riferisce la richiesta. Il riferimento dell'annuncio rimanda alla pagina di dettaglio di AutoScout24, se disponibile. - Contatta il cliente tramite il tuo normale processo di vendita. - Dopo aver contattato il cliente, cambia lo stato del lead in Contattato. - Dopo aver completato l'interazione di vendita, cambia lo stato in Chiuso o Spam, a seconda dei casi.
4. Se hai bisogno di condividere i lead con un altro sistema (ad esempio, un CRM), fai clic su Esporta CSV per scaricare tutti i lead attualmente visibili come file CSV. Applica prima eventuali filtri di ricerca se desideri esportare solo un sottoinsieme.
5. Elimina i lead che sono confermati come spam o che non sono più necessari per mantenere l'elenco gestibile.

Note

• Le modifiche allo stato dei lead vengono salvate immediatamente quando si seleziona un nuovo stato.
• L'esportazione CSV include tutti i lead che corrispondono allo stato di ricerca/filtro corrente, o tutti i lead se nessun filtro è attivo.
• I lead sono memorizzati come post WordPress. Non vengono inoltrati automaticamente a sistemi esterni a meno che non sia stato configurato un webhook o un'integrazione separatamente.
• Le richieste di test drive inviate tramite la funzionalità Test Drive vengono registrate anch'esse come lead se la funzionalità Test Drive è abilitata.

---

Flusso di lavoro 4: Verifica dello stato di salute del sistema e del cron

Esegui questo controllo settimanalmente o immediatamente dopo un sospetto errore di pianificazione.

Passaggi

1. Naviga su ADP Car Market Hub → Sistema e aiuto.
2. Esamina gli indicatori di controllo dell'ambiente: - Versione PHP – deve essere 8.1 o successiva. - Limite di memoria – si consigliano 256 MB o più. - Tempo massimo di esecuzione – si consigliano 60 secondi o più. - Cartella dei caricamenti – deve essere scrivibile per le importazioni di immagini. - cURL e OpenSSL – devono essere presenti per le chiamate API. - GD o Imagick – richiesti se la conversione WebP è abilitata.
3. Esamina l'indicatore dello Stato della pianificazione Cron: - Se utilizzi WP-Cron, questo mostra se un evento pianificato è registrato e quando è prevista la prossima esecuzione. - Se utilizzi il cron del server, conferma che il tuo processo cron esterno sia configurato e in esecuzione separatamente.
4. Esamina lo Stato della coda delle immagini: - Una dimensione ridotta della coda (0–50) è normale. - Una dimensione della coda superiore a 1.000 attiva un badge di avviso. Ciò potrebbe indicare che il worker della coda delle immagini non è in esecuzione o sta accumulando ritardo. - Se la coda è grande, utilizza il pulsante Esegui coda immagini ora per elaborarla immediatamente.
5. Esamina il risultato del Test di connessione API. Fai clic sul pulsante di test, se disponibile, per confermare che l'API sia raggiungibile con le credenziali correnti.
6. Se un indicatore si trova in uno stato di avviso (giallo) o di errore (rosso), consulta la sezione corrispondente nel Manuale dell'amministratore o la sezione Risoluzione dei problemi di seguito.

---

Flusso di lavoro 5: Convalida dell'inventario sul frontend

Esegui questo controllo dopo ogni ciclo di importazione significativo o settimanalmente durante il normale funzionamento.

Passaggi

1. Apri la pagina dell'archivio veicoli del tuo sito in un browser (senza aver effettuato l'accesso come amministratore di WordPress, o utilizzando una finestra privata/in incognito per vedere la vista pubblica).
2. Verifica che i veicoli siano visualizzati nella griglia dell'archivio con immagini, titoli, prezzi e specifiche chiave.
3. Applica uno o più controlli di filtro (ad esempio, filtra per marca o tipo di carburante) e conferma che i risultati si aggiornino correttamente.
4. Fai clic su un singolo veicolo per aprire la sua pagina di dettaglio.
5. Verifica che la pagina di dettaglio mostri: - Almeno un'immagine (o la galleria di immagini se sono state importate più immagini). - La tabella delle specifiche del veicolo (marca, modello, anno, chilometraggio, prezzo, motore, ecc.). - L'elenco degli equipaggiamenti (se applicabile). - La descrizione del veicolo. - Il modulo di contatto. - Il calcolatore di finanziamento (se abilitato). - Il modulo di richiesta test drive (se abilitato).
6. Invia una richiesta di prova tramite il modulo di contatto e conferma: - Che la conferma di ringraziamento venga mostrata sulla pagina. - Che un lead appaia in ADP Car Market Hub → Lead entro pochi secondi. - Che l'email di notifica venga ricevuta dall'indirizzo del destinatario configurato (se l'invio delle email funziona sul tuo server).
7. Se i veicoli mancano dall'archivio o la pagina di dettaglio è incompleta, controlla la scheda Log per verificare la presenza di errori e verifica lo stato del post del veicolo in CMH Cars → All Cars.

Verifica dello stato del post del veicolo

1. Naviga su CMH Cars → All Cars nella barra laterale di amministrazione di WordPress.
2. Cerca il titolo del veicolo specifico o utilizza i link di stato (Tutti / Pubblicati / Bozze) sopra l'elenco.
3. Conferma che il post sia pubblicato (stato: Pubblicato).
4. Se il post è in stato Bozza, pubblicalo manualmente o modifica lo Stato predefinito del post in Impostazioni su publish per le importazioni future.

---

Flusso di lavoro 6: Avvio di un'importazione manuale

Utilizza questo flusso di lavoro quando hai bisogno di aggiornare immediatamente l'inventario al di fuori della pianificazione automatica, ad esempio dopo aver aggiunto nuovi veicoli al tuo account AutoScout24.

Passaggi

1. Naviga su ADP Car Market Hub → Importazione e limiti.
2. Fai clic sul pulsante Avvia ora per avviare un ciclo di importazione immediato.
3. Per un'importazione completa con monitoraggio dello stato di avanzamento, utilizza il Batch-Wizard: - La barra di avanzamento mostra i veicoli elaborati, il tempo rimanente stimato e l'azione corrente. - Puoi mettere in pausa, riprendere o interrompere la procedura guidata in qualsiasi momento.
4. Al termine dell'importazione, esamina il riepilogo dello stato per verificare il numero di veicoli aggiunti, aggiornati o saltati.
5. Verifica i risultati controllando la Dashboard e la pagina dell'archivio sul frontend.

Note

• Gli avvii manuali e il pianificatore cron automatico condividono lo stesso blocco di importazione. Se un ciclo pianificato è già in corso quando fai clic su Avvia ora, l'avvio manuale verrà saltato.
• I cicli di importazione avviati tramite il Batch-Wizard elaborano un veicolo alla volta per impostazione predefinita. Ciò previene errori di timeout su server con limiti di tempo di esecuzione restrittivi.

---

Flusso di lavoro 7: Controllo dei veicoli con problemi di qualità

Esegui questo controllo periodicamente per mantenere la qualità dell'inventario.

Passaggi

1. Naviga su ADP Car Market Hub → Dashboard.
2. Esamina la sezione Idoneità del veicolo, che evidenzia: - Veicoli senza immagini. - Veicoli con descrizioni insolitamente brevi.
3. Per ogni veicolo interessato, fai clic sul post del singolo veicolo per indagare.
4. Se mancano le immagini: - Controlla se la coda delle immagini presenta un arretrato (Sistema e aiuto → Stato della coda delle immagini). - Esegui manualmente la coda delle immagini se necessario. - Controlla la scheda Log per verificare la presenza di errori di download delle immagini.
5. Se le descrizioni sono brevi o mancanti: - Esamina l'annuncio originale su AutoScout24. - Se l'AI Assistant è abilitato, utilizzalo per generare una descrizione per il veicolo. - In alternativa, modifica manualmente il post del veicolo per aggiungere o migliorare la descrizione.

---

Note operative

• Caching della dashboard: I dati della dashboard vengono memorizzati nella cache per circa 3 minuti. Ricarica la pagina per vedere i dati più recenti dopo un'importazione.
• Rilevamento delle modifiche: L'importatore utilizza gli hash dei contenuti e delle immagini per saltare i veicoli non modificati. Un numero elevato di voci "saltate" nel registro è normale e significa che l'importazione funziona in modo efficiente.
• ID venditore multipli: Se sono configurati più ID venditore, l'importazione viene eseguita per ciascun venditore a turno. Gli errori di un venditore non bloccano le importazioni per gli altri venditori.
• Livello di dettaglio del registro di importazione: La registrazione dettagliata, se abilitata, scrive nel registro voci molto dettagliate per singolo veicolo. Questo è utile per il debug ma aumenta le dimensioni del registro. Disabilitala durante il normale funzionamento.

---

---

Risoluzione dei problemi

---

Documenti correlati

• Manuale utente
• Manuale dell'amministratore
• Flusso di lavoro per l'importazione dei veicoli
• Flusso di lavoro per la gestione dei lead
• Flusso di lavoro per l'utilizzo del frontend