> 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 integrità che segnala eventuali problemi nel catalogo. Usa questa guida per risolvere gli errori e gli avvisi segnalati da impact.com dopo l'elaborazione del catalogo e per correggere i problemi di visibilità per i partner, così da mantenere il catalogo nell'intervallo *<mark style="color:$success;">Eccellente</mark>* .

Se impact.com non riesce a ricevere il file del catalogo, consulta [Risoluzione dei problemi di caricamento e connessione dei cataloghi prodotti](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-uploads-and-connections.md).

{% hint style="info" %}
**Suggerimento:** Un catalogo in buono stato non si ottiene soltanto eliminando gli errori. Segui le [Best practice per i cataloghi prodotti](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) per mantenere i dati completi e ben strutturati e configurare il catalogo in modo da favorirne visibilità e prestazioni.
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FZTsEfqMM8xnWruw90lbm%2Feng-350-5.mp4?alt=media&token=80c0e779-2118-482b-9a88-10ff3da3f8a4>" %}

## Punteggi di integrità del catalogo

1. Nel menu di navigazione a sinistra, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **Contenuti** **→** **Prodotti** **→** [**Cataloghi prodotti**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. Se un catalogo contiene errori, avvisi o righe duplicate, la colonna *Integrità* indica quanti elementi di ciascun tipo sono presenti.

   * I metodi di caricamento automatico aggiornano il catalogo al successivo recupero pianificato.

   <div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fwb6UpOjdauuM3qPQDscv%2FScreenshot%202026-05-08%20at%2012.11.55.png?alt=media&amp;token=02870515-9607-4c35-9672-a7797df388b2" alt="" width="563"><figcaption></figcaption></figure></div>

Ogni catalogo mostra uno dei seguenti indicatori di integrità nella colonna *Integrità* :

* *<mark style="color:$info;">In attesa</mark>*: Il catalogo prodotti è in attesa del primo caricamento o recupero dei dati.
* *<mark style="color:arancione;">Elaborazione in corso</mark>*: Il catalogo prodotti è in fase di elaborazione.
* *<mark style="color:$success;">Eccellente</mark>*: Indica che il catalogo è in buono stato. Questo insieme di dati sui prodotti è completo e ben strutturato, offrendo le migliori possibilità di ottenere buoni risultati.
* *<mark style="color:$warning;">Buono</mark>*: Indica che potrebbero mancare alcuni campi consigliati contenenti dati cruciali, come la categoria o la descrizione. Colmare queste lacune migliora la qualità complessiva del catalogo.
* *<mark style="color:$danger;">Scarso</mark>*: Indica che manca un'informazione obbligatoria in oltre il 10% dei record forniti. Questo catalogo deve essere corretto e caricato di nuovo.

## Risoluzione degli errori e degli 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 che potrebbero causare problemi. Usa le sezioni seguenti per interpretarli e risolverli.

### Visualizzare errori e avvisi

1. Nella colonna *Integrità* seleziona il link **errori**, **avvisi**, o **duplicati** .
   * Verrai reindirizzato a una pagina con maggiori dettagli. In impact.com è rappresentato solo il primo elemento di un gruppo di duplicati; tutti gli elementi duplicati del primo vengono ignorati.
2. Facoltativamente, usa il *Cerca* campo e i filtri nella parte superiore della pagina per esaminare i problemi.
3. Esamina i problemi e apporta le modifiche necessarie, quindi carica nuovamente il catalogo dei prodotti.

Usa i seguenti filtri nella pagina dei dettagli per restringere l'elenco dei problemi:

* *Tipo di errore*: filtra specificamente per *Errori*, *Avvisi*, *Duplicati*, oppure *Tutti* i problemi.
* *Obbligatorio*: filtra per eventuali campi obbligatori specifici mancanti nel catalogo dei prodotti, oppure *Tutti* i campi.
* *Consigliato*: filtra per eventuali campi consigliati specifici mancanti nel catalogo dei prodotti, oppure *Tutti* i campi.
* *Non valido*: filtra per eventuali errori di convalida specifici, ad esempio uno SKU duplicato, un codice categoria Google non valido o altri errori.

### Messaggi comuni di errore e avviso

Individua il messaggio visualizzato nel catalogo, nella colonna *Stato del caricamento* oppure nella pagina dei dettagli aperta dalla colonna *Stato* . Usa la spiegazione per risolvere il problema.

| Messaggio                                                                                                                                                                     | Spiegazione                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Record 'X': campi obbligatori mancanti: (nome del campo)*                                                                                                                    | Alla riga specificata mancano uno o più campi obbligatori.                                                                                                                                                                                                                                                                                                                                                                                              |
| *Record 'X': CatalogItemId(CatalogItemId): campi obbligatori mancanti: (nome del campo)*                                                                                      | A una riga del file di dati manca un campo obbligatorio.                                                                                                                                                                                                                                                                                                                                                                                                |
| *Nessun catalogo trovato per la richiesta. Verifica che il nome del file caricato corrisponda a quello registrato nel catalogo*                                               | Il *Nome del file caricato* impostato nella sezione *Metodo di caricamento* durante la creazione del catalogo non corrisponde esattamente al nome del file caricato.                                                                                                                                                                                                                                                                                    |
| *Nessun attributo presente nel file del catalogo*                                                                                                                             | Il file di dati del catalogo dei prodotti non contiene dati elaborabili.                                                                                                                                                                                                                                                                                                                                                                                |
| *Nel catalogo è presente più di una voce con lo stesso ID; quelle successive alla prima verranno ignorate*                                                                    | Due o più articoli hanno lo stesso ID. Ogni prodotto deve avere un valore univoco e gli articoli duplicati non vengono elaborati.                                                                                                                                                                                                                                                                                                                       |
| *Il record 'X' contiene un errore: (riga X) carattere non valido tra il token racchiuso e il 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. I cataloghi di Google Merchant Center (formato TXT) accettano virgolette doppie non precedute da caratteri di escape, ad esempio `18"` in un titolo di prodotto.                                                                                                        |
| *(Riga iniziale X) EOF raggiunto prima che il token racchiuso fosse completato*                                                                                               | EOF significa «fine del file». Nella riga iniziale indicata è presente una virgoletta doppia di apertura senza la corrispondente virgoletta di chiusura, oppure un'interruzione di riga imprevista ha interrotto il flusso di dati.                                                                                                                                                                                                                     |
| *Errore durante l'analisi del campo (tipo di catalogo): valore: (campo)*                                                                                                      | Il campo del prodotto non è valido e non può essere accettato.                                                                                                                                                                                                                                                                                                                                                                                          |
| *Il record (recordNumber) contiene un errore: il numero di valori delimitati (FieldsLength) non corrisponde al numero previsto (ColumnNamesLength)*                           | Per una determinata riga, sono presenti dati in una colonna senza intestazione.                                                                                                                                                                                                                                                                                                                                                                         |
| *Non è stato trovato alcun record valido nel file del catalogo. Verifica che il contenuto del file corrisponda al formato di catalogo configurato, quindi caricalo di nuovo.* | 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 di catalogo selezionato, quindi caricalo di nuovo.                                                                                                                                                                                                                                                         |
| *Oltre il 10% dei record del file conteneva errori, pertanto il catalogo non è stato aggiornato. Esamina e correggi i record, quindi carica di nuovo il file.*                | Troppi record contengono errori perché il catalogo possa essere aggiornato. Questo vale anche per i file in cui tutti i record contengono errori. Consulta [*Scopri la soglia di errore del 10%*](#understand-the-10-error-threshold) qui sotto.                                                                                                                                                                                                        |
| *Il file del catalogo non è un XML valido e non è stato possibile leggerlo. Assicurati che il file sia un XML ben formato, quindi caricalo di nuovo.*                         | Il file XML è vuoto, incompleto o contiene tag non chiusi, quindi impact.com non riesce a leggerlo. Correggi il file affinché sia un XML ben formato, quindi caricalo di nuovo.                                                                                                                                                                                                                                                                         |
| *Il file non sembra essere un feed RSS o Atom valido. Verifica che corrisponda al formato di catalogo configurato, quindi caricalo di nuovo.*                                 | Il file non è un feed RSS o Atom, ad esempio quando al posto del feed viene salvata una pagina web di errore. Un file di catalogo XML deve contenere `rss`, `RDF`, oppure `feed` nel suo elemento iniziale.                                                                                                                                                                                                                                             |
| *Non è stato possibile leggere il contenuto del file del catalogo...*                                                                                                         | impact.com non riesce a leggere il contenuto del file. Le cause più comuni sono un file vuoto, una struttura imprevista, delimitatori non validi o una codifica dei caratteri errata. Verifica che il file corrisponda al formato di catalogo selezionato, quindi caricalo di nuovo. Se il problema persiste, [contatta l'assistenza](https://app.impact.com/support/portal.ihtml).                                                                     |
| *Non è stato possibile recuperare il file del catalogo dall'URL di recupero configurato. Verifica che l'URL sia corretto e che il file sia raggiungibile.*                    | impact.com non riesce a scaricare il file dall' *URL di recupero* nelle impostazioni del catalogo. Consulta [*Recupero da URL*](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-uploads-and-connections.md#pull-from-url-recommended) nella sezione Risoluzione dei problemi relativi ai caricamenti e alle connessioni del catalogo prodotti per verificare l'URL. |
| *L'elaborazione non è riuscita a causa di un errore interno del sistema...*                                                                                                   | Non devi fare nulla. L'ultimo catalogo elaborato correttamente continua a essere disponibile per i partner. Consulta la [pagina di stato di impact.com](https://status.impact.com/) per informazioni sulle interruzioni del servizio.                                                                                                                                                                                                                   |
| *Il campo (nome del campo) con valore (valore del campo) non contiene un protocollo valido*                                                                                   | Il valore del campo non è un URL formattato correttamente.                                                                                                                                                                                                                                                                                                                                                                                              |

### Avvisi relativi alla formattazione e ai delimitatori

Nei file delimitati (CSV e TSV), un delimitatore o un'interruzione di riga posizionati in modo errato possono suddividere i dati nel punto sbagliato e impedire la corretta elaborazione dei record. Usa la tabella seguente per risolvere questi avvisi.

| Problema                                                                                                                         | Come risolvere                                                                                                                                                                                                                        |
| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Problemi con i delimitatori: una virgola o una tabulazione errata, oppure una riga vuota, interrompe la separazione tra i campi. | Correggi l'uso dei delimitatori nel file del catalogo in modo che ogni campo sia separato in modo coerente, quindi carica di nuovo il file. Nei cataloghi di Google Merchant Center in formato TXT, impact.com ignora le righe vuote. |
| Le interruzioni di riga in un campo descrizione impediscono l'elaborazione dei record.                                           | Le interruzioni di riga non sono supportate nei formati di testo delimitati (CSV e TSV). Rimuovi le interruzioni di riga dai campi di testo, ad esempio dalle descrizioni, prima di caricare il file.                                 |

{% hint style="info" %}
**Formato eBay Commerce Merchant Center:** In un file `.csv` sostituisci gli spazi nei valori della colonna del campo (categorie) con trattini bassi. Ad esempio, usa `Item_Title` anziché `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 `Category` del formato, i valori dei campi predefiniti o la struttura XML.

#### Categoria prodotto Google mancante

Quando selezioni *errori* nella schermata *Cataloghi prodotti* potresti visualizzare *Categoria prodotto Google mancante* nella colonna *Suggerimenti* . Significa che nel catalogo non è stato incluso un codice di categoria Google o il nome completo della categoria Google.

Per risolvere il problema, consulta il 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.

<div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c92f932de0c30c466560ef0f2b9c13a8f48100a2%2Fb61fc4733fe334479ac8dcd599a078e24be5c384633e0414cb57ba3ae9350ed3.png?alt=media" alt="" width="413"><figcaption></figcaption></figure></div>

#### Categoria prodotto Google non corrispondente

Quando selezioni *errori* nella schermata *Cataloghi prodotti* potresti visualizzare *Categoria prodotto Google non corrispondente* nella colonna *Non valido* . Significa che la categoria usata per gli articoli nel catalogo non corrisponde al [codice tassonomico](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) previsto (ad esempio, 7386) o al formato completo della categoria fornito da Google, ad esempio:

`Animals & Pet Supplies > Pet Supplies > Bird Supplies > Bird Cage Accessories > Bird Cage Food & Water Dishes`

Per risolvere il problema, correggi il formato dell'elenco delle categorie prodotto Google, quindi carica di nuovo il catalogo.

<div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-a49a1b97a47722c72fe9bbb76fd2e902c1ca39ae%2F629fe5a5a308cd2ed6bd628db9c9c22547490d92bb19d1011d1657669d9b6296.png?alt=media" alt=""><figcaption></figcaption></figure></div>

#### Valore di disponibilità non accettato

Un errore come *Could not parse field: availability with value* significa che un campo predefinito usa un valore non riconosciuto da GMC.

* Usa `availability` per il campo della disponibilità.
* Usa uno dei valori di disponibilità supportati: `in_stock`, `out_of_stock`, `preorder`, oppure `backorder`. impact.com accetta anche le varianti riportate di seguito e le converte nel valore supportato.
* Verifica la presenza di simboli speciali che possono influire sulla formattazione, ad esempio un simbolo di valuta in un campo valore. I codici valuta non distinguono tra maiuscole e minuscole, quindi impact.com interpreta `19.99 usd` come `19.99 USD`.

| Valore supportato | Accettato anche              |
| ----------------- | ---------------------------- |
| `in_stock`        | `In Stock`, `InStock`        |
| `out_of_stock`    | `Out Of Stock`, `OutOfStock` |
| `preorder`        | `PreOrder`                   |
| `backorder`       | `BackOrder`                  |

#### Errori nella struttura XML

Se carichi un catalogo di Google Merchant Center (formato XML) e visualizzi *Il file non sembra essere un feed RSS o Atom valido*, è probabile che la struttura XML non sia corretta.

Il file XML deve contenere `rss`, `RDF`, oppure `feed` nell'elemento iniziale. Correggi l'elemento radice e carica di nuovo il file.

Se visualizzi *Il file del catalogo non è un XML valido e non è stato possibile leggerlo*, il file è vuoto, incompleto o contiene tag non chiusi. Correggi l'XML in modo che sia ben formato, quindi carica di nuovo il file.

### Comprendere la soglia di errore del 10%

Se più del 10% dei record di un file caricato contiene errori, il file non viene elaborato. In questo caso:

* Il catalogo continua a mostrare la versione dell'ultimo caricamento riuscito, quindi è normale che *l'indicazione temporale dell'ultimo invio riuscito* sia precedente.
* L'opzione **Visualizza prodotti** viene mostrata solo se il catalogo con quell'ID è già stato caricato correttamente in precedenza.

Correggi i record segnalati in modo che gli errori riguardino meno del 10% dei record, quindi carica di nuovo il file.

## Risolvere i problemi di visibilità per i partner e dei link di tracciamento

Anche se il catalogo funziona correttamente, i partner non potranno accedervi finché non [lo rendi disponibile](#partners-cant-see-the-catalog) e non soddisfi i [requisiti di visibilità per i partner](#partners-cant-see-or-search-specific-products). Usa questa sezione se il catalogo è stato elaborato correttamente, ma i partner hanno problemi di visibilità, accesso ai prodotti o link di tracciamento.

### I partner non riescono a vedere il catalogo

Controlla le due impostazioni seguenti:

* Assicurati che il catalogo sia disponibile per l'uso:
  1. Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Coinvolgimento]** **→** **Contenuti** **→** **Prodotti** **→** [**Cataloghi prodotti**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) e individua il catalogo.
  2. Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FaMIlbqH54V4Ow5JvT0I0%2F%5BMore%5D%20vNext%202.svg?alt=media\&token=6d5449e8-e413-48fa-b059-58ebb3e2c271) **\[Altro]** e poi scegli **Rendi disponibile per l'uso**.
* Verifica se l'accesso dei partner è limitato:
  1. Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Coinvolgimento]** **→** **Contenuti** **→** **Prodotti** **→** [**Cataloghi prodotti**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) e individua il catalogo.
  2. Passa il puntatore sul catalogo, quindi seleziona **Modifica**.
  3. Nella sezione *Limita l'accesso dei partner* , verifica se **Consenti l'accesso solo a partner specifici** è ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) attivato.
  4. In tal caso, ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FACIoqj1Ayhx8QzL9aqYB%2Ftoggle-off-solid%20\(1\).svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) disattivalo e seleziona **Salva**.

{% hint style="success" %}
**Nota:** L'opzione **Rendi disponibile per l'uso** viene visualizzata solo per i cataloghi con un livello di salute *Ottimo* o *Buono* che sono *Inattivi* o *In attesa di attivazione*.
{% endhint %}

### I partner non possono visualizzare o cercare prodotti specifici

Per essere visibile nell'interfaccia dei 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 valido che rimanda a una pagina dei dettagli del prodotto attiva.
* Il prodotto ha un URL immagine.
* Il prodotto si trova in un catalogo a cui non sono applicate [regole](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/create-and-manage-product-catalog-rules.md) .

### I link di tracciamento dei partner restituiscono un errore "malformed"

Se i partner visualizzano il messaggio "The link you clicked on is malformed" quando usano i link di tracciamento dei tuoi prodotti, in genere il deep linking non è abilitato oppure il dominio della pagina di destinazione del prodotto non è impostato come dominio consentito. Per abilitare il deep linking, impostare i domini consentiti e risolvere questo errore, consulta [Configurare i domini consentiti per il deep linking](https://help.impact.com/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=<question>&goal=<user_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.
