> 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* intervallo, devi risolvere e correggere eventuali errori, avvisi e duplicati presenti al suo interno. {% embed url="" %} 1. Dal menu di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage]** → **Contenuti** → **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 righe duplicate, vedrai quanti di ciascuno sono presenti 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 attesa** | Il tuo catalogo prodotti è in fase di caricamento. | | **In elaborazione** | Il tuo catalogo prodotti è in fase di elaborazione. | | **Eccellente** | Indica un catalogo sano: questo set di dati di prodotto è completo e ben strutturato, il che gli offre le migliori possibilità di funzionare efficacemente. | | **Buono** | Indica che alcuni campi suggeriti che contengono dati cruciali come categoria o stato potrebbero mancare. Colmare queste lacune migliorerà la qualità complessiva del tuo catalogo. | | **Scarso** | Indica che le informazioni richieste mancano in più del 10% dei record inviati. Questo catalogo dovrà essere corretto e ricaricato. |
#### Visualizza errori e avvisi 1. Nella *Salute* colonna, seleziona il **errori**, **avvisi**, o **duplicati** link. * Verrai reindirizzato a una pagina con maggiori dettagli sugli errori o gli avvisi. Solo il primo elemento in un insieme di duplicati sarà rappresentato in impact.com; tutti gli elementi che duplicano il primo verranno ignorati. 2. Facoltativamente, usa il *Ricerca* campo e i filtri nella parte superiore della pagina per ordinare i problemi.
Descrizioni dei filtri | | | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Tipo di errore** | Puoi filtrare in modo specifico per *Errori*, *Avvisi*, *Duplicati*, o *Tutti* problemi. | | **Obbligatorio** | Puoi filtrare per eventuali campi obbligatori mancanti specifici del catalogo prodotti o *Tutti* campi. | | **Suggerito** | Puoi filtrare per eventuali campi consigliati mancanti specifici del catalogo prodotti o *Tutti* campi. | | **Non valido** | Puoi filtrare per qualsiasi errore specifico basato sulla convalida. Può trattarsi di un SKU duplicato, di un codice categoria Google non valido o di altri errori. |
3. Rivedi i problemi e apporta le modifiche necessarie. 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 ha 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 dati del catalogo prodotti non contiene dati elaborabili. | | *L'elemento del catalogo con ID compare più di una volta nel catalogo, e quelli dopo il primo verranno 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: (riga X) carattere non valido tra token racchiuso e delimitatore* | Una riga nel file di dati contiene un uso non valido delle virgolette doppie. Queste devono essere gestite correttamente racchiudendo il campo tra virgolette doppie e sostituendo tutte le altre virgolette doppie con 2 virgolette doppie (ad es., *3" floppy* diventa *"3"" floppy"*). | | *(Riga iniziale X) EOF raggiunto prima che il token racchiuso sia terminato* |

EOF significa "fine del file". La riga iniziale menzionata ha una virgoletta doppia iniziale 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 nell'analisi del campo (tipo di catalogo): con valore: (campo)* | Il campo prodotto non è valido e non può essere accettato. | | *Record (recordNumber) ha un errore: il numero di valori delimitati (FieldsLength) non corrisponde a quello previsto (ColumnNamesLength)* | Per una determinata riga di dati, se i dati esistono in una colonna senza intestazione, si verifica 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.* | Se si verifica questo errore, il file di dati non può essere elaborato. | | *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 lavorando per risolvere il problema. L'ultimo catalogo elaborato con successo continuerà a essere disponibile per i Media Partner. Contatta l'assistenza impact.com se hai bisogno di ulteriori informazioni.* | Fai riferimento alla [pagina di stato di impact.com](https://status.impact.com/) per i dettagli sulle interruzioni del servizio. | | *Il campo (nome campo) con valore (valore campo) non dispone di 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 sorgeranno nella `Categoria` sezione. {% tabs %} {% tab title="Categoria prodotto Google mancante" %} Quando selezioni *errori* nella *Cataloghi prodotti* schermata, potresti vedere *Categoria prodotto Google mancante* nella *Suggerimenti* colonna. Questo significa che nel tuo catalogo non sono stati inclusi né un 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 elementi: questo suggerimento dovrebbe essere usato quando carichi il catalogo corretto.
{% endtab %} {% tab title="Disallineamento della categoria prodotto Google" %} Quando selezioni *errori* nella *Cataloghi prodotti* schermata, potresti vedere *Disallineamento della categoria prodotto Google* nella *Non valido* colonna. Questo significa che la categoria utilizzata per gli elementi nel tuo catalogo non corrisponde al previsto [codice tassonomia](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) (ad es., 7386) o al formato di categoria completo fornito da Google. Vedi l'esempio qui sotto di un formato completo della categoria Google. `Animali e forniture per animali > Forniture per animali > Forniture 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 *Estrai da URL* problemi Se il tuo catalogo è configurato per estrarre da un URL e non si carica, non si aggiorna o non si elabora correttamente, usa la tabella seguente per identificare 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 di destinazione di archiviazione cloud o 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.
Disallineamento di formato o delimitatoreConferma che il formato selezionato (CSV, TXT, XML, GMC) corrisponda al tuo file. Se usi un file delimitato, verifica che il delimitatore (virgola, tabulazione, pipe) corrisponda a quello configurato.Correggi il formato o il delimitatore nelle impostazioni del catalogo. Un disallineamento 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 recupero va in 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 aggiungere alla allowlist gli intervalli di indirizzi IP di impact.com.
L'URL richiede autenticazionePull From URL non supporta l'autenticazione basata su sessione o cookie.Usa invece una delle seguenti opzioni: un URL di download diretto accessibile pubblicamente, l'Autenticazione di base HTTP 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 mantenga intatto il download diretto, oppure ospita il file su un URL più breve.
Catalogo bloccato in Elaborazione o In attesaControlla se il file è ancora accessibile all'URL e se la dimensione del file è insolitamente grande rispetto alla frequenza di recupero.Verifica che il file sia disponibile. Se il catalogo rimane in In elaborazione o In attesa, 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 il nuovo nome del file. Per cataloghi di grandi dimensioni (oltre 1 milione di elementi), considera di ridurre la frequenza di estrazione 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. Mappa i campi personalizzati al di fuori della specifica standard negli slot di campi personalizzati di impact.com (Numerico1, Testo1, ecc.).Scarica il tuo catalogo caricato da impact.com e confrontalo con il tuo file di origine 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.