> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md). # Risolvi errori e avvisi dei cataloghi prodotti Ogni catalogo prodotti ha un punteggio di salute che indica quali problemi, se presenti, sono presenti nel tuo catalogo. Per portare il tuo catalogo nel *eccellente* range, devi individuare e correggere eventuali errori, avvisi e duplicati presenti al suo interno. {% embed url="" %} 1. Dal menu di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Interagisci]** → **Contenuto** → **Prodotti** → [**Cataloghi prodotti**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml). 2. Se un catalogo presenta errori, avvisi o elementi duplicati, vedrai quanti ce ne sono nella *Salute* colonna.
* I metodi di caricamento che recuperano automaticamente il catalogo dovrebbero aggiornarsi automaticamente quando si verifica il successivo evento di recupero.
Descrizioni dello stato di salute | Indicatore di salute | Descrizione | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **In sospeso** | Il tuo catalogo prodotti è in fase di caricamento. | | **Elaborazione** | Il tuo catalogo prodotti è in fase di elaborazione. | | **Eccellente** | Indica un catalogo in buono stato: questo set di dati prodotto è completo e ben strutturato, offrendogli le migliori possibilità di prestazioni efficaci. | | **Buono** | Indica che alcuni campi suggeriti che contengono dati cruciali come categoria o stato potrebbero mancare. Risolvere queste lacune migliorerà la qualità complessiva del tuo catalogo. | | **Scarso** | Indica che le informazioni richieste mancano in oltre il 10% dei record che hai inviato. Questo catalogo dovrà essere corretto e ricaricato. |
#### Visualizza errori e avvisi 1. Nel *Salute* colonna, seleziona il **errori**, **avvisi**, oppure **duplicati** collegamento. * Verrai reindirizzato a una pagina con ulteriori dettagli sugli errori o avvisi. Solo il primo elemento di un insieme di duplicati verrà rappresentato in impact.com; tutti gli elementi che duplicano il primo verranno ignorati. 2. Facoltativamente, usa il *Cerca* campo e i filtri in cima alla pagina per esaminare i problemi.
Descrizioni dei filtri | | | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Tipo di errore** | Puoi filtrare specificamente per *Errori*, *Avvisi*, *Duplicati*, oppure *Tutti* problemi. | | **Obbligatorio** | Puoi filtrare eventuali campi obbligatori mancanti specifici del catalogo prodotti o *Tutti* campi. | | **Suggeriti** | Puoi filtrare eventuali campi consigliati mancanti specifici del catalogo prodotti o *Tutti* campi. | | **Non valido** | Puoi filtrare eventuali errori specifici basati sulla convalida. Possono trattarsi di un SKU duplicato, di un codice categoria Google non valido o di altri errori. |
3. Esamina i problemi e apporta le modifiche richieste. Quindi, ricarica il tuo catalogo prodotti.
Messaggi comuni di errore e avviso | Messaggio di errore | Spiegazione | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *Record 'X': campi obbligatori mancanti: (nome campo)* | La riga specificata non contiene uno o più campi obbligatori. | | *Record 'X': CatalogItemId(CatalogItemId): campi obbligatori mancanti: (nome campo)* | Una riga nel file di dati non contiene un campo obbligatorio. | | *Nessun catalogo trovato per la richiesta. Controlla se il nome del file caricato è lo stesso di quello registrato con il catalogo* | Il *Nome file di caricamento* impostato nella *Metodo di caricamento* sezione durante la creazione di un catalogo prodotti non corrisponde esattamente al nome del file che hai caricato. | | *Nessun attributo presente nel file del catalogo* | Il file di dati del catalogo prodotti non contiene dati elaborabili. | | *L'elemento del catalogo con questo ID appare più di una volta nel catalogo e quelli successivi al primo saranno ignorati* | 2 o più elementi hanno lo stesso ID: tutti i prodotti richiedono un valore univoco. Gli elementi duplicati non verranno elaborati. | | *Record 'X' ha un errore: (linea X) carattere non valido tra token racchiuso e delimitatore* | Una riga nel file di dati contiene un uso non valido delle virgolette doppie. Devono essere gestite correttamente racchiudendo il campo tra virgolette doppie e sostituendo tutte le altre virgolette doppie con 2 virgolette doppie (ad es., *floppy da 3"* diventa *"3"" floppy"*). | | *(Riga di inizio X) EOF raggiunto prima che il token racchiuso fosse terminato* |

EOF significa "fine del file". La riga di inizio menzionata ha una virgoletta doppia di apertura senza una virgoletta doppia di chiusura. Questo errore si è verificato perché non è stata trovata una virgoletta doppia di chiusura, anche leggendo fino alla fine del file.

In alternativa, un'interruzione di riga imprevista potrebbe aver interrotto il flusso di dati.

| | *Errore durante l'analisi del campo (tipo di catalogo): con valore: (campo)* | Il campo prodotto non è valido e non può essere accettato. | | *Il record (recordNumber) presenta un errore: il numero di valori delimitati (FieldsLength) non corrisponde a quello previsto (ColumnNamesLength)* | Per una determinata riga di dati, se esistono dati in una colonna senza intestazione, si verificherà questo errore. | | *Non sono stati trovati record validi nel file del catalogo* | Il file di dati è vuoto (cioè non contiene dati), i dati rilevati non sono validi oppure il nome file specificato non è corretto. | | *Più del 10% dei record nel file presentava errori.* | Il file di dati non può essere elaborato se si verifica questo errore. | | *L'elaborazione non è riuscita a causa di un errore interno del sistema. Non è richiesta alcuna azione da parte dell'utente. Il nostro team di ingegneria è stato informato e sta cercando di risolvere il problema. L'ultimo catalogo elaborato correttamente continuerà a essere disponibile per i Media Partner. Contatta l'assistenza di impact.com se hai bisogno di ulteriori informazioni.* | Fai riferimento alla [pagina di stato di impact.com](https://status.impact.com/) per dettagli sulle interruzioni del servizio. | | *Il campo (nome campo) con valore (valore campo) non ha un protocollo valido* | Il valore del campo non è un URL formattato correttamente. |
#### Errori del formato Google Merchant Ci sono 2 problemi che potresti incontrare se utilizzi il formato Google Merchant Center come tassonomia del tuo catalogo prodotti, e i problemi probabilmente emergeranno intorno al formato `Categoria` sezione. {% tabs %} {% tab title="Categoria prodotto Google mancante" %} Quando selezioni *errori* nella *Cataloghi prodotti* schermata, potresti vedere *Categoria prodotto Google mancante* nel *Suggerimenti* colonna. Ciò significa che nel tuo catalogo non è stato incluso alcun codice categoria Google né una stringa completa della categoria Google. Per risolvere questo problema, fai riferimento al tuo account Google Merchant Center. Google suggerisce automaticamente categorie per gli articoli: questa suggerimento dovrebbe essere usato quando carichi il catalogo corretto.
{% endtab %} {% tab title="Discrepanza nella categoria prodotto Google" %} Quando selezioni *errori* nel *Cataloghi prodotti* schermata, potresti vedere *Discrepanza nella categoria prodotto Google* nel *Non valido* colonna. Ciò significa che la categoria usata per gli articoli nel tuo catalogo non corrisponde al [codice della tassonomia](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) (ad es., 7386) o al formato completo della categoria fornito da Google. Vedi l'esempio seguente di un formato completo della categoria Google. `Animali e articoli per animali domestici > Articoli per animali domestici > Articoli per uccelli > Accessori per gabbie per uccelli > Ciotole per cibo e acqua per gabbie per uccelli` Per risolvere questo problema, correggi il formato in cui le categorie prodotto Google sono elencate nel tuo catalogo, quindi ricarica il catalogo.
{% endtab %} {% endtabs %} #### Risoluzione dei problemi *Recupera da URL* problemi Se il tuo catalogo è configurato per prelevare da un URL e non si carica, non si aggiorna o non viene elaborato correttamente, usa la tabella qui sotto per individuare e risolvere il problema.
ProblemaCosa controllareCome risolverlo
L'URL non è un link di download direttoApri il tuo URL in un browser. Se reindirizza a una pagina di accesso, a una pagina iniziale di archiviazione cloud oppure restituisce un errore 404/403, l'URL non è un link di download diretto.Aggiorna l'URL con uno che scarichi il file direttamente o lo visualizzi come dati grezzi quando viene aperto in un browser.
Nome file non corrispondenteIl Nome file di caricamento nelle impostazioni del catalogo deve corrispondere esattamente al nome reale del file all'URL, inclusa l'estensione (.csv, .xml, .txt, .gz).Aggiorna il Nome file di caricamento nelle impostazioni del catalogo in modo che corrisponda esattamente al nome del file: una piccola discrepanza causa un Nessun catalogo trovato per la richiesta errore.
Discrepanza nel formato o nel delimitatoreConferma che il formato selezionato (CSV, TXT, XML, GMC) corrisponda al tuo file. Se utilizzi un file delimitato, verifica che il delimitatore (virgola, tabulazione, barra verticale) corrisponda a quanto configurato.Correggi il formato o il delimitatore nelle impostazioni del catalogo. Una discrepanza causa Nessun record valido trovato errori.
FTP/SFTP: credenziali o percorso non validiVerifica che il tuo URL utilizzi il formato: sftp://{username}:{password}@{host}/{file_path}. Il percorso deve puntare al file esatto, non solo a una directory. I caratteri speciali nelle credenziali devono essere codificati nell'URL (ad es., @ → %40).Testa le tue credenziali con un client FTP come FileZilla. Aggiorna l'URL con le credenziali corrette e il percorso completo del file.
Il download si interrompe per timeout o non riesce a connettersiIl firewall del tuo server potrebbe bloccare le richieste di impact.com.Contatta il tuo provider di hosting o il team IT per inserire nella lista consentita gli intervalli di indirizzi IP di impact.com.
L'URL richiede autenticazionePull From URL non supporta l'autenticazione basata su sessione o su cookie.Utilizza invece una delle seguenti opzioni: un URL di download diretto accessibile pubblicamente, HTTP Basic Auth incorporata nell'URL (https://user:pass@host/path), oppure FTP/SFTP con credenziali nell'URL. Se il tuo feed richiede l'accesso tramite browser, passa a Caricamento diretto o FTP Push.
L'URL supera i 2.048 caratteriGli URL firmati di archiviazione cloud possono superare il limite di 2.048 caratteri e potrebbero essere troncati.Usa un accorciatore di URL che preservi il download diretto, oppure ospita il file in un URL più breve.
Catalogo bloccato in Elaborazione o in sospesoControlla se il file è ancora accessibile all'URL e se la dimensione del file è insolitamente grande rispetto alla frequenza di prelievo.Verifica che il file sia disponibile. Se il catalogo rimane in Elaborazione o In sospeso, contatta l'assistenza per richiedere una rielaborazione manuale.
Il catalogo ha smesso di aggiornarsi automaticamenteControlla se il file è ancora disponibile allo stesso URL e se il nome del file, il formato o le impostazioni di accesso al server sono cambiati.Ripristina il file all'URL originale, oppure aggiorna le impostazioni del catalogo per riflettere il nuovo URL o nome file. Per cataloghi di grandi dimensioni (oltre 1 milione di articoli), considera di ridurre la frequenza di prelievo per evitare timeout.
Campi o dati mancanti dopo il caricamentoConferma che i nomi dei campi corrispondano alle specifiche del formato selezionato, ad esempio, campi di Google Merchant Center per il formato GMC. Associa i campi personalizzati al di fuori delle specifiche standard agli slot dei campi personalizzati di impact.com (Numeric1, Testo1, ecc.).Scarica il catalogo caricato da impact.com e confrontalo con il tuo file sorgente per identificare dove i dati vengono persi. Aggiorna i nomi dei campi o le mappature secondo necessità, quindi ricarica.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.