> 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 del catalogo prodotti Ogni catalogo prodotti ha un punteggio di salute che indica quali problemi, se presenti, sono nel tuo catalogo. I problemi possono comparire in qualsiasi fase: quando il file viene caricato o collegato, dopo che è stato elaborato, oppure quando i tuoi partner cercano di visualizzare e promuovere i tuoi prodotti. Usa questa guida per affrontare i problemi in ogni fase e portare il tuo catalogo nel *eccellente* intervallo. {% hint style="info" %} **Suggerimento:** Un catalogo sano riguarda molto più che 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 configurati per una forte visibilità e prestazioni. {% endhint %} {% embed url="" %} ## Punteggi di salute del catalogo 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 voci duplicate, la *Salute* colonna mostra quanti ce ne sono di ciascuno. * I metodi di caricamento che recuperano automaticamente aggiornano il catalogo da soli al successivo evento di recupero.
Descrizioni di salute | Indicatore di salute | Descrizione | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **In attesa** | 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 sano. Questo set di dati prodotto è completo e ben strutturato, dandogli le migliori possibilità di ottenere prestazioni efficaci. | | **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. |
## Risoluzione dei problemi di caricamento e connessione Prima che un catalogo possa essere elaborato, impact.com deve riceverlo correttamente. I passaggi seguenti sono raggruppati in base al metodo di caricamento che hai selezionato quando hai creato il catalogo. Se non sei sicuro di quale metodo sia in uso, seleziona il catalogo e rivedi il suo *Metodo di caricamento* impostazioni. ### Caricamento diretto I problemi del Caricamento diretto sono di solito dovuti a un formato o a un nome file non corrispondente, oppure a un file che supera il limite di 1 GB. | Problema | Cosa controllare | Come risolverlo | | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Formato selezionato errato | Il formato che hai scelto (ad esempio, TXT) non corrisponde al file caricato (ad esempio, XML). | Ricarica e seleziona il formato che corrisponde al tuo file. I file XML usano l'estensione `.xml` I file CSV usano `.csv`, e i file delimitati da TAB usano `.txt`. | | Nome file non corrispondente | Il nome del file che hai caricato deve corrispondere esattamente a *Nome file di caricamento* impostato nelle impostazioni del catalogo, inclusa l'estensione. | Rinomina il tuo file, oppure aggiorna il *Nome file di caricamento* in modo che i due corrispondano esattamente. | | Il file compresso non verrà elaborato | impact.com supporta file compressi gzip e zip standard. Un file compresso può usare una seconda estensione per indicare la compressione, ad esempio `catalog.xml.gz`. | Conferma che il tipo di compressione sia gzip o zip e che il file usi le estensioni corrette sia per il formato sia per la compressione. | ### server FTP di impact.com La maggior parte dei problemi FTP riguarda le impostazioni di connessione o le credenziali. | Problema | Cosa controllare | Come risolverlo | | --------------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Impossibile connettersi al server | Conferma di connetterti all'host `products.impact.com` sulla porta `21`. | Aggiorna il tuo client FTP con l'host e la porta corretti, quindi riconnettiti. | | Credenziali FTP mancanti | Per connetterti, ti servono il login FTP e la password assegnati al tuo account. | Trova le tue *credenziali del sistema dati prodotto FTP* nelle impostazioni di configurazione tecnica del tuo account. Se non riesci a trovarle o ad accedervi, [contatta il supporto](https://app.impact.com/support/portal.ihtml). | ### Recupera da URL I protocolli supportati per *Recupera da URL* sono `http://`, `https://`, `ftp://`, e `sftp://`. Se il tuo catalogo non viene caricato, aggiornato o elaborato correttamente, usa la tabella qui sotto per identificare e risolvere il problema. | Problema | Cosa controllare | Come risolverlo | | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | L'URL non è un collegamento di download diretto | Apri 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 o 403, l'URL non è un collegamento di download diretto. | Aggiorna l'URL con uno che scarichi il file direttamente o lo mostri come dati grezzi quando viene aperto in un browser. | | Nome file non corrispondente | Il *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* in modo che corrisponda esattamente al nome del file. Una piccola discrepanza provoca un *Nessun catalogo trovato per la richiesta* errore. | | Disallineamento di formato o delimitatore | Conferma che il formato selezionato (CSV, TXT, XML, GMC) corrisponda al tuo file. Se usi un file delimitato, conferma che il delimitatore (virgola, tabulazione, barra verticale) corrisponda a quello 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 validi | Verifica che il tuo URL usi 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`). | Prova le tue credenziali con un client FTP come FileZilla. Aggiorna l'URL con le credenziali corrette e il percorso completo del file. | | Il pull va in timeout o non riesce a connettersi | Il firewall del tuo server potrebbe bloccare le richieste di impact.com. | Contatta il tuo provider di hosting o il team IT per inserire gli intervalli di indirizzi IP di impact.com nella allowlist. | | L'URL richiede autenticazione | Questo metodo di caricamento non supporta l'autenticazione basata su sessione o su cookie. | Usa un URL di download diretto accessibile pubblicamente, autenticazione HTTP Basic incorporata nell'URL (`https://user:pass@host/path`), oppure FTP/SFTP con le credenziali nell'URL. Se il tuo feed richiede un accesso basato sul browser, passa il tuo catalogo a un metodo di caricamento diverso, come *Caricamento diretto* o il *server FTP di impact.com*. | | L'URL supera i 2.048 caratteri | Gli 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 a un URL più breve. | | Catalogo bloccato in Elaborazione o In attesa | Verifica 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 *In elaborazione* o *In attesa*, [contatta il supporto](https://app.impact.com/support/portal.ihtml) per richiedere una rielaborazione 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 in modo che riflettano il nuovo URL o il nuovo nome file. Per cataloghi di grandi dimensioni (1.000.000+ elementi), considera di ridurre la frequenza di prelievo per evitare timeout. | | Campi o dati mancanti dopo il caricamento | Conferma che i nomi dei tuoi campi corrispondano alla specifica del formato selezionato, ad esempio [campi di Google Merchant Center](https://support.google.com/merchants/answer/7052112) per il formato GMC. Mappa i campi personalizzati al di fuori della specifica standard negli slot dei campi personalizzati di impact.com (`Numeric1`, `Text1`, e così via). | Scarica il catalogo caricato da impact.com e confrontalo con il file sorgente per individuare dove si perdono i dati. Aggiorna i nomi dei campi o le mappature secondo necessità, quindi ricarica. | ### Importazione integrata del carrello acquisti Questo metodo preleva il tuo catalogo da una piattaforma e-commerce esistente. La maggior parte dei problemi di connessione dipende da credenziali errate o da permessi di lettura mancanti. Seleziona la tua piattaforma qui sotto. {% tabs %} {% tab title="Shopify" %} Se vedi un errore come *Codice di stato HTTP non riuscito durante la connessione a Shopify: 401* o *Nessun record valido trovato nel file del catalogo*, di solito la causa sono i dettagli di autenticazione o le autorizzazioni. * La tua password deve essere il **token di accesso API Admin**, che inizia con `shpat_` (o `shap_`). Lo troverai nel tuo Shopify Admin sotto **App** **→** **Credenziali API** **→** **token di accesso API Admin**. * Se non vedi le **token di accesso API Admin**, seleziona **Installa app** in Shopify per generarlo. * Conferma che l'autorizzazione `read_products` sia concessa all'app. Senza di essa, Shopify restituisce un errore che indica che l'azione richiede l'approvazione del commerciante per l'ambito `read_products` ambito. * Per le collection, trova l'ID della collection nel tuo Shopify Admin sotto **Prodotti** **→** **Collection**. Seleziona la collection; il suo ID appare 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/impact-brand/docs/shopify-product-catalog). {% endtab %} {% tab title="WooCommerce" %} Se vedi *Connessione a WooCommerce non riuscita. Riprova*, controlla le credenziali e le impostazioni API. * Il tuo **Nome utente API** è il tuo WooCommerce *Consumer Key*, e la tua **Password API** è il tuo *Consumer Secret*. * Abilita la Legacy REST API in WooCommerce: **WooCommerce** **→** **Impostazioni** **→** **Avanzate** **→** **API Legacy**, quindi seleziona la casella di controllo per abilitarla. Per riferimento, consulta la [documentazione API REST di WooCommerce](https://woocommerce.com/document/woocommerce-rest-api/). {% endtab %} {% tab title="BigCommerce" %} La connessione a BigCommerce richiede due valori e i corretti permessi di sola lettura. * Inserisci il tuo **Store Hash** e **Access Token** nell'interfaccia utente di impact.com. Il tuo store hash è l'identificatore nel percorso API del tuo store. * Imposta i **Prodotti** e **Information & settings** permessi di sola lettura quando crei l'account API in BigCommerce. Per riferimento, consulta la guida di BigCommerce alla [creazione di token API](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token). {% endtab %} {% tab title="Shoplazza" %} La tua app privata Shoplazza deve avere accesso in lettura alle seguenti risorse: `prodotto`, `collezione`, e `negozio`. Per i passaggi di configurazione, consulta la guida di Shoplazza alla [creazione di app private](https://www.shoplazza.dev/reference/quick-construction-of-private-apps). {% endtab %} {% endtabs %} ## 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 ma che potrebbero causare problemi. Usa le sezioni seguenti per interpretarli e risolverli. ### Visualizza errori e avvisi 1. Nella *Salute* colonna, seleziona il **errori**, **avvisi**, o **duplicati** collegamento. * Verrai reindirizzato a una pagina con maggiori dettagli. Solo il primo elemento di un insieme di duplicati viene rappresentato in impact.com; tutti gli elementi che duplicano il primo vengono ignorati. 2. Facoltativamente, usa il *campo di ricerca* e i filtri in cima alla pagina per ordinare i problemi. 3. Rivedi i problemi e apporta le modifiche necessarie, quindi ricarica il catalogo prodotti.
Descrizioni dei filtri | Filtro | Descrizione | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | Tipo di errore | Filtra specificamente per *Errori*, *Avvisi*, *Duplicati*, o *Tutti* problemi. | | Obbligatorio | Filtra per eventuali campi obbligatori mancanti specifici del catalogo prodotti, o *Tutti* campi. | | Suggerito | Filtra per eventuali campi consigliati mancanti specifici del catalogo prodotti, o *Tutti* campi. | | Non valido | Filtra per qualsiasi errore specifico basato sulla convalida, come uno SKU duplicato, un codice categoria Google non valido o altri errori. |
Messaggi di errore e avviso comuni | Messaggio | Spiegazione | | --------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *Record 'X': campo/i obbligatorio/i mancante/i: (nome campo)* | La riga specificata non contiene uno o più campi obbligatori. | | *Record 'X': CatalogItemId(CatalogItemId): campo/i obbligatorio/i mancante/i: (nome campo)* | Una riga nel file di dati non contiene un campo obbligatorio. | | *Nessun catalogo trovato per la richiesta. Controlla se il nome file del file caricato è uguale a quello 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. | | *Record 'X' ha un errore: (riga X) carattere non valido tra token incapsulato 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) raggiunto EOF prima del completamento del token incapsulato* | EOF significa "fine del file". La riga iniziale menzionata ha una virgoletta doppia di apertura senza una virgoletta doppia di chiusura, oppure un'interruzione di riga imprevista ha 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 atteso (ColumnNamesLength)* | Per una riga data, i dati esistono in una colonna che non ha intestazione. | | *Nessun record valido è stato trovato nel file del catalogo* | Il file di dati è vuoto, 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 ciò si verifica. Vedi *Comprendere la soglia di errore del 10%* qui sotto. | | *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 media. Consulta la [pagina di stato di impact.com](https://status.impact.com/) per i dettagli sulle interruzioni del servizio. | | *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 delimitatore | Problema | Come risolverlo | | ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Problemi di delimitatore: una virgola errata, una tabulazione o una riga vuota interrompono il confine tra i campi. | Correggi l'uso del delimitatore nel file del catalogo in modo che ogni campo sia separato in modo coerente, quindi ricarica. | | Le nuove righe in un campo descrizione interrompono l'elaborazione del record. | Le nuove righe 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. | ### Errori di formato Google Merchant Center Se usi il formato Google Merchant Center (GMC), la maggior parte dei problemi deriva dalla `Categoria` sezione, dai valori predefiniti dei campi o dalla struttura XML. {% tabs %} {% tab title="Categoria prodotto Google mancante" %} Quando selezioni *errori* nella *Cataloghi prodotti* schermata, potresti vedere *Categoria prodotto Google mancante* nella *colonna Suggerimenti.* Ciò significa che nel tuo catalogo non è stato incluso alcun codice categoria Google o stringa completa della categoria Google. Per risolvere questo 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.
{% 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. Ciò significa che la categoria usata per gli articoli nel tuo catalogo non corrisponde al previsto [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: `Animals & Pet Supplies > Pet Supplies > Bird Supplies > Bird Cage Accessories > Bird Cage Food & Water Dishes` Per risolvere questo problema, correggi il formato in cui sono elencate le Categorie prodotto Google, quindi ricarica il catalogo.
{% endtab %} {% tab title="Valore di disponibilità non accettato" %} Un errore come *Impossibile analizzare il campo: disponibilità con valore* significa che un campo predefinito sta usando un valore che GMC non riconosce. Per i cataloghi GMC, categorie e valori devono essere esatti. * Usa `disponibilità` per il campo disponibilità. * I valori di disponibilità supportati sono `in_stock`, `out_of_stock`, `preorder`, e `backorder`. * Controlla la presenza di simboli speciali che possono influire sulla formattazione, come un simbolo di valuta che appare in un campo valore. {% endtab %} {% tab title="XML: nessun record valido trovato" %} Se carichi un catalogo di Google Merchant Center (formato XML) e vedi *Nessun record valido trovato nel file del catalogo. Correggi il file e ricaricalo*, è probabile che la struttura XML sia errata. Il file XML deve contenere `rss`, `RDF`, o `feed` nel suo elemento iniziale. Correggi l'elemento radice e ricarica. {% endtab %} {% endtabs %} {% hint style="info" %} **Formato eBay Commerce Merchant Center:** In un `.csv` file, sostituisci gli spazi nei valori della colonna del campo (categorie) con i trattini bassi. Ad esempio, usa `Item_Title` piuttosto che `Item Title`. {% endhint %} ### 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 un *ultimo invio riuscito* timestamp è previsto. * Il **Visualizza prodotti** l'opzione appare solo se un file è stato caricato in precedenza con successo per quell'ID catalogo. Correggi i record segnalati in modo che meno del 10% contenga errori, quindi ricarica. ## Rendi disponibile il tuo catalogo ai partner Un catalogo sano non raggiungerà comunque i tuoi partner finché non lo renderai disponibile e non soddisferai i requisiti di visibilità per i partner. Usa questa sezione se il tuo catalogo è stato elaborato correttamente ma i partner riscontrano 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 ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[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 ![](/files/6a36670a9e3518128f7130049c54b7a9613f756b) **\[Altro]** e poi scegli **Rendi disponibile per l'uso**. * Controlla se l'accesso per i partner è limitato: 1. Seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[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 accesso ai partner* sezione, controlla se **Consenti l'accesso solo a partner specifici** è ![](/files/bcb6da087265fb9beef85997a54e50203691b8d1) attivato. 4. Se lo è, ![](/files/941b00a9fa459b1c6f0b7079a81a58a3edbc74a7) disattivalo e seleziona **Salva**. ### I partner non riescono a vedere o cercare prodotti specifici Perché un prodotto sia visibile nell'interfaccia utente del partner, 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 porta a una pagina attiva dei dettagli del prodotto. * Il prodotto ha un URL dell'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 "malformato" Se i partner vedono "Il link su cui hai fatto clic è malformato" quando usano i link di tracciamento dei tuoi prodotti, di solito 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 [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 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.