Strumenti di Debug per la Generazione
Due impostazioni nella scheda Generation Options ti permettono di limitare o concentrare la generazione del feed durante la risoluzione dei problemi — senza toccare la pianificazione cron attiva o la configurazione in produzione.
Disponibile dalla v2.4.6
Panoramica
Quando un prodotto mostra dati inattesi nel catalogo di Facebook, o quando vuoi testare una modifica alla configurazione senza aspettare che l'intero catalogo venga elaborato, questi strumenti ti consentono di circoscrivere la generazione esattamente ai prodotti che ti interessano, oppure di limitare il conteggio totale a un numero ridotto. Entrambe le impostazioni sono temporanee per design: il modulo ti avvisa in modo ben visibile quando una delle due è attiva, così non dimentichi di rimuoverla prima della prossima esecuzione pianificata.
Entrambi i campi si trovano nella scheda Generation Options della pagina di configurazione del modulo.
Impostazioni
| Campo | Chiave di configurazione | Default | Descrizione |
|---|---|---|---|
| Max Products Generation | FPF_GENERATE_MAX_PRODUCTS | 0 (disabilitato) | Limita il numero totale di prodotti inclusi nel feed a questo valore. 0 significa nessun limite. |
| Debug Product Feed Generation | FPF_FEED_DEBUG_IDS | vuoto (disabilitato) | Elenco di ID prodotto separati da virgola. Quando è impostato, il feed contiene solo questi prodotti e tutti gli altri vengono ignorati. |
Max Products Generation
Inserisci un numero intero positivo per interrompere il feed dopo che è stato elaborato quel numero di prodotti. Le query SQL che recuperano l'elenco dei prodotti vengono riscritte per applicare un LIMIT a livello di database, così la generazione si ferma prima ed è proporzionalmente più veloce.
Questa impostazione si applica globalmente a tutti i negozi, le lingue e i feed per paese nella stessa esecuzione.
Attenzione: Quando questo campo contiene un valore diverso da zero, il modulo mostra un banner di avviso in cima a ogni pagina di configurazione per ricordarti che è attivo un limite di generazione. Svuota il campo (impostalo a
0) al termine dei test, in modo che il feed in produzione contenga l'intero catalogo.
Debug Product Feed Generation
Digita il nome o l'ID di un prodotto nella casella di ricerca e selezionalo dall'elenco di completamento automatico. Puoi aggiungere più prodotti. Il modulo salva la selezione come elenco di ID prodotto separati da virgola.
Durante la generazione, qualsiasi prodotto il cui ID non è nell'elenco viene immediatamente ignorato con motivazione di esclusione debug — non viene scritto alcun XML per esso e non viene conteggiato nei totali degli errori. I prodotti nell'elenco seguono l'intero processo di generazione esattamente come farebbero in un'esecuzione normale: prezzi, combinazioni, immagini, spedizione, etichette personalizzate e mappatura delle categorie Google vengono tutti applicati.
Questo rende l'impostazione utile per due diversi flussi di lavoro:
- Diagnosi di un prodotto specifico — vedi l'output esatto (o l'errore) per quel prodotto in modo isolato, senza il rumore degli altri articoli nel catalogo.
- Verifica rapida di modifiche alla configurazione — applica una modifica, avvia una generazione manuale con un piccolo elenco di ID e controlla il risultato prima di procedere con un'esecuzione completa.
Attenzione: Quando questo campo non è vuoto, il modulo mostra un banner di avviso su ogni pagina di configurazione. Il messaggio include il numero di prodotti selezionati e un collegamento diretto al campo. Rimuovi la selezione al termine dei test.
Casi d'Uso
Verifica di un prodotto mal configurato Un prodotto mostra il prezzo errato o un'immagine mancante nel catalogo di Facebook. Inserisci il suo ID nel campo Debug Product Feed Generation, fai clic su Generate Feed Now dalla scheda Manual Feed Generation e apri l'URL del feed. Vedrai solo la voce di quel prodotto e potrai confrontarla con quanto ti aspetti.
Test di una nuova configurazione su un catalogo di grandi dimensioni
Hai 15.000 prodotti e vuoi verificare che l'attivazione di una nuova etichetta personalizzata funzioni correttamente prima di eseguire una generazione completa. Imposta Max Products Generation a 50, salva e avvia una generazione manuale. Il feed viene generato in pochi secondi. Controlla l'output, poi riporta il limite a 0.
Isolamento di un problema con le combinazioni Un prodotto con più combinazioni taglia/colore genera voci duplicate. Aggiungi l'ID del prodotto a Debug Product Feed Generation e avvia la generazione. Il feed mostrerà solo le combinazioni di quel prodotto, rendendo semplice individuare quali attributi di combinazione stanno causando la duplicazione.
Note Importanti
- Entrambe le impostazioni influenzano ogni feed per negozio e lingua nella stessa esecuzione di generazione — non sono specifiche per negozio o per lingua.
- Quando Debug Product Feed Generation è attivo, il limite normale al dettaglio dei log non viene applicato. I log di generazione mostrano ogni prodotto mentre viene elaborato, fornendo un output dettagliato anche con impostazioni di log meno verbose.
- Impostare Max Products Generation a
1produce un feed valido con un solo prodotto, il che è un modo rapido per verificare che l'URL del feed sia raggiungibile e che il formato XML sia corretto prima di investigare problemi di contenuto. - Entrambe le impostazioni persistono finché non le rimuovi manualmente. Anche un'esecuzione attivata da cron rispetterà questi limiti, quindi un'esecuzione cron in produzione produrrebbe un feed incompleto o filtrato se dimentichi di rimuovere le impostazioni dopo i test.
- Nessuna delle due impostazioni modifica la posizione del file del feed né l'URL che Facebook utilizza per recuperare il catalogo. Lo stesso URL del feed viene aggiornato sia che tu abbia generato un'esecuzione di test filtrata sia un'esecuzione completa in produzione.