Flusso di lavoro per l'importazione dei veicoli

Questo documento descrive come importare gli annunci dei veicoli dall'API di AutoScout24 in WordPress utilizzando il plugin ADP Car Market Hub. Copre sia i metodi di importazione manuale che l'importazione pianificata automatica, oltre alle opzioni di importazione, al rilevamento delle modifiche, alla gestione delle immagini e alla sincronizzazione completa (Full Sync).

Quando utilizzare questo documento

Leggere questo documento se si desidera:

• Eseguire o monitorare un'importazione di veicoli per la prima volta o su richiesta.
• Comprendere la differenza tra importazione manuale, Batch-Wizard e importazione pianificata (automatica).
• Risolvere problemi relativi a errori di importazione o risultati imprevisti.
• Comprendere come il plugin gestisce gli annunci aggiornati, le immagini e i veicoli rimossi.

Per un controllo quotidiano rapido dello stato dell'importazione, consultare i Flussi di lavoro per l'uso quotidiano.

---

Panoramica

Il plugin recupera gli annunci dei veicoli dall'API di AutoScout24 per tutti i Seller ID configurati e memorizza ciascun annuncio come un post WordPress del custom post type as24ci_car. I metadati del veicolo (prezzo, chilometraggio, specifiche, equipaggiamento, immagini) vengono memorizzati nei post meta e in una tabella di database personalizzata dedicata.

Esistono tre modi per avviare un'importazione:

1. Importazione di un singolo veicolo — importa o re-importa un annuncio dalla scheda Car Importer.
2. Batch-Wizard — esegue manualmente un'importazione completa di tutti gli annunci con monitoraggio del progresso in tempo reale. Adatto per l'importazione iniziale o per un aggiornamento completo forzato.
3. Importazione pianificata automatica — viene eseguita a un intervallo configurato tramite WP-Cron o un cron del server esterno. Il metodo consigliato per la sincronizzazione continua.

Tutti e tre i percorsi utilizzano la stessa logica di importazione sottostante: connessione all'API, recupero degli annunci per ciascun venditore configurato, confronto con la copia locale tramite hash dei contenuti e creazione o aggiornamento dei post WordPress secondo necessità.

---

Requisiti o prerequisiti

• Le credenziali API valide (API Base URL, Seller ID, Client ID, Client Secret, Token URL e Audience) devono essere inserite e salvate in ADP Car Market Hub → Impostazioni prima di poter eseguire qualsiasi importazione.
• Il sito WordPress deve essere in grado di effettuare connessioni HTTPS in uscita verso l'endpoint API configurato.
• Per l'importazione delle immagini, la directory dei caricamenti di WordPress deve essere scrivibile.
• Deve essere configurato almeno un Seller ID. Il plugin legge l'opzione as24ci_seller_ids (elenco di ID separati da virgole).

---

Istruzioni passo-passo

Importare un singolo veicolo

1. Navigare su ADP Car Market Hub → Car Importer.
2. La tabella Veicoli in attesa elenca gli annunci disponibili dall'API che non sono ancora stati importati in WordPress.
3. Trovare il veicolo che si desidera importare.
4. Fare clic su Importa accanto all'annuncio.
5. La pagina si ricarica e il veicolo appare nella tabella Veicoli importati in alto.
6. Per aggiornare un veicolo già importato (ad esempio, dopo una variazione di prezzo su AutoScout24), trovarlo nella tabella Veicoli importati e fare clic su Re-importa.

Eseguire il Batch-Wizard (importazione completa manuale)

Il Batch-Wizard è il metodo consigliato per l'importazione completa iniziale di tutti gli annunci e per eseguire un aggiornamento forzato al di fuori della normale pianificazione.

1. Navigare su ADP Car Market Hub → Importazione e Limiti.
2. Fare clic sul pulsante Avvia ora.
3. Il Batch-Wizard si avvia e mostra una barra di avanzamento in tempo reale che indica: - Veicoli totali da elaborare. - Veicoli elaborati finora. - Tempo rimanente stimato. - Azione corrente (inserimento, aggiornamento o salto).
4. Di default, la procedura guidata elabora un veicolo alla volta (dimensione del batch adattiva: 1–5 veicoli per passaggio). Ciò evita errori di timeout di esecuzione PHP sugli hosting condivisi.
5. Utilizzare il pulsante Pausa per sospendere temporaneamente l'importazione. Fare clic su Riprendi per continuare.
6. Utilizzare il pulsante Interrompi per arrestare l'importazione. I veicoli già elaborati nella sessione corrente rimangono in WordPress.
7. Al termine della procedura guidata, un riepilogo mostra il numero di veicoli inseriti, aggiornati, saltati ed eventuali errori.

Configurare ed eseguire importazioni automatiche pianificate

Per la sincronizzazione continua, abilitare l'utilità di pianificazione automatica:

1. Navigare su ADP Car Market Hub → Importazione e Limiti.
2. Abilitare Importazione automatica (la casella di controllo o l'interruttore nella scheda).
3. Scegliere l'intervallo di importazione: - Ogni ora - Ogni 6 ore - Due volte al giorno - Giornaliero - Personalizzato (minimo 15 minuti — configurare il valore dei minuti nel campo dell'intervallo personalizzato)
4. Per le pianificazioni giornaliere e due volte al giorno, impostare facoltativamente l'ora di inizio.
5. Salvare le impostazioni di automazione.
6. Il WP-Cron di WordPress attiverà ora le importazioni all'intervallo configurato ogni volta che il sito riceve traffico.

Per i siti in produzione, si consiglia il cron del server:

1. Impostare la Modalità Cron su Cron del server nella scheda Importazione e Limiti.
2. Copiare l'URL dell'endpoint cron visualizzato (l'URL include un token di sicurezza).
3. Aggiungere un processo cron lato server (ad esempio, tramite crontab) che richiami l'URL dell'endpoint utilizzando curl o wget all'intervallo desiderato.
4. Se si rigenera il token (Importazione e Limiti → Rigenera token), aggiornare il processo cron con il nuovo URL.

---

Come funzionano le importazioni

Rilevamento delle modifiche

L'importatore calcola e memorizza un hash del contenuto e un hash dell'immagine per ciascun veicolo importato. Nelle successive esecuzioni di importazione, un veicolo viene saltato se nessuno dei due hash è cambiato. Ciò mantiene rapide le esecuzioni di importazione, specialmente per inventari di grandi dimensioni in cui la maggior parte dei veicoli è invariata.

Quando un annuncio viene aggiornato su AutoScout24 (ad esempio, una variazione di prezzo o nuove immagini), gli hash non corrispondono più e il veicolo viene aggiornato in WordPress.

Codici di esito dell'importazione

Ciascun veicolo elaborato durante un'esecuzione di importazione viene conteggiato in una delle quattro categorie:

Il riepilogo dell'importazione nella scheda Importazione e Limiti e nel Batch-Wizard mostra questi conteggi dopo ogni esecuzione.

Importazione delle immagini e coda delle immagini

• Quando l'opzione Importa immagini è abilitata nelle Impostazioni, l'importatore scarica le immagini dei veicoli dall'API e le associa al post di WordPress.
• Numero massimo di immagini per veicolo (Impostazioni) limita il numero di immagini scaricate per annuncio (0 = illimitato).
• Modalità coda immagini (abilitata per impostazione predefinita per le importazioni cron/REST): durante le importazioni pianificate, viene scaricata immediatamente solo la prima immagine per veicolo. Tutte le immagini rimanenti vengono aggiunte a una coda persistente in background e elaborate in modo asincrono dal worker della coda immagini, che viene eseguito circa ogni 5 minuti. Ciò previene gli errori di timeout di esecuzione PHP durante importazioni di grandi dimensioni.
• Il worker della coda immagini elabora fino a 30 immagini per batch.
• La dimensione corrente della coda e lo stato del worker sono visibili nella scheda Sistema e Supporto.
• Per elaborare immediatamente la coda delle immagini, fare clic su Esegui coda immagini ora nella scheda Sistema e Supporto.
• Conversione in WebP: se abilitata nelle Impostazioni e se GD o Imagick è disponibile, le immagini vengono convertite nel formato WebP al momento del download. Il livello di qualità è configurabile (1–100, predefinito 80).

Blocco dell'importazione

Il plugin utilizza un blocco di esecuzione basato su transient con un TTL di circa 40 minuti. Se un'esecuzione di importazione è già in corso quando arriva un secondo avvio (da WP-Cron, cron del server o un pulsante manuale), il secondo avvio viene saltato e viene registrato un messaggio di "già in corso". Se il blocco è obsoleto (più vecchio del TTL), viene rimosso automaticamente in modo che l'esecuzione successiva possa procedere.

Sincronizzazione completa (Full Sync)

Quando la Sincronizzazione completa è abilitata nella scheda Importazione e Limiti, l'importatore confronta l'insieme di ID annuncio restituiti dall'API con tutti i post dei veicoli in WordPress. Qualsiasi post locale il cui ID annuncio non è presente nell'annuncio remoto corrente viene eliminato in modo permanente, incluse tutte le immagini allegate.

• Abilitare la Sincronizzazione completa solo quando si desidera che l'inventario di WordPress rispecchi esattamente l'annuncio live di AutoScout24.
• Le eliminazioni della Sincronizzazione completa vengono registrate nel log del plugin con i conteggi di sync_deleted.
• Quando la Sincronizzazione completa è disabilitata, i veicoli rimossi da AutoScout24 rimangono in WordPress finché non vengono eliminati manualmente.

Stato del post del veicolo

I veicoli importati vengono creati con lo stato del post configurato in Impostazioni → Stato predefinito del post (publish o draft). Quando un veicolo viene aggiornato da una successiva esecuzione di importazione, lo stato del suo post non viene modificato — un post pubblicato rimane pubblicato.

---

Riferimento di configurazione

---

Note operative

• Seller ID multipli: l'importatore viene eseguito separatamente per ciascun Seller ID configurato. Un errore per un venditore non interrompe le importazioni per gli altri venditori.
• Robustezza del cron: l'esecutore dell'importazione aumenta il limite del tempo di esecuzione PHP a 300 secondi durante le esecuzioni avviate da cron/REST. Negli ambienti di hosting che limitano set_time_limit(), questo potrebbe non avere effetto.
• Dimensione del batch del Batch-Wizard: la procedura guidata adatta la dimensione del proprio batch (1–5 veicoli per passaggio) per rimanere entro limiti di tempo di esecuzione sicuri.
• Avvio manuale durante un cron attivo: se il cron automatico è in esecuzione quando si fa clic su Avvia ora, l'avvio manuale verrà saltato a causa del blocco di esecuzione. Attendere il completamento dell'esecuzione corrente o rimuovere il blocco.
• Log di importazione: tutti gli eventi di importazione (chiamate API, inseriti/aggiornati/saltati/errori per veicolo, download di immagini) vengono scritti nel log del plugin. Consultare ADP Car Market Hub → Log per i dettagli.
• Log dettagliato: se abilitato, il log include dettagli per singolo veicolo e singola immagine. Disabilitare in produzione per ridurre la crescita del log.

---

---

Risoluzione dei problemi

---

Documenti correlati

• Flussi di lavoro per l'uso quotidiano
• Manuale dell'amministratore
• Flusso di lavoro per la gestione dei lead
• Manuale utente