> 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-uploads-and-connections.md).

# Risoluzione dei problemi relativi ai caricamenti e alle connessioni del catalogo prodotti

Prima che impact.com possa elaborare un catalogo prodotti, deve ricevere correttamente il file del catalogo. Questa guida è organizzata in base al metodo di caricamento: vai alla sezione relativa al metodo usato dal tuo catalogo: [*Recupero da URL*](#pull-from-url-recommended), [*Importazione dal carrello degli acquisti integrato*](#integrated-shopping-cart-import-recommended), [*server FTP di impact.com*](#impact.com-ftp-server), [*server SFTP di impact.com*](#impact.com-sftp-server), oppure [*Caricamento diretto*](#direct-upload). Se non sai quale metodo usa il tuo catalogo, modificalo e controlla le [*Metodo di caricamento* impostazioni](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md#upload-your-product-catalog).

impact.com consiglia *il recupero da URL* o *l'importazione dal carrello degli acquisti integrato*, perché impact.com controlla quando recuperare il catalogo e con quale frequenza aggiornarlo. Se usi il server FTP di impact.com, il server SFTP di impact.com o il *caricamento diretto*, spetta a te fornire regolarmente dati aggiornati del catalogo, preferibilmente ogni giorno, anche se va bene anche una volta alla settimana.

Se impact.com ha ricevuto il file, ma il catalogo mostra errori o avvisi, consulta [Risoluzione degli errori e degli avvisi del catalogo prodotti](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md).

## Recupero da URL (consigliato)

I protocolli supportati per il *recupero da URL* sono `http://`, `https://`, `ftp://`, e `sftp://`. Se il catalogo non viene caricato, aggiornato o elaborato correttamente, usa la tabella seguente per individuare e risolvere il problema.

| Problema                                             | Cosa controllare                                                                                                                                                                                                                                                                                                                                                           | Come risolvere                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| L'URL non è un link per il download diretto          | Apri l'URL in un browser. Se reindirizza a una pagina di accesso o a una pagina di destinazione di un servizio di archiviazione cloud, oppure restituisce un errore 404 o 403, l'URL non è un link per il download diretto.                                                                                                                                                | Aggiorna l'URL inserendone uno che scarichi direttamente il file o lo mostri come dati non elaborati quando viene aperto in un browser.                                                                                                                                                                                                                           |
| Nome del file non corrispondente                     | Il *Nome file di caricamento* nelle impostazioni del catalogo deve corrispondere esattamente al nome effettivo del file all'URL, inclusa l'estensione (`.csv`, `.xml`, `.txt`, `.gz`).                                                                                                                                                                                     | Aggiorna il *Nome file di caricamento* in modo che corrisponda esattamente al nome del file. Anche una piccola discrepanza causa un errore *Nessun catalogo trovato per la richiesta* .                                                                                                                                                                           |
| Formato o delimitatore non corrispondente            | Verifica che il formato selezionato (CSV, TXT, XML, GMC) corrisponda al tuo file. Se usi un file delimitato, verifica che il delimitatore (virgola, tabulazione, barra verticale) corrisponda a quello configurato.                                                                                                                                                        | Correggi il formato o il delimitatore nelle impostazioni del catalogo. Una mancata corrispondenza causa *Nessun record valido trovato* errori.                                                                                                                                                                                                                    |
| FTP/SFTP: credenziali o percorso non validi          | Verifica che l’URL abbia 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 esempio, `@` diventa `%40`).                                                                                                        | Verifica le credenziali con un client FTP come FileZilla. Aggiorna l’URL con le credenziali corrette e il percorso completo del file.                                                                                                                                                                                                                             |
| Il recupero scade o la connessione non riesce        | Il firewall del server potrebbe bloccare le richieste di impact.com.                                                                                                                                                                                                                                                                                                       | Contatta il provider di hosting o il team IT per aggiungere agli indirizzi consentiti gli intervalli di indirizzi IP di impact.com.                                                                                                                                                                                                                               |
| L’URL richiede l’autenticazione                      | Questo metodo di caricamento non supporta l’autenticazione basata su sessione o cookie.                                                                                                                                                                                                                                                                                    | Usa un URL di download diretto accessibile pubblicamente, l’autenticazione HTTP Basic incorporata nell’URL (`https://user:pass@host/path`), oppure FTP/SFTP con le credenziali nell’URL. Se il feed richiede l’accesso tramite browser, passa a un altro metodo di caricamento per il catalogo, ad esempio *Caricamento diretto* o il *server FTP di impact.com*. |
| L’URL supera i 2.048 caratteri                       | Gli URL firmati per l’archiviazione cloud possono superare il limite di 2.048 caratteri e venire troncati.                                                                                                                                                                                                                                                                 | Usa un servizio di abbreviazione degli URL che mantenga il download diretto oppure ospita il file a un URL più breve.                                                                                                                                                                                                                                             |
| Catalogo bloccato su In elaborazione o In attesa     | Verifica se il file è ancora accessibile tramite l’URL e se le sue dimensioni sono insolitamente grandi rispetto alla frequenza di recupero.                                                                                                                                                                                                                               | Verifica che il file sia disponibile. Se il catalogo rimane *In elaborazione* o *In attesa*, [contatta l’assistenza](https://app.impact.com/support/portal.ihtml) per richiedere una nuova elaborazione manuale.                                                                                                                                                  |
| Il catalogo ha smesso di aggiornarsi automaticamente | Verifica 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 indicare il nuovo URL o nome del file. Per i cataloghi di grandi dimensioni (1.000.000+ elementi), valuta di ridurre la frequenza di recupero per evitare timeout.                                                                                                          |
| Campi o dati mancanti dopo il caricamento            | Verifica che i nomi dei campi corrispondano alle specifiche del formato selezionato, ad esempio [i campi di Google Merchant Center](https://support.google.com/merchants/answer/7052112) per il formato GMC. Mappa i campi personalizzati che non rientrano nelle specifiche standard negli slot dei campi personalizzati di impact.com (`Numeric1`, `Text1`, e così via). | Scarica da impact.com il catalogo caricato e confrontalo con il file sorgente per individuare dove si perdono i dati. Aggiorna i nomi dei campi o le mappature secondo necessità, quindi carica di nuovo il file.                                                                                                                                                 |

## Importazione tramite carrello degli acquisti integrato (consigliata)

Questo metodo recupera il catalogo da una piattaforma e-commerce esistente. La maggior parte dei problemi di connessione dipende da credenziali errate o dall’assenza delle autorizzazioni di lettura. Seleziona qui sotto la tua piattaforma.

### Shopify (consigliato)

Se visualizzi un errore come *Unsuccessful HTTP status code when connecting to Shopify: 401* oppure *No valid records were found in the catalog file*, di solito la causa è da ricercare nei dati di autenticazione o nelle autorizzazioni.

* La tua password deve essere il **token di accesso all’API di amministrazione**, che inizia con `shpat_` (o `shap_`). Lo trovi nel pannello di amministrazione Shopify, in **App** **→** **Credenziali API** **→** **token di accesso all’API di amministrazione**.
* Se non vedi il **token di accesso all’API di amministrazione**, seleziona **Installa app** in Shopify per generarlo.
* Verifica che all’app sia stata concessa l’autorizzazione (scope) `read_products` . Senza, Shopify restituisce un errore che indica che l’azione richiede l’approvazione del commerciante per lo scope `read_products` .
* Per le collezioni, trova l’ID della collezione nel pannello di amministrazione Shopify, in **Prodotti** **→** **Collezioni**. Seleziona la collezione: il suo ID compare alla fine dell’URL della pagina.

Per i passaggi completi di configurazione, consulta la [guida all’integrazione del catalogo prodotti Shopify](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-shopify/shopify-product-catalog).

### Amazon (consigliato)

L’integrazione del carrello Amazon è riservata ai brand con [abbonamenti Seller](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/seller-program/amazon-seller-program/amazon-seller-program-explained.md) e non è una funzionalità self-service. A causa delle restrizioni dell’API Amazon, l’importazione automatica del catalogo da Amazon è limitata a 1.000 prodotti. Se il tuo catalogo Seller contiene più di 1.000 prodotti, usa invece un metodo di caricamento file, come *Importa da URL*.

Per i passaggi di configurazione, consulta la [guida all’integrazione di Amazon](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-amazon).

### BigCommerce

Per connettere BigCommerce servono due valori e le autorizzazioni di sola lettura corrette.

* Inserisci **Store Hash** e **Access Token** nell’interfaccia di impact.com. L’hash del negozio è l’identificativo incluso nel percorso API del tuo negozio.
* Quando crei l’account API in BigCommerce, imposta le autorizzazioni di **Prodotti** e **Informazioni e impostazioni** in modalità di sola lettura.

Per approfondire, consulta la guida di BigCommerce su [come creare token API](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token).

### WooCommerce

Se visualizzi *Connessione a WooCommerce non riuscita. Riprova*, controlla le credenziali e le impostazioni API.

* Il tuo **nome utente API** è la tua *chiave consumer*, mentre la tua **password API** è il tuo *segreto consumer*.
* Attiva la REST API legacy in WooCommerce: **WooCommerce** **→** **Impostazioni** **→** **Avanzate** **→** **API legacy**, quindi seleziona la casella di controllo per attivarla.

Per ulteriori informazioni, consulta la [documentazione della REST API di WooCommerce](https://woocommerce.com/document/woocommerce-rest-api/).

### Shoplazza

La tua app privata Shoplazza deve disporre dell'accesso in lettura alle seguenti risorse: `product`, `collection`e `shop`.

Per la procedura di configurazione, consulta la guida di Shoplazza alla [creazione di app private](https://www.shoplazza.dev/reference/quick-construction-of-private-apps).

## server FTP di impact.com

La maggior parte dei problemi FTP è dovuta alle impostazioni di connessione o alle credenziali.

| Problema                          | Cosa controllare                                                                         | Come risolvere                                                                                                                                                                                                                  |
| --------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Impossibile connettersi al server | Verifica che la connessione sia diretta all'host `products.impact.com` sulla porta `21`. | Aggiorna il client FTP con l'host e la porta corretti, quindi riconnettiti.                                                                                                                                                     |
| Credenziali FTP mancanti          | Per connetterti, ti servono il nome utente e la password FTP forniti per il tuo account. | Trova le tue *credenziali FTP Product Data System* nelle impostazioni di configurazione tecnica del tuo account. Se non riesci a trovarle o ad accedervi, [contatta l'assistenza](https://app.impact.com/support/portal.ihtml). |

## server SFTP di impact.com

Il server SFTP di impact.com è un metodo di caricamento specializzato, riservato a integrazioni specifiche.

| Problema                                         | Cosa controllare                                                                                                                                       | Come risolvere                                                                                                                                                                                                                                      |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La piattaforma dei feed non riesce a connettersi | Verifica che la piattaforma si connetta all'host `products.impact.com` sulla porta `22`, e che le credenziali siano quelle fornite per il tuo account. | Prova le stesse credenziali con un client SFTP standard, come FileZilla o Cyberduck. Se il client si connette ma la piattaforma dei feed continua a non riuscirci, passa il catalogo a *Importa da URL* seguendo la procedura riportata di seguito. |

### Passare dal push al pull

impact.com consiglia di recuperare il feed anziché inviarlo. Quando impact.com recupera il feed direttamente dal server SFTP della piattaforma di feed (ad esempio, SFTPGo), impact.com controlla quando e con quale frequenza aggiornare il catalogo, senza più dipendere dal server SFTP di impact.com. Passare al pull risolve anche gli errori di connessione che la piattaforma di feed (ad esempio, Feedonomics) potrebbe riscontrare durante l'invio dei file al server SFTP di impact.com.

Prima di passare al pull, chiedi alla piattaforma di feed (ad esempio, Feedonomics) di configurare una posizione SFTP in uscita per il feed e di fornire:

* Host e porta SFTP/FTP (ad esempio, sftpgo.feedonomics.com:22)
* Nome utente e password
* Percorso del file (ad esempio, incoming/catalog\_feed.txt.gz)

{% hint style="warning" %}
**Attenzione:** Aggiorna il catalogo esistente anziché crearne uno nuovo. Un nuovo catalogo che utilizza lo stesso *Nome file di caricamento* restituisce un errore *Nome file già in uso* e il catalogo esistente potrebbe già essere utilizzato da altri programmi.
{% endhint %}

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. Passa il puntatore sul catalogo esistente, quindi seleziona **Modifica**.
3. Nella sezione *Metodo di caricamento* seleziona **Recupera da URL**.
4. Seleziona il **Formato** corrispondente al file del feed.
5. Inserisci il **Nome file di caricamento**, rispettando esattamente il nome del file, inclusa l'estensione.
6. Inserisci l' **URL di recupero** nel formato `sftp://[username]:[password]@[host]:22/[path/to/file]`.
   * Codifica URL gli eventuali caratteri speciali nelle credenziali. Ad esempio, `@` diventa `%40`.
7. Seleziona la **Frequenza di recupero**, **Ora di recupero**e il **Fuso orario**.
8. Seleziona **Salva**.

## Caricamento diretto

I problemi di caricamento diretto sono solitamente dovuti a un formato o nome file non corrispondente oppure a un file che supera il limite di 1 GB.

| Problema                              | Cosa controllare                                                                                                                                                                    | Come risolvere                                                                                                                                                                  |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Formato selezionato errato            | Il formato scelto (ad esempio, TXT) non corrisponde al file caricato (ad esempio, XML).                                                                                             | Carica di nuovo il file e seleziona il formato corrispondente. I file XML utilizzano l'estensione `.xml` i file CSV utilizzano `.csv`, e i file delimitati da TAB usano `.txt`. |
| Nome del file non corrispondente      | Il nome del file caricato deve corrispondere esattamente al *Nome file di caricamento* impostato nelle impostazioni del catalogo, inclusa l'estensione.                             | Rinomina il file oppure aggiorna il *Nome file di caricamento* in modo che corrispondano esattamente.                                                                           |
| Il file compresso non viene elaborato | impact.com supporta file compressi con gzip e nel formato ZIP standard. Un file compresso può avere una seconda estensione che indica la compressione, ad esempio `catalog.xml.gz`. | Verifica che il tipo di compressione sia gzip o ZIP e che il file abbia le estensioni corrette sia per il formato sia per la compressione.                                      |


---

# 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-uploads-and-connections.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.
