> 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).
# Risolvere errori e avvisi del catalogo prodotti
Ogni catalogo prodotti ha un punteggio di salute che mostra eventuali problemi nel tuo catalogo. Usa questa guida per risolvere gli errori e gli avvisi che impact.com segnala dopo aver elaborato il tuo catalogo e per correggere i problemi di visibilità per i partner, così il tuo catalogo rimane nella *Eccellente* fascia.
Se impact.com non riesce a ricevere il file del catalogo, consulta [Risoluzione dei problemi relativi ai caricamenti e alle connessioni del catalogo prodotti](/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/risoluzione-dei-problemi-relativi-ai-caricamenti-e-alle-connessioni-del-catalogo-prodotti.md).
{% hint style="info" %}
**Suggerimento:** Un catalogo in buono stato non significa solo eliminare gli errori. Segui le [Best practice per i cataloghi prodotti](/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) per mantenere i tuoi dati completi, ben strutturati e impostati per garantire un'ottima visibilità e prestazioni.
{% endhint %}
{% embed url="" %}
## Punteggi di salute del catalogo
1. Dal menu di navigazione a sinistra, seleziona  **\[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 elementi duplicati, la *Salute* colonna mostra quanti ce ne sono di ciascun tipo.
* I metodi di caricamento automatico aggiornano il tuo catalogo durante il successivo recupero pianificato.
Ogni catalogo mostra uno dei seguenti indicatori di salute nella *Salute* colonna:
* *In sospeso*: Il tuo catalogo prodotti è in attesa del primo caricamento o recupero dati.
* *In elaborazione*: Il tuo catalogo prodotti è in fase di elaborazione.
* *Eccellente*: Indica un catalogo in buono stato. Questo set di dati di prodotto è completo e ben strutturato, offrendo le migliori possibilità di ottenere buone prestazioni.
* *Buono*: Indica che alcuni campi suggeriti contenenti dati cruciali, come categoria o descrizione, potrebbero mancare. Colmare queste lacune migliora la qualità complessiva del tuo catalogo.
* *Scarso*: Indica che le informazioni obbligatorie mancano in oltre il 10% dei record forniti. Questo catalogo deve essere corretto e ricaricato.
## Risolvi gli errori e gli avvisi dopo il caricamento
Una volta ricevuto un file, impact.com convalida ogni record. Gli errori impediscono l'elaborazione dei record, mentre gli avvisi segnalano dati accettati ma che potrebbero causare problemi. Usa le sezioni qui sotto per interpretarli e risolverli.
### Visualizza errori e avvisi
1. Nella *Salute* colonna, seleziona i **errori**, **avvisi**, o **duplicati** link.
* Verrai reindirizzato a una pagina con maggiori dettagli. Solo il primo elemento di un insieme di duplicati è rappresentato in impact.com; tutti gli elementi duplicati rispetto al primo vengono ignorati.
2. Facoltativamente, usa il *Ricerca* campo e i filtri in cima alla pagina per ordinare i problemi.
3. Rivedi i problemi e apporta le modifiche necessarie, quindi ricarica il tuo catalogo prodotti.
Usa i seguenti filtri nella pagina dei dettagli per restringere i problemi:
* *Tipo di errore*: Filtra specificamente per *Errori*, *Avvisi*, *Duplicati*, o *Tutti* i problemi.
* *Obbligatorio*: Filtra eventuali campi obbligatori specifici mancanti del catalogo prodotti, oppure *Tutti* campi.
* *Suggeriti*: Filtra eventuali campi consigliati specifici mancanti del catalogo prodotti, oppure *Tutti* campi.
* *Non valido*: Filtra eventuali errori specifici basati sulla convalida, come un SKU duplicato, un codice categoria Google non valido o altri errori.
### Messaggi comuni di errore e avviso
Trova il messaggio mostrato dal tuo catalogo, sia nella *Stato del caricamento* colonna o nella pagina dei dettagli che apri dalla *Salute* colonna. Usa la spiegazione per risolverlo.
| Messaggio | Spiegazione |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Record 'X': campo/i obbligatorio/i mancanti: (nome campo)* | La riga specificata non contiene uno o più campi obbligatori. |
| *Record 'X': CatalogItemId(CatalogItemId): campo/i obbligatorio/i mancanti: (nome campo)* | Una riga nel file di dati non contiene un campo obbligatorio. |
| *Nessun catalogo trovato per la richiesta. Verifica che il nome del file caricato sia lo stesso registrato con il catalogo* | Il *Nome file di caricamento* impostato nella *Metodo di caricamento* sezione durante la creazione del catalogo 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 ID compare più di una volta nel catalogo e quelli successivi al primo verranno ignorati* | Due o più elementi hanno lo stesso ID. Tutti i prodotti richiedono un valore univoco e gli elementi duplicati non vengono elaborati. |
| *Il record 'X' contiene un errore: (riga X) carattere non valido tra token racchiuso e delimitatore* | Una riga contiene un uso non valido delle virgolette doppie. Racchiudi il campo tra virgolette doppie e sostituisci tutte le altre virgolette doppie con due virgolette doppie. |
| *(Riga iniziale X) EOF raggiunto prima che il token racchiuso sia completato* | EOF significa "fine del file". La riga iniziale menzionata ha una virgoletta doppia di apertura senza una di chiusura, oppure un'interruzione di riga imprevista ha interrotto il flusso di dati. |
| *Errore durante l'analisi del campo (tipo catalogo): con valore: (campo)* | Il campo prodotto non è valido e non può essere accettato. |
| *Il record (recordNumber) contiene un errore: il numero di valori delimitati (FieldsLength) non corrisponde a quello previsto (ColumnNamesLength)* | Per una riga specifica, sono presenti dati in una colonna senza intestazione. |
| *Non sono stati trovati record validi nel file del catalogo. Verifica il contenuto del file rispetto al formato del catalogo configurato e ricaricalo.* | impact.com ha letto il file, ma non contiene alcun record di prodotto. Verifica che il file includa i tuoi prodotti e corrisponda al formato del catalogo selezionato, quindi ricaricalo. |
| *Oltre il 10% dei record nel file conteneva errori, quindi il catalogo non è stato aggiornato. Rivedi e correggi i record e ricarica il file.* | Troppi record presentano errori perché il catalogo possa essere aggiornato. Questo include i file in cui ogni record contiene errori. Vedi [*Comprendere la soglia di errore del 10%*](#understand-the-10-error-threshold) di seguito. |
| *Il file del catalogo non è un XML valido e non è stato possibile leggerlo. Assicurati che il file sia un XML ben formato e ricaricalo.* | Il file XML è vuoto, troncato o contiene tag non chiusi, quindi impact.com non può leggerlo. Correggi l'XML in modo che sia ben formato, poi ricaricalo. |
| *Il file non sembra essere in un formato feed RSS o Atom valido. Verifica che il file corrisponda al formato del catalogo configurato e ricaricalo.* | Il file non è un feed RSS o Atom, ad esempio quando una pagina web di errore viene salvata al posto del feed. Un file XML del catalogo deve contenere `rss`, `RDF`, o `feed` nel suo elemento iniziale. |
| *Non siamo riusciti a leggere il contenuto del tuo file del catalogo...* | impact.com non riesce a leggere il contenuto del file. Le cause comuni sono un file vuoto, una struttura del file imprevista, delimitatori non validi o una codifica dei caratteri errata. Verifica che il file corrisponda al formato del catalogo selezionato, quindi ricaricalo. Se il problema persiste, [contatta l'assistenza](https://app.impact.com/support/portal.ihtml). |
| *Non siamo riusciti a recuperare il file del catalogo dall'URL di prelievo configurato. Verifica l'URL e che il file sia raggiungibile.* | impact.com non riesce a scaricare il file dalla *URL di prelievo* nelle impostazioni del catalogo. Vedi [*Preleva da URL*](/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/risoluzione-dei-problemi-relativi-ai-caricamenti-e-alle-connessioni-del-catalogo-prodotti.md#pull-from-url-recommended) in Risoluzione dei problemi relativi ai caricamenti e alle connessioni del catalogo prodotti per risolvere il problema dell'URL. |
| *L'elaborazione non è riuscita a causa di un errore interno del sistema...* | Non è richiesta alcuna azione da parte tua. L'ultimo catalogo elaborato con successo continua a essere disponibile per i partner. 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 ha un protocollo valido* | Il valore del campo non è un URL formattato correttamente. |
### Avvisi di formattazione e delimitatori
Nei file delimitati (CSV e TSV), un delimitatore o un'interruzione di riga fuori posto può dividere i dati nel punto sbagliato e impedire l'elaborazione corretta dei record. Usa la tabella seguente per risolvere questi avvisi.
| Problema | Come risolverlo |
| ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Problemi di delimitatore: una virgola, un tabulatore o una riga vuota errati interrompono il confine tra i campi. | Correggi l'uso dei delimitatori nel file del catalogo in modo che ogni campo sia separato in modo coerente, quindi ricaricalo. |
| Le nuove righe in un campo descrizione interrompono l'elaborazione del record. | Le interruzioni di riga non sono supportate nei formati di testo delimitato (CSV e TSV). Rimuovi le interruzioni di riga dai campi di testo come le descrizioni prima del caricamento. |
{% hint style="info" %}
**Formato eBay Commerce Merchant Center:** In un `.csv` file, sostituisci gli spazi nei valori della colonna del campo (categorie) con trattini bassi. Ad esempio, usa `Item_Title` invece di `Item Title`.
{% endhint %}
### Errori del formato Google Merchant Center
Se utilizzi il formato Google Merchant Center (GMC), la maggior parte dei problemi riguarda la `sezione Categoria` del formato, i valori predefiniti dei campi o la struttura XML.
#### Categoria prodotto Google mancante
Quando selezioni *errori* nella *Cataloghi prodotti* schermata, potresti vedere *Categoria prodotto Google mancante* nella *colonna Suggerimenti* Questo significa che nel tuo catalogo non è stato incluso alcun codice categoria Google o stringa completa della categoria Google.
Per risolvere il problema, fai riferimento al tuo [account Google Merchant Center](https://merchants.google.com/). Google suggerisce automaticamente le categorie per gli articoli; usa questi suggerimenti quando carichi il catalogo corretto.
#### Mancata corrispondenza della categoria prodotto Google
Quando selezioni *errori* nella *Cataloghi prodotti* schermata, potresti vedere *Mancata corrispondenza della categoria prodotto Google* nella *Non valido* colonna. Questo significa che la categoria usata per gli articoli nel tuo catalogo non corrisponde al [codice tassonomico](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) (ad esempio, 7386) o al formato completo della categoria fornito da Google, ad esempio:
`Animali e articoli per animali > Articoli per animali > Articoli per uccelli > Accessori per gabbie per uccelli > Ciotole per cibo e acqua per gabbie per uccelli`
Per risolvere il problema, correggi il formato con cui sono elencate le categorie prodotto Google, quindi ricarica il catalogo.
#### Valore di disponibilità non accettato
Un errore come *Impossibile analizzare il campo: availability con valore* significa che un campo predefinito usa un valore che GMC non riconosce. Per i cataloghi GMC, categorie e valori devono essere esatti.
* Usa `availability` per il campo availability.
* I valori di availability supportati sono `in_stock`, `out_of_stock`, `preorder`, e `backorder`.
* Controlla eventuali simboli speciali che possono influire sulla formattazione, ad esempio un simbolo di valuta che appare in un campo valore.
#### Errori di struttura XML
Se carichi un catalogo Google Merchant Center (formato XML) e vedi *Il file non sembra essere un formato feed RSS o Atom valido*, la struttura XML è probabilmente errata.
Il file XML deve contenere `rss`, `RDF`, o `feed` nel suo elemento iniziale. Correggi l'elemento radice e ricaricalo.
Se vedi *Il file del catalogo non è XML valido e non è stato possibile leggerlo*, il file è vuoto, troncato o contiene tag non chiusi. Correggi l'XML in modo che sia ben formato, poi ricaricalo.
### Comprendere la soglia di errore del 10%
Se più del 10% dei record in un file caricato contiene errori, il file non viene elaborato. Quando ciò accade:
* Il tuo catalogo continua a mostrare la versione dell'ultimo caricamento riuscito, quindi una più vecchia *ultimo invio riuscito* il timestamp è previsto.
* Il **Visualizza prodotti** l'opzione appare solo se un file è stato caricato correttamente in precedenza per quell'ID catalogo.
Correggi i record segnalati in modo che meno del 10% contenga errori, quindi ricarica.
## Risolvi i problemi di visibilità per i partner e dei link di tracciamento
Un catalogo in buono stato non raggiungerà comunque i tuoi partner finché non [lo rendi disponibile](#partners-cant-see-the-catalog) e soddisfi i [requisiti di visibilità per i partner](#partners-cant-see-or-search-specific-products). Usa questa sezione se il tuo catalogo è stato elaborato correttamente ma i partner stanno riscontrando problemi di visibilità, accesso ai prodotti o link di tracciamento.
### I partner non possono vedere il catalogo
Controlla le seguenti due impostazioni:
* Assicurati che il catalogo sia disponibile per l'uso:
1. Seleziona  **\[Engage]** **→** **Contenuti** **→** **Prodotti** **→** [**Cataloghi prodotti**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) e trova il catalogo.
2. Seleziona  **\[Altro]** e poi scegli **Rendi disponibile per l'uso**.
* Verifica se l'accesso per i partner è limitato:
1. Seleziona  **\[Engage]** **→** **Contenuti** **→** **Prodotti** **→** [**Cataloghi prodotti**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) e trova il catalogo.
2. Passa il mouse sul catalogo, quindi seleziona **Modifica**.
3. Nella *Limita l'accesso ai partner* nella sezione, verifica se **Consenti l'accesso solo a partner specifici** è  attivato.
4. Se lo è, .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) disattivalo e seleziona **Salva**.
{% hint style="success" %}
**Nota:** Il **Rendi disponibile per l'uso** l'opzione appare solo per cataloghi con *Eccellente* o *Buono* salute che sono *Inattivi* o *In attesa di attivazione*.
{% endhint %}
### I partner non possono vedere o cercare prodotti specifici
Per essere visibile nell'interfaccia utente del partner, un prodotto deve soddisfare tutti i seguenti requisiti:
* Il prezzo originale è superiore a 2,00 USD.
* La disponibilità di magazzino del prodotto non è *Esaurito.*
* Il prodotto ha un URL prodotto valido che porta a una pagina di dettagli del prodotto attiva.
* Il prodotto ha un URL immagine.
* Il prodotto è in un catalogo senza [regole](/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/create-and-manage-product-catalog-rules.md) applicate.
### I link di tracciamento per i partner restituiscono un errore "malformed"
Se i partner vedono "The link you clicked on is malformed" quando usano i link di tracciamento dei tuoi prodotti, il deep linking di solito non è abilitato oppure il dominio della pagina di destinazione del prodotto non è impostato come dominio consentito. Per abilitare il deep linking, imposta i domini consentiti e risolvi questo errore, vedi [Configura i domini consentiti per il deep linking](/brand/it/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/set-up-permitted-domains-for-deep-linking.md).
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
