Prodotti Ignorati, Errori e Diagnostica di Sistema
Dopo ogni generazione del feed, il modulo mostra esattamente quali prodotti sono stati esclusi e perché — così puoi correggere i problemi del catalogo prima che influenzino le tue campagne su Facebook o Instagram.
Disponibile dalla v2.4.8
Panoramica
Quando il modulo genera il feed prodotti, analizza ogni prodotto attivo ed esegue una serie di controlli. I prodotti che non superano un controllo non vengono scartati silenziosamente — vengono registrati in un file di report (feeds/errors.txt) insieme alla ragione dell'esclusione. Il Back Office mostra quindi questi dati in pannelli dedicati, così puoi intervenire senza dover fare ipotesi.
Dopo un'esecuzione di generazione, nella pagina di configurazione del modulo possono comparire tre pannelli condizionali:
- Ignorati — prodotti deliberatamente esclusi a causa di una regola sulla qualità dei dati (immagine mancante, nessuna descrizione, escluso per ID, ecc.)
- Errori — prodotti che hanno generato un avviso, una notice o un errore fatale a livello PHP durante l'elaborazione
- Diagnostica di Sistema — un pannello mirato che appare quando è stato rilevato un errore grave a metà generazione; individua il prodotto esatto e il messaggio di errore per consentire un'indagine immediata
Nessuno di questi pannelli appare se l'ultima generazione si è completata correttamente; in quel caso viene mostrato un messaggio di conferma.
Quando Appare Ciascun Pannello
Pannello Ignorati
La scheda Ignorati appare nella barra di navigazione laterale quando almeno un prodotto è stato escluso durante la generazione più recente. L'etichetta della scheda mostra il conteggio totale, ad esempio Ignorati (17). Facendo clic sul conteggio nella tabella Statistiche di Generazione si viene indirizzati direttamente a questo pannello.
I prodotti ignorati sono normali nella maggior parte dei negozi — un prodotto senza immagine o un prodotto nascosto non dovrebbe raggiungere Facebook. Il pannello ti aiuta a valutare se il numero di prodotti ignorati riflette una scelta di configurazione o un reale problema nei dati.
Pannello Errori
La scheda Errori appare quando uno o più prodotti hanno generato un errore PHP (notice, warning o fatale) durante l'elaborazione. Questo è diverso da un'esclusione: un'esclusione è deliberata e basata su una regola sui dati, mentre un errore significa che si è verificato qualcosa di inatteso mentre il modulo cercava di leggere o elaborare i dati del prodotto.
L'etichetta della scheda mostra anch'essa il conteggio: Errori (3). Nella tabella Statistiche di Generazione, la colonna degli errori è sempre un link cliccabile che punta a questo pannello, anche quando il conteggio è zero, così puoi verificare lo stato degli errori dopo ogni esecuzione.
Pannello Diagnostica di Sistema
Il pannello Diagnostica di Sistema appare solo quando un errore grave è stato intercettato dal sistema di cattura errori del modulo durante la generazione più recente. Si tratta di una diagnostica su singolo prodotto: mostra l'ID prodotto, l'ID combinazione (se applicabile), il negozio, la gravità dell'errore, il file PHP e il numero di riga in cui si è verificato l'errore, e un timestamp.
Questo pannello è intenzionalmente distinto dal pannello Errori. È progettato per il caso raro in cui un singolo prodotto causa un problema così grave da poter interrompere l'intero ciclo di generazione. Il pannello fornisce informazioni sufficienti per trovare il prodotto problematico nel Back Office e correggerlo o escluderlo.
Come Leggere i Report
Pannelli Ignorati ed Errori
Entrambi i pannelli organizzano i risultati nello stesso modo:
- Negozio — se hai più negozi, i report sono raggruppati per nome negozio
- Tipo di feed — all'interno di ogni negozio, i risultati sono suddivisi per tipo di feed: Feed Principale o feed per lingua
- Categoria errore/esclusione — all'interno di ogni tipo di feed, i prodotti sono raggruppati per la ragione dell'esclusione. Ogni categoria ha un'intestazione, una spiegazione e una correzione suggerita
Ogni voce di prodotto mostra una miniatura, il nome del prodotto e un link diretto per modificarlo nel Back Office. Per ogni categoria vengono mostrati fino a 250 prodotti — se una categoria ha più di 250 prodotti interessati, vengono elencati solo i primi 250 per evitare rallentamenti del caricamento della pagina.
Le categorie di esclusione ed errore che potresti incontrare sono:
| Categoria | Significato |
|---|---|
| Images | Il prodotto non ha immagini oppure il file immagine non è stato trovato sul disco |
| Image | Il prodotto non ha alcuna immagine — nemmeno un'immagine di copertina |
| Products without images | Il prodotto ha meno immagini del minimo impostato nell'opzione Posizione Iniziale Immagine |
| Product Description | Sia la descrizione breve che quella lunga sono vuote |
| Empty Product Name | Il prodotto non ha nome nella lingua attiva |
| Invalid Identifier | Il prodotto non ha EAN, UPC, MPN né brand — Facebook richiede almeno un identificatore |
| Products without stock | Il prodotto è esaurito e l'opzione "Genera prodotti esauriti" è disabilitata |
| Products Excluded by ID | Hai escluso manualmente questo prodotto utilizzando la funzione Escludi Prodotto |
| Products Excluded by Category | Hai escluso manualmente la categoria del prodotto utilizzando la funzione Escludi Categoria |
| Products with hidden visibility | La visibilità del prodotto è impostata su nascosto nella pagina di modifica del prodotto |
Ogni categoria nel pannello include una correzione suggerita direttamente sotto l'intestazione. Ad esempio, la sezione Invalid Identifier spiega come abilitare l'opzione "Consenti prodotti senza EAN, UPC o Produttore" e assegnare un brand predefinito globale.
Pannello Diagnostica di Sistema
Il pannello Diagnostica di Sistema mostra un singolo record di errore. Troverai:
- ID Prodotto e un link diretto per modificare quel prodotto
- ID Combinazione (mostrato come 0 se l'errore riguarda il prodotto base e non una combinazione)
- ID Negozio
- Gravità dell'errore — uno tra: Fatal Error, Warning, Notice, Parse Error, User Error, Core Error, Compile Error
- File e riga in cui si è verificato l'errore
- Timestamp dell'errore
Questo pannello cattura gli errori che si verificano in PHP durante l'elaborazione dei prodotti. Non indica un problema con il modulo stesso — nella maggior parte dei casi punta a dati del prodotto corrotti, a un modulo di terze parti che modifica gli oggetti prodotto in modo imprevisto, oppure a un problema di configurazione del server.
Ragioni Comuni di Esclusione ed Errore
La maggior parte dei negozi avrà prodotti ignorati — è normale. Le ragioni di esclusione più frequenti sono:
- Nessuna immagine: prodotti per cui non è mai stata caricata un'immagine, oppure prodotti le cui miniature non sono state rigenerate dopo una modifica delle dimensioni. Vai su Design > Immagini > Rigenera miniature (PrestaShop 1.6: Preferenze > Immagini), seleziona il tipo Prodotti e rigenera senza eliminare le immagini esistenti.
- Nessun identificatore: la policy del catalogo prodotti di Facebook richiede un EAN, UPC, MPN o brand su ogni articolo. Se i tuoi prodotti non utilizzano codici a barre standard, abilita Consenti prodotti senza EAN, UPC o Produttore nella scheda Opzioni Prodotto e inserisci un nome brand predefinito nel campo sottostante.
- Esaurito: se non vuoi i prodotti esauriti nel tuo catalogo Facebook, questo comportamento è atteso. Se vuoi includerli, abilita Genera prodotti esauriti nella scheda Opzioni Prodotto.
- Visibilità nascosta: i prodotti impostati su "nascosto" in PrestaShop vengono intenzionalmente esclusi. Controlla l'impostazione Opzioni > Visibilità di ogni prodotto se vuoi includerli.
- Esclusi manualmente: i prodotti o le categorie che hai escluso tramite le funzionalità Escludi Prodotti o Categorie Incluse / Escluse appariranno sempre qui. Controlla quei pannelli se noti esclusioni inaspettate.
Come Cancellare i Report
Cancellare i report Ignorati ed Errori
I pannelli Ignorati ed Errori vengono ricostruiti da zero ad ogni generazione. Per cancellarli, avvia una nuova generazione del feed — una volta completata con successo, il vecchio report viene sostituito. Non esiste un pulsante "cancella" manuale per questi pannelli.
Se il file feeds/errors.txt non è scrivibile, il modulo tenterà di recuperare i dati del report da un fallback nel database. In quel caso comparirà un avviso in cima alla pagina che ti chiede di correggere i permessi del file. Imposta il file modules/facebookproductsfeed/feeds/errors.txt come scrivibile (modalità 666) per ripristinare il reporting normale.
Cancellare il record di Diagnostica di Sistema
Il pannello Diagnostica di Sistema dispone di un pulsante Cancella Errore. Facendo clic su di esso il record dell'errore viene rimosso immediatamente — non è necessario ricaricare la pagina. Il pannello scompare dalla barra di navigazione laterale dopo la cancellazione.
Il record dell'errore viene anche cancellato automaticamente all'inizio di ogni nuovo ciclo di generazione, quindi avviare una nuova generazione lo sostituirà o rimuoverà senza intervento manuale.
Se lo stesso prodotto continua ad apparire nella Diagnostica di Sistema dopo più esecuzioni di generazione, quel prodotto causa costantemente un errore PHP. Modifica il prodotto nel Back Office per correggerne i dati, oppure escludilo tramite la funzionalità Escludi Prodotti finché non riesci a investigare ulteriormente.
Note Importanti
- Limite del report: ogni categoria di esclusione/errore mostra un massimo di 250 prodotti per evitare caricamenti lenti della pagina. Se hai più di 250 prodotti interessati dallo stesso problema, correggi prima la causa principale più comune e rigenera per avere il quadro completo.
- Feed per paese esclusi: il conteggio degli ignorati nella tabella Statistiche di Generazione mostra
---per i feed specifici per paese. Il tracciamento di esclusioni ed errori si applica solo al Feed Principale e ai feed per lingua. - Multi-negozio: i report sono organizzati per negozio. Se gestisci più negozi, i prodotti ignorati e con errori di ciascun negozio sono elencati separatamente nella propria scheda negozio all'interno del pannello.
- Permessi file: se
feeds/errors.txtnon può essere scritto, il modulo salva i dati del report nel database come fallback. Questo è meno affidabile per cataloghi di grandi dimensioni — correggi i permessi del file non appena vedi l'avviso. - Modalità manutenzione: la generazione del feed (e quindi la generazione dei report) è bloccata quando il negozio è in modalità manutenzione. Non verranno creati nuovi report finché non togli il negozio dalla manutenzione.
Risoluzione dei Problemi
| Problema | Soluzione |
|---|---|
| Il pannello Ignorati o Errori non appare dopo la generazione | Verifica che la generazione sia terminata completamente. Se una generazione precedente è bloccata, aggiorna la pagina — il modulo rileva automaticamente un file di progresso completato e rimuove il blocco di generazione. Poi avvia una nuova generazione. |
| Avviso "Product Skipped & Errors report couldn't be saved" | Il file feeds/errors.txt non è scrivibile. Imposta i permessi a 666 su quel file tramite FTP o il file manager del tuo hosting. |
| La Diagnostica di Sistema continua a mostrare lo stesso prodotto dopo ogni generazione | Il prodotto ha dati corrotti o incompatibili che generano un errore PHP. Apri il prodotto nel Back Office, controlla tutti i campi (specialmente quelli personalizzati aggiunti da altri moduli) e correggilo o escludilo. |
| Il pannello Errori è vuoto ma la tabella statistiche mostra un conteggio errori | I dati del report potrebbero provenire da un ciclo di generazione precedente che nel frattempo è stato sovrascritto. Avvia una nuova generazione per aggiornare il pannello. |
| Più di 250 prodotti elencati come ignorati | Il pannello limita la visualizzazione a 250 per categoria. Affronta la causa principale della ragione di esclusione più comune (ad esempio, abilita i prodotti esauriti o correggi le miniature delle immagini), rigenera e ricontrolla. |
Domande Frequenti
Ogni prodotto risulta ignorato con "Invalid Identifier" — cosa significa?
Facebook richiede che ogni prodotto abbia almeno uno tra: codice a barre EAN, codice a barre UPC, MPN (numero di parte del produttore) o un nome brand. Se i tuoi prodotti non utilizzano questi identificatori, vai alla scheda Opzioni Prodotto, abilita Consenti prodotti senza EAN, UPC o Produttore e inserisci il nome brand del tuo negozio nel campo che appare. Dopo aver salvato e rigenerato, quei prodotti non saranno più ignorati per questa ragione.
Vedo lo stesso prodotto sia in Ignorati che in Errori — è possibile?
Sì. Un prodotto può essere ignorato per una ragione legata alla qualità dei dati (ad esempio, nessuna immagine) e contemporaneamente generare una notice PHP mentre il modulo tenta di leggerne i dati. Correggi prima il problema nei dati e rigenera — spesso risolvere la causa dell'esclusione risolve anche l'errore sottostante.
Il pannello Ignorati è apparso una volta ma ora è scomparso — ho perso i dati?
Il pannello viene mostrato solo quando la generazione più recente ha prodotto prodotti ignorati. Se hai avviato una nuova generazione completata senza esclusioni, l'assenza del pannello è corretta. I dati del report precedente vengono sovrascritti ad ogni esecuzione.
Posso esportare l'elenco degli ID dei prodotti ignorati o con errori?
I pannelli del Back Office non offrono un'esportazione diretta. I dati grezzi del report sono salvati in feeds/errors.txt in formato JSON, che puoi scaricare via FTP e aprire in qualsiasi editor di testo o foglio di calcolo se hai bisogno dell'elenco completo.
Il pannello Diagnostica di Sistema è apparso ma l'ho cancellato — tornerà?
Riapparirà solo se la prossima esecuzione di generazione incontra un altro errore PHP su un prodotto. Cancellare il record non previene errori futuri; rimuove solo il record corrente memorizzato. Se vuoi evitare che l'errore si ripeta, modifica o escludi il prodotto che lo ha causato.
Perché la colonna errori nella tabella statistiche mostra sempre un link, anche quando il conteggio è zero?
Il link è sempre presente per consentirti di navigare rapidamente al pannello Errori e verificarne lo stato dopo qualsiasi generazione. Un conteggio pari a zero significa che l'ultima generazione si è completata senza errori sui prodotti — il link è comunque utile per la conferma.