Riferimento strumenti

Questo documento rappresenta il riferimento per la schermata Strumenti del plugin ADP Car Market Hub (Car Market Hub → Tools). Copre le esportazioni, la gestione della cache, la sincronizzazione delle tassonomie, il test di connessione API, i dati demo e il centro di diagnostica.

Quando utilizzare questo documento

Leggi questo documento se hai bisogno di:

• Esportare i dati dei veicoli importati per backup, audit o migrazione.
• Forzare il plugin a recuperare dati aggiornati dall'API di AutoScout24.
• Riassegnare i termini delle tassonomie (marca, modello, alimentazione, colore...) ai veicoli importati.
• Verificare che le credenziali API funzionino correttamente.
• Installare o rimuovere dati demo per una demo di vendita o un ambiente di staging.
• Eseguire una diagnostica mirata su un singolo articolo di veicolo o generare un'istantanea del sistema per il supporto.

Panoramica

La schermata Strumenti è la cassetta degli attrezzi operativi per gli amministratori. Raggruppa le azioni di manutenzione in schede indipendenti in modo che possano essere avviate senza lasciare la pagina:

• Configurazione guidata — apre la procedura guidata opzionale in sei passaggi Prima configurazione. Disponibile in qualsiasi momento, anche dopo che la procedura guidata è stata completata o saltata. Eseguirla nuovamente consente di riconfigurare la modalità di configurazione, il profilo del rivenditore, la connessione a AutoScout24, le pagine predefinite e le impostazioni predefinite delle funzionalità del frontend; le impostazioni esistenti vengono conservate a meno che non vengano modificate esplicitamente.
• Esporta veicoli — download in formato CSV o JSON dei dati dei veicoli importati. Questa scheda appare solo quando la funzione di esportazione è abilitata; può essere nascosta.
• Svuota cache — cancella la cache dei token OAuth2 e la cache dei modelli.
• Sincronizzazione tassonomie — riapplica i termini delle tassonomie dai valori memorizzati per ogni veicolo importato.
• Test di connessione API — esegue una richiesta in tempo reale verso AutoScout24 con le credenziali correnti.
• Dati demo — installa o rimuove un set contrassegnato di veicoli, lead, avvisi e dati analitici demo.
• Centro di diagnostica — diagnostica per singolo articolo, anteprima di simulazione (dry run) e un'istantanea del sistema in formato JSON.

Requisiti o prerequisiti

• Un utente con i permessi di gestione del plugin.
• Affinché il Test di connessione API e lo Svuotamento cache siano utili: credenziali API valide configurate in Impostazioni.
• Per la diagnostica su un singolo articolo: l'ID articolo di WordPress di un veicolo importato.

Istruzioni passo dopo passo

Esportare i veicoli importati

1. Apri Car Market Hub → Tools.
2. Nella scheda Esporta veicoli, fai clic su Esporta CSV per flussi di lavoro con fogli di calcolo, oppure su Esporta JSON per dati strutturati e uso da parte degli sviluppatori.

Svuotare le cache

1. Nella scheda Svuota cache, fai clic su: - Cancella cache token — rimuove il token di accesso OAuth2 memorizzato nella cache. La richiesta API successiva recupererà un nuovo token. - Cancella cache modelli — rimuove i dati di ricerca veicolo-modello memorizzati nella cache in modo che vengano ricostruiti su richiesta.
2. La riga di stato indica se un token è attualmente memorizzato nella cache.

Utilizza questa opzione dopo modifiche alle credenziali, dopo aver cambiato gli ambienti API o quando sono richiesti dati API freschi.

Sincronizzare le tassonomie

1. Nella scheda Sincronizzazione tassonomie, fai clic su Esegui sincronizzazione tassonomie.
2. Il plugin scorre tutti gli articoli dei veicoli importati e riapplica le relazioni dei termini di tassonomia (marca, modello, alimentazione, colore e altri attributi del veicolo) dai valori memorizzati nella tabella dei veicoli.
3. Il numero di articoli elaborati viene mostrato al termine dell'esecuzione.

Utilizza questa opzione quando i termini di filtro appaiono mancanti, obsoleti o non sincronizzati (ad esempio dopo una migrazione del database o una riattivazione del plugin).

Testare la connessione API

1. Nella scheda Test di connessione API, fai clic sul pulsante di test.
2. Il plugin invia una richiesta in tempo reale all'API di AutoScout24 con le credenziali correnti e segnala il risultato.

Esegui questo test dopo aver aggiornato le credenziali o quando le importazioni iniziano a fallire in modo imprevisto.

Installare o rimuovere i dati demo

1. Nella scheda Dati demo, fai clic su Installa dati demo.
2. Il plugin installa 10 veicoli demo: 8 vengono pubblicati immediatamente e 2 appaiono come annunci non ancora importati nella pagina Car Importer Reference in modo da poter testare il flusso di lavoro di importazione. Crea inoltre lead ed avvisi di ricerca di esempio e dati analitici sintetici che coprono 30 giorni.
3. Per ripristinare lo stato precedente, fai clic su Rimuovi dati demo. Vengono rimossi solo i record creati dall'installatore demo; i dati reali dei clienti non vengono influenzati.

La scheda mostra un riepilogo in tempo reale dei dati attualmente installati (veicoli importati, annunci in attesa nell'importatore, lead, avvisi ed eventi analitici) o il messaggio Nessun dato demo installato quando non è presente nulla. Dopo aver installato o rimosso i dati demo, un pannello di riepilogo dell'ultima installazione/rimozione segnala cosa è stato creato o ripulito.

Utilizza questa funzione per demo di prodotto, revisioni interne e test del frontend senza una connessione live a AutoScout24.

Diagnosticare un singolo articolo di veicolo

1. Nel Centro di diagnostica, individua la sezione Diagnostica un articolo di veicolo.
2. Inserisci l'ID articolo di WordPress di un veicolo importato e invia.
3. Il plugin restituisce i metadati dell'articolo, i riferimenti alle immagini, il payload non elaborato di AutoScout24 (se presente) e le risposte API in tempo reale per gli endpoint dell'annuncio e degli equipaggiamenti.

Eseguire una simulazione (dry run)

1. Nel Centro di diagnostica, individua la sezione Dry Run.
2. Invia la richiesta. Il plugin mostra un'anteprima dei dati che importerebbe da AutoScout24 senza scrivere alcuna modifica nel database. L'anteprima è limitata a circa 25 righe ed è mostrata come anteprima JSON.

Utilizza questa opzione per verificare la struttura dei dati API prima di un'importazione completa.

Condividere un'istantanea del sistema

1. Nel Centro di diagnostica, espandi la sezione Mostra istantanea del sistema.
2. Copia il contenuto JSON e allegalo a un ticket di supporto o condividilo con il tuo team operativo.

L'istantanea include la versione del plugin, l'URL del sito, le versioni di WordPress e PHP, il nome del tema, lo stato dei log e una visualizzazione oscurata delle impostazioni chiave del plugin (vengono mostrati solo indicatori come Client ID impostato: sì/no; i segreti non elaborati non vengono esportati).

Riferimento di configurazione

La schermata Strumenti non memorizza impostazioni proprie. È un pannello di avvio per operazioni singole.

Note operative

• Tutte le azioni in questa schermata sono operazioni dirette e singole. Non è prevista alcuna pianificazione qui.
• L'indicatore di stato della cache dei token (Cache token attiva / Nessuna cache token) riflette il token OAuth2 attualmente memorizzato nell'archivio dei transienti di WordPress.
• I dati demo sono identificati da un tag interno, pertanto la rimozione è sicura e non tocca i record reali dei clienti. Verifica questo comportamento nella versione corrente del plugin prima di procedere se operi su un sito di produzione.
• Le esportazioni possono essere di grandi dimensioni a seconda del numero di veicoli importati. Il file CSV viene generato come flusso; il file JSON viene generato in memoria.
• La ricerca diagnostica dell'articolo esegue una chiamata API in tempo reale a AutoScout24 per gli endpoint dell'annuncio e degli equipaggiamenti. La sezione dei risultati mostra qualsiasi errore restituito dall'API.
• L'istantanea del sistema omette intenzionalmente i segreti non elaborati. Trattala come informazione a bassa sensibilità ma comunque interna.

Risoluzione dei problemi

• Il download dell'esportazione è vuoto. Non è ancora stato importato alcun veicolo, oppure un altro plugin intercetta le richieste di admin-post.php. Conferma che l'importatore sia stato eseguito correttamente consultando il Car Importer Reference.
• La sincronizzazione delle tassonomie segnala zero articoli elaborati. Non esistono ancora articoli di veicoli. Esegui prima un'importazione.
• Il test di connessione API segnala un errore. Ricontrolla il Client ID, il Client Secret e l'URL di base in Settings, quindi fai clic su Cancella cache token e riprova.
• La diagnostica restituisce "Meta listingid o sellerid mancante su questo articolo." L'articolo non è un veicolo importato, oppure l'articolo precede l'attuale layout di memorizzazione dei veicoli. Importa nuovamente il veicolo.
• I dati demo non si installano. Conferma che l'utente disponga dei permessi di gestione e che il database possa scrivere i record demo. Controlla i Logs per i dettagli.
• L'istantanea del sistema mostra client_id_set: no. Le credenziali non sono memorizzate. Salvale nelle Impostazioni prima di eseguire il test.

Documenti correlati

• Settings Reference
• Car Importer Reference
• Riferimento a importazione e limiti
• Riferimento Logs
• System And Help Reference
• Support Reference