Riferimento a importazione e limiti

Questo documento è un riferimento per la schermata Import & Limits del plugin ADP Car Market Hub (Car Market Hub → Import & Limits). Copre il metodo di attivazione, la pianificazione automatica, la procedura guidata di importazione manuale, la configurazione del cron del server, i limiti di elaborazione delle immagini, i valori predefiniti di importazione e l'opzione della zona di pericolo Full Sync.

Quando usare questo documento

Utilizzare questo riferimento quando si configurano le importazioni automatiche per la prima volta, quando si passa dal Cron di WordPress a un vero processo cron del server, quando si ottimizzano le prestazioni di importazione per cataloghi di grandi dimensioni o quando si abilita il Full Sync per rimuovere i veicoli che sono stati messi offline.

Panoramica

La schermata è organizzata nelle seguenti schede:

1. Stato attuale dell'importazione — una frase di riepilogo dinamica che indica se le importazioni automatiche sono attive (tramite Server Cron o WP Cron) o disabilitate, oltre a quattro riquadri KPI: Veicoli importati, Venditori configurati, Immagini in attesa e Errori dell'ultima esecuzione. Un interruttore Mostra ID / Nascondi ID rivela gli ID venditore configurati in linea.
2. Ultima esecuzione + Importazione manuale — metriche dell'ultima importazione e una procedura guidata per avviare un'importazione su richiesta.
3. Impostazioni di automazione — scegliere il metodo di attivazione (Cron di WordPress o Server Cron) e configurare la pianificazione.
4. Configurazione del cron del server — visibile solo in modalità Server Cron; fornisce l'URL di attivazione REST, il token segreto e comandi cron di esempio.
5. Elaborazione delle immagini e stabilità — limiti per esecuzione e interruttore della coda di immagini per evitare timeout PHP.
6. Valori predefiniti di importazione — valori predefiniti applicati ai veicoli appena importati, inclusi il download delle immagini e la conversione in WebP.
7. Rilevamento del reinserimento — riconosce i veicoli che sono stati eliminati e reinseriti con un nuovo ID annuncio di AutoScout24 (stesso VIN) per evitare duplicati, mantenere stabile l'URL pubblico e tracciare una cronologia dei prezzi.
8. Zona di pericolo — interruttore Full Sync, più l'opzione di eliminazione soft / periodo di tolleranza che controlla come vengono gestiti i veicoli rimossi.

Requisiti o prerequisiti

• Credenziali API funzionanti e almeno un ID venditore configurato in Impostazioni.
• Per la modalità Server Cron: la possibilità di aggiungere processi cron sul proprio ambiente di hosting, oltre alla possibilità di chiamare gli URL REST di WordPress dal server.
• Per il Full Sync: si consiglia vivamente un backup recente.

Istruzioni passo dopo passo

Eseguire un'importazione manuale

1. Aprire Car Market Hub → Import & Limits.
2. Nella scheda Ultima esecuzione / Importazione manuale fare clic su Avvia importazione ora.
3. Viene visualizzata l'area della procedura guidata, che mostra un messaggio di stato, una barra di avanzamento, il tempo stimato rimanente (ETA) e una tabella dei conteggi per inseriti, aggiornati, saltati, errori ed eliminati tramite full-sync.
4. Utilizzare Pausa, Continua o Annulla secondo necessità. Se viene rilevata una coda in pausa durante una visita successiva, viene mostrato un pulsante Riprendi.

Passare al Cron di WordPress e pianificare le importazioni automatiche

1. In Impostazioni di automazione, selezionare Cron di WordPress.
2. Abilitare Esegui le importazioni automaticamente tramite il Cron di WordPress.
3. Scegliere una Frequenza di importazione tra le pianificazioni WP-Cron disponibili.
4. Per Giornaliero o Due volte al giorno, impostare un Ora di inizio nel formato a 24 ore HH:MM. Per l'intervallo personalizzato, impostare Intervallo (Minuti, min. 15).
5. Fare clic su Salva impostazioni di Import & Limits.

Passare a Server Cron

1. In Impostazioni di automazione, selezionare Server Cron. Il plugin disabilita la sua pianificazione tramite Cron di WordPress quando questa modalità è attiva.
2. Viene visualizzata la scheda Configurazione del cron del server con due passaggi: - Passaggio 1: aggiungere define( 'DISABLE_WP_CRON', true ); a wp-config.php. - Passaggio 2: aggiungere due processi cron del server — uno per chiamare l'URL di attivazione REST, uno per mantenere wp-cron.php in esecuzione per l'elaborazione delle immagini.
3. Se non esiste ancora alcun token, fare clic su Genera token (nella modalità Server Cron di solito ne viene creato uno automaticamente). Quindi copiare l'URL di attivazione REST e il Token segreto dalla scheda. Copiare subito l'URL: viene mostrato solo per circa 15 minuti, dopodiché viene nascosto fino a quando non si rigenera il token.
4. Utilizzare i Comandi cron di esempio come punto di partenza e regolare la frequenza in base alle proprie esigenze.
5. Fare clic su Salva impostazioni di Import & Limits.
6. Per ruotare il segreto, fare clic su Rigenera token e aggiornare la voce cron del server con il nuovo URL.

Configurare l'elaborazione delle immagini per la stabilità

1. In Elaborazione delle immagini e stabilità, impostare Veicoli per esecuzione (0 significa nessun limite; si consiglia 50–80 per cataloghi di grandi dimensioni).
2. Mantenere attivata l'opzione Abilita coda immagini in modo che solo la prima immagine venga caricata immediatamente e le restanti vengano elaborate in modo asincrono.
3. Salvare.

Impostare i valori predefiniti per i veicoli appena importati

1. In Valori predefiniti di importazione, scegliere lo Stato predefinito dell'articolo (Pubblica o Bozza).
2. Opzionalmente, selezionare un Autore predefinito dell'articolo; scegliere (keep current user) per preservare il comportamento esistente.
3. Attivare/disattivare Importa immagini per controllare se gli allegati delle immagini devono essere scaricati.
4. Opzionalmente, attivare/disattivare Converti immagini in WebP e scegliere una Qualità WebP compresa tra il 10% e il 100% a passaggi del 5% (consigliato 75–85%).
5. Impostare Numero massimo di immagini per annuncio (0 = nessun limite) per limitare il numero di immagini scaricate per veicolo.
6. Salvare.

Abilitare il rilevamento del reinserimento

1. Aprire Car Market Hub → Import & Limits e trovare la scheda Rilevamento del reinserimento.
2. Mantenere attivata l'opzione Abilita il rilevamento del reinserimento (è attiva per impostazione predefinita).
3. Salvare. Da questo momento in poi, quando un veicolo viene reinserito con un nuovo ID annuncio di AutoScout24 ma con lo stesso VIN, viene unito al veicolo esistente (nessun duplicato), viene applicato il nuovo prezzo, l'URL pubblico viene preservato e vengono registrati una cronologia dei prezzi e un contatore dei reinserimenti.

Abilitare il Full Sync e scegliere come gestire i veicoli rimossi (Zona di pericolo)

1. Creare un backup del database e della directory degli upload.
2. Nella Zona di pericolo, attivare Abilita Full Sync e confermare la finestra di avviso.
3. Decidere come gestire i veicoli rimossi: - Eliminazione soft (consigliata, predefinita): mantenere attiva l'opzione Trattieni i veicoli rimossi (eliminazione soft). Un veicolo che scompare da AutoScout24 viene nascosto (impostato su bozza) e conservato per il Periodo di tolleranza (giorni) configurato (impostazione predefinita 30). Se viene reinserito entro tale finestra temporale, viene ripristinato nella stessa posizione — stessa pagina, URL e cronologia dei prezzi. Solo dopo la scadenza del periodo di tolleranza viene eliminato in modo permanente da una pulizia giornaliera. - Eliminazione immediata: disattivare l'opzione Trattieni i veicoli rimossi (eliminazione soft). Un veicolo rimosso viene eliminato in modo permanente alla successiva esecuzione, incluse le sue immagini importate e in evidenza.
4. Salvare.

Riferimento di configurazione

Stato attuale dell'importazione

Nella parte superiore dello schermo, una frase dinamica indica se le importazioni automatiche sono attualmente attive (e se vengono eseguite tramite Server Cron o WP Cron) oppure disabilitate. Sotto di essa si trovano quattro riquadri KPI:

Ultima esecuzione

Il riepilogo dell'Ultima esecuzione riporta le metriche dell'importazione più recente: inseriti, aggiornati, saltati ed errori. Quando il Full Sync è abilitato, può anche riportare, per i veicoli non più presenti su AutoScout24, un contatore Trattenuti (veicoli nascosti come bozze durante il loro periodo di tolleranza quando l'eliminazione soft è attiva) e un contatore Eliminati (veicoli rimossi in modo permanente).

Metodo di attivazione

Impostazioni del Cron di WordPress (visibili solo quando è selezionato il Cron di WordPress)

Impostazioni Server Cron (visibili solo quando è selezionato Server Cron)

Elaborazione delle immagini e stabilità

Valori predefiniti di importazione

Rilevamento del reinserimento

Zona di pericolo

---

Come funzionano il rilevamento dei reinserimenti e la cronologia dei prezzi

Alcuni rivenditori aggiornano il loro posizionamento su AutoScout24 eliminando un annuncio e ricreandolo. AutoScout24 emette quindi un nuovo ID annuncio, spesso con un prezzo inferiore, mentre l'auto fisica mantiene lo stesso VIN (numero di telaio). Poiché l'importatore normalmente abbina i veicoli tramite l'ID annuncio, un tale reinserimento creerebbe altrimenti un duplicato o — con la Sincronizzazione completa — resetterebbe la cronologia dell'auto.

Con il Rilevamento dei reinserimenti abilitato, l'importazione funziona come segue:

1. L'importatore tenta prima di abbinare l'annuncio in entrata tramite il suo ID annuncio AutoScout24 (come prima).
2. Se non viene trovata alcuna corrispondenza, passa all'abbinamento tramite VIN normalizzato (convertito in maiuscolo, con i caratteri non alfanumerici rimossi). Un VIN vuoto o troppo corto per essere affidabile viene ignorato, quindi gli annunci senza VIN si comportano esattamente come prima.
3. Se esattamente un veicolo esistente ha quel VIN, viene aggiornato sul posto: vengono applicati il nuovo ID annuncio e il nuovo prezzo, e lo slug/URL pubblico viene mantenuto invariato in modo da preservare i link e la SEO. Non viene creato alcun duplicato.
4. Se il VIN è ambiguo (già presente su più di un veicolo), il plugin non esegue l'unione automatica — rimane sicuro e lascia i record inalterati.

Cosa viene registrato su un veicolo reinserito:

• Cronologia dei prezzi — ogni variazione di prezzo (e il prezzo iniziale) viene memorizzata come una voce datata, in modo che un pattern di eliminazione e reinserimento a un prezzo inferiore diventi visibile.
• ID annuncio AutoScout24 precedenti — la catena di ID annuncio che l'auto ha avuto.
• Visto per la prima volta — la data di importazione originale viene preservata (e retrocompilata per i veicoli esistenti), in modo che i giorni di permanenza nel parco auto rimangano accurati.
• Contatore dei reinserimenti e l'ultimo delta di prezzo.

Dove lo vedi:

• Colonna dell'elenco dei veicoli — una colonna Reinserimento mostra un badge Re-listed n× e l'ultima variazione di prezzo (▼ calo di prezzo / ▲ aumento di prezzo).
• Editor del veicolo — un box Reinserimento e cronologia dei prezzi elenca la data del primo avvistamento, gli ID annuncio precedenti e la cronologia completa dei prezzi.

Gli sviluppatori possono agganciarsi all'azione as24ci_vehicle_relisted ($post_id, $previous_listing_id, $current_listing_id, $delta) per integrarsi con altri sistemi e attivare/disattivare l'intera funzionalità con il filtro as24ci_enable_relisting_detection.

Come funzionano l'eliminazione soft e il periodo di tolleranza

L'eliminazione soft si applica solo quando la Sincronizzazione completa è abilitata. Modifica ciò che accade a un veicolo che non viene più restituito dall'API di AutoScout24:

1. Alla prima esecuzione in cui il veicolo risulta mancante, viene nascosto — lo stato del suo articolo viene impostato su bozza (rimosso dal frontend pubblico) e viene registrata la data di rimozione. Non viene eliminato.
2. Il veicolo viene conservato per il periodo di tolleranza configurato (predefinito 30 giorni).
3. Se lo stesso veicolo viene importato nuovamente entro il periodo di tolleranza — abbinato per ID annuncio o per VIN (vedi rilevamento dei reinserimenti) — viene ripristinato sul posto: l'articolo originale, l'URL e la cronologia dei prezzi vengono mantenuti e viene reimpostato sul suo stato precedente.
4. Un cron di pulizia giornaliero elimina definitivamente i veicoli il cui periodo di tolleranza è scaduto (rimuovendo le immagini importate e in evidenza), in modo che nulla si accumuli indefinitamente.

Questo colma il divario in cui un veicolo viene rimosso in un ciclo di sincronizzazione e reinserito solo in uno successivo: con l'eliminazione immediata (hard) l'articolo originale sarebbe già andato perduto, mentre con l'eliminazione soft viene ancora conservato come bozza e può essere ripristinato.

L'editor del veicolo mostra un avviso su un veicolo trattenuto, ad esempio “Rimosso da AutoScout24 il … — programmato per l'eliminazione permanente il … a meno che non venga reinserito.” Gli sviluppatori possono attivare/disattivare questo comportamento con il filtro as24ci_enable_soft_delete.

Note operative

• Il passaggio a Server Cron disattiva automaticamente l'evento WP-Cron del plugin, in modo che la stessa pianificazione non venga eseguita due volte.
• Il token cron viene generato automaticamente la prima volta che la schermata viene visualizzata solo in modalità Server Cron, in modo che l'URL di attivazione sia pronto quando ne hai bisogno. In modalità WP-Cron non viene generato alcun token automaticamente e l'URL di attivazione è nascosto; passa a Server Cron (o fai clic su Genera token) per crearne uno.
• La conversione WebP avviene sul server. Se l'estensione PHP richiesta non è presente, la conversione viene saltata silenziosamente — verifica nei log e nella schermata Sistema e aiuto.
• La coda delle immagini è indipendente dal limite di Veicoli per esecuzione. Entrambi possono essere attivi contemporaneamente.
• Il limite di "Veicoli per esecuzione" si applica alle importazioni pianificate. La procedura guidata di importazione manuale può scorrere automaticamente i lotti fino a quando l'intero inventario non è stato elaborato.
• Il salvataggio di uno qualsiasi dei pulsanti per scheda salva l'intero modulo Importazione e limiti (il modulo si estende su più schede).
• Il token cron, l'URL di attivazione REST e gli esempi di comandi cron mostrati nell'interfaccia di amministrazione sono specifici dell'ambiente. Non copiare i valori dalla documentazione; copiali sempre dalla tua schermata live.
• Il Rilevamento dei reinserimenti necessita di un VIN per unire un veicolo reinserito. Gli annunci senza VIN vengono abbinati solo tramite ID annuncio e si comportano come prima.
• L'eliminazione soft ha effetto solo quando la Sincronizzazione completa è abilitata. Con la Sincronizzazione completa disattivata, i veicoli mancanti dall'API vengono semplicemente mantenuti.
• La pulizia del periodo di tolleranza dell'eliminazione soft viene eseguita una volta al giorno tramite il cron WordPress. Sui siti con traffico molto basso (modalità WP-Cron), i veicoli scaduti potrebbero essere eliminati leggermente più tardi rispetto alla data di scadenza esatta.

Risoluzione dei problemi

• La pianificazione non viene mai eseguita (modalità WP-Cron). Il cron di WordPress si attiva solo quando il sito viene visitato. Sui siti a basso traffico, passa a Server Cron per un'esecuzione affidabile.
• L'attivatore REST restituisce 401/403. Il token nell'URL non corrisponde. Copia nuovamente l'URL dall'amministrazione o rigenera il token.
• Timeout PHP durante l'importazione. Riduci Veicoli per esecuzione (prova con 50), mantieni attivo Abilita coda immagini e valuta di aumentare i parametri del server max_execution_time e memory_limit se il tuo host lo consente.
• Le immagini non vengono scaricate. Conferma che Importa immagini sia abilitato e che la cartella dei caricamenti sia scrivibile. Controlla i Log.
• La conversione WebP non ha effetto. Conferma che PHP GD o Imagick supportino WebP sul server. Verifica nella schermata Sistema e aiuto.
• La Sincronizzazione completa ha rimosso veicoli in modo imprevisto. La Sincronizzazione completa elimina tutto ciò che manca dalla risposta dell'API. Se utilizzi anche modifiche manuali, ripristina da un backup e disabilita la Sincronizzazione completa.
• L'importazione manuale non si avvia. Controlla la console del browser per eventuali errori AJAX e verifica che la Dashboard segnali una connessione API funzionante.
• Lo stesso veicolo appare due volte dopo che un rivenditore lo ha reinserito. Abilita il Rilevamento dei reinserimenti in modo che il nuovo annuncio si unisca al veicolo esistente tramite VIN. Tieni presente che un veicolo il cui annuncio non ha un VIN non può essere unito automaticamente.
• Un veicolo reinserito non è stato unito. L'annuncio non ha un VIN, oppure il VIN esiste già su più di un veicolo (ambiguo). Nel caso ambiguo, il plugin deliberatamente non esegue l'unione automatica; risolvi il duplicato manualmente.
• Un veicolo rimosso è ancora presente come bozza. Si tratta dell'eliminazione soft che lo trattiene durante il suo periodo di tolleranza. Viene ripristinato automaticamente se il veicolo viene reinserito, ed eliminato definitivamente dopo il periodo di tolleranza. Per eliminare immediatamente i veicoli rimossi, disattiva Trattieni i veicoli rimossi (eliminazione soft) nella Danger Zone.
• I veicoli trattenuti non vengono mai ripuliti. La pulizia viene eseguita quotidianamente tramite WP-Cron. Sui siti a basso traffico passa a Server Cron, oppure conferma che WP-Cron si stia attivando (Sistema e aiuto).

Documenti correlati

• Riferimento impostazioni
• Riferimento importatore veicoli
• Riferimento Logs
• Riferimento sistema e aiuto
• Riferimento strumenti