> 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/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md).

# Résoudre les erreurs et avertissements des catalogues de produits

Chaque catalogue de produits possède un score de santé qui signale les éventuels problèmes qu’il contient. Utilisez ce guide pour résoudre les erreurs et les avertissements signalés par impact.com après le traitement de votre catalogue, ainsi que les problèmes de visibilité auprès des partenaires, afin que votre catalogue reste dans la plage *<mark style="color:$success;">Excellent</mark>* .

Si impact.com ne parvient pas à recevoir votre fichier de catalogue, consultez [Résoudre les problèmes de chargement et de connexion des catalogues de produits](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-uploads-and-connections.md).

{% hint style="info" %}
**Conseil :** Un catalogue en bon état ne se limite pas à l’absence d’erreurs. Suivez les [Bonnes pratiques pour les catalogues de produits](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) pour que vos données restent complètes, bien structurées et configurées de manière à assurer une visibilité et des performances optimales.
{% 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>" %}

## Scores de santé du catalogue

1. Dans le menu de navigation à gauche, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **Contenu** **→** **Produits** **→** [**Catalogues de produits**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. Si un catalogue contient des erreurs, des avertissements ou des lignes en double, la colonne *Santé* indique le nombre de chaque élément.

   * Les méthodes de chargement automatisées mettent à jour votre catalogue lors de la prochaine récupération planifiée.

   <div data-with-frame="true"><figure><img src="https://57104473-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>

Chaque catalogue présente l’un des indicateurs de santé suivants dans la colonne *Santé*  :

* *<mark style="color:$info;">En attente</mark>* : votre catalogue de produits attend son premier chargement ou sa première récupération de données.
* *<mark style="color:orange;">En cours de traitement</mark>* : votre catalogue de produits est en cours de traitement.
* *<mark style="color:$success;">Excellent</mark>* : indique un catalogue en bon état. Cet ensemble de données produits est complet et bien structuré, ce qui lui donne les meilleures chances d’obtenir de bons résultats.
* *<mark style="color:$warning;">Bon</mark>* : indique que certains champs suggérés contenant des données essentielles, comme la catégorie ou la description, sont peut-être manquants. En comblant ces lacunes, vous améliorez la qualité globale de votre catalogue.
* *<mark style="color:$danger;">Mauvais</mark>* : indique que des informations obligatoires manquent dans plus de 10 % des enregistrements fournis. Ce catalogue doit être corrigé et chargé à nouveau.

## Résoudre les erreurs et les avertissements après le chargement

Une fois le fichier reçu, impact.com valide chaque enregistrement. Les erreurs empêchent le traitement des enregistrements, tandis que les avertissements signalent des données acceptées qui peuvent toutefois causer des problèmes. Consultez les sections ci-dessous pour les interpréter et les résoudre.

### Afficher les erreurs et les avertissements

1. Dans la colonne *Santé* , sélectionnez le lien **erreurs**, **avertissements**, ou **doublons** .
   * Vous serez redirigé vers une page contenant plus de détails. Dans un ensemble d’éléments en double, seul le premier est représenté dans impact.com ; tous les éléments qui le dupliquent sont ignorés.
2. Vous pouvez également utiliser le *Rechercher* champ et les filtres en haut de la page pour parcourir les problèmes.
3. Examinez les problèmes et apportez les modifications nécessaires, puis importez à nouveau votre catalogue de produits.

Utilisez les filtres suivants sur la page des détails pour affiner la liste des problèmes :

* *Type d’erreur* : filtrer spécifiquement les *erreurs*, *avertissements*, *doublons*ou *tous* les problèmes.
* *Obligatoires* : filtrer les champs obligatoires manquants spécifiques du catalogue de produits, ou *tous* les champs.
* *Recommandés* : filtrer les champs recommandés manquants spécifiques du catalogue de produits, ou *tous* les champs.
* *Invalides* : filtrer les erreurs de validation spécifiques, comme un SKU en double, un code de catégorie Google invalide ou d’autres erreurs.

### Messages d’erreur et d’avertissement courants

Recherchez le message affiché pour votre catalogue dans la colonne *État de l’importation* ou sur la page des détails, que vous pouvez ouvrir depuis la colonne *État* . Utilisez l’explication pour résoudre le problème.

| Message                                                                                                                                                                                         | Explication                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Enregistrement « X » : champ(s) obligatoire(s) manquant(s) : (nom du champ)*                                                                                                                   | La ligne indiquée ne contient pas un ou plusieurs champs obligatoires.                                                                                                                                                                                                                                                                                                                                                                                              |
| *Enregistrement « X » : CatalogItemId(CatalogItemId) : champ(s) obligatoire(s) manquant(s) : (nom du champ)*                                                                                    | Une ligne du fichier de données ne contient pas un champ obligatoire.                                                                                                                                                                                                                                                                                                                                                                                               |
| *Aucun catalogue trouvé pour la requête. Vérifiez que le nom du fichier importé est identique à celui associé au catalogue.*                                                                    | Le *Nom du fichier à importer* défini dans la section *Méthode d’importation* lors de la création du catalogue ne correspond pas exactement au nom du fichier que vous avez importé.                                                                                                                                                                                                                                                                                |
| *Aucun attribut dans le fichier de catalogue*                                                                                                                                                   | Le fichier de données du catalogue de produits ne contient aucune donnée pouvant être traitée.                                                                                                                                                                                                                                                                                                                                                                      |
| *L’identifiant d’un article du catalogue apparaît plusieurs fois ; les occurrences après la première seront ignorées.*                                                                          | Au moins deux articles ont le même identifiant. Chaque produit doit avoir une valeur unique ; les articles en double ne sont pas traités.                                                                                                                                                                                                                                                                                                                           |
| *L’enregistrement « X » contient une erreur : (ligne X) caractère non valide entre un jeton encadré et un délimiteur*                                                                           | Une ligne contient des guillemets doubles mal utilisés. Encadrez le champ de guillemets doubles et remplacez tous les autres guillemets doubles par deux guillemets doubles. Les catalogues Google Merchant Center (au format TXT) acceptent les guillemets doubles non échappés, par exemple `18"` dans un titre de produit.                                                                                                                                       |
| *(Ligne de début X) fin de fichier atteinte avant la fin du jeton encadré*                                                                                                                      | EOF signifie « fin de fichier ». La ligne de début indiquée contient un guillemet double ouvrant sans guillemet double fermant, ou un saut de ligne inattendu a interrompu le flux de données.                                                                                                                                                                                                                                                                      |
| *Erreur lors de l’analyse du champ (catalog type) avec la valeur : (field)*                                                                                                                     | Le champ produit n’est pas valide et ne peut pas être accepté.                                                                                                                                                                                                                                                                                                                                                                                                      |
| *L’enregistrement (recordNumber) comporte une erreur : le nombre de valeurs délimitées (FieldsLength) ne correspond pas au nombre attendu (ColumnNamesLength)*                                  | Pour une ligne donnée, des données figurent dans une colonne qui n’a pas d’en-tête.                                                                                                                                                                                                                                                                                                                                                                                 |
| *Aucun enregistrement valide n’a été trouvé dans le fichier de catalogue. Vérifiez que le contenu du fichier correspond au format de catalogue configuré, puis importez-le à nouveau.*          | impact.com a lu le fichier, mais celui-ci ne contient aucun enregistrement de produit. Vérifiez qu’il contient vos produits et qu’il correspond au format de catalogue sélectionné, puis importez-le à nouveau.                                                                                                                                                                                                                                                     |
| *Plus de 10 % des enregistrements du fichier comportaient des erreurs. Le catalogue n’a donc pas été mis à jour. Vérifiez et corrigez les enregistrements, puis importez à nouveau le fichier.* | Un trop grand nombre d’enregistrements comportent des erreurs pour que le catalogue puisse être mis à jour. Cela inclut les fichiers dont tous les enregistrements comportent des erreurs. Consultez [*Comprendre le seuil d’erreur de 10 %*](#understand-the-10-error-threshold) ci-dessous.                                                                                                                                                                       |
| *Le fichier de catalogue n’est pas un XML valide et n’a pas pu être lu. Vérifiez que le fichier est un XML bien formé, puis importez-le à nouveau.*                                             | Le fichier XML est vide, tronqué ou contient des balises non fermées ; impact.com ne peut donc pas le lire. Corrigez le XML pour qu’il soit bien formé, puis importez-le à nouveau.                                                                                                                                                                                                                                                                                 |
| *Le fichier ne semble pas être au format de flux RSS ou Atom valide. Vérifiez qu’il correspond au format de catalogue configuré, puis importez-le à nouveau.*                                   | Le fichier n’est pas un flux RSS ou Atom, par exemple lorsqu’une page Web d’erreur est enregistrée à la place de votre flux. Un fichier de catalogue XML doit contenir `rss`, `RDF`, ou `feed` dans son élément de début.                                                                                                                                                                                                                                           |
| *Nous n’avons pas pu lire le contenu de votre fichier de catalogue...*                                                                                                                          | impact.com ne peut pas lire le contenu du fichier. Parmi les causes courantes : un fichier vide, une structure de fichier inattendue, des délimiteurs non valides ou un encodage de caractères incorrect. Vérifiez que le fichier correspond au format de catalogue sélectionné, puis importez-le à nouveau. Si le problème persiste, [contactez l’assistance](https://app.impact.com/support/portal.ihtml).                                                        |
| *Nous n’avons pas pu récupérer le fichier de catalogue à partir de l’URL d’extraction configurée. Vérifiez l’URL et assurez-vous que le fichier est accessible.*                                | impact.com ne peut pas télécharger le fichier depuis l’ *URL d’extraction* dans les paramètres de votre catalogue. Consultez [*Extraire depuis une URL*](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-uploads-and-connections.md#pull-from-url-recommended) dans Dépannage du chargement et des connexions des catalogues de produits pour résoudre le problème lié à l’URL. |
| *Le traitement a échoué en raison d’une erreur système interne...*                                                                                                                              | Aucune action n’est requise de votre part. Le dernier catalogue traité avec succès reste disponible pour les partenaires. Consultez la [page d’état d’impact.com](https://status.impact.com/) pour en savoir plus sur les interruptions de service.                                                                                                                                                                                                                 |
| *Le champ (field name) dont la valeur est (field value) ne contient pas de protocole valide*                                                                                                    | La valeur du champ n’est pas une URL correctement formatée.                                                                                                                                                                                                                                                                                                                                                                                                         |

### Avertissements concernant la mise en forme et les délimiteurs

Dans les fichiers délimités (CSV et TSV), un délimiteur ou un saut de ligne mal placé peut séparer vos données au mauvais endroit et empêcher le traitement correct des enregistrements. Utilisez le tableau ci-dessous pour résoudre ces avertissements.

| Problème                                                                                                                  | Comment le résoudre                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Problèmes de délimiteurs : une virgule, une tabulation ou une ligne vide mal placée rompt la séparation entre les champs. | Corrigez l’utilisation des délimiteurs dans le fichier de catalogue afin que chaque champ soit séparé de façon cohérente, puis importez-le à nouveau. Pour les catalogues Google Merchant Center au format TXT, impact.com ignore les lignes vides. |
| Les sauts de ligne dans un champ de description empêchent le traitement des enregistrements.                              | Les sauts de ligne ne sont pas pris en charge dans les formats de texte délimités (CSV et TSV). Supprimez les sauts de ligne des champs de texte, comme les descriptions, avant l’importation.                                                      |

{% hint style="info" %}
**Format eBay Commerce Merchant Center :** Dans un fichier `.csv` , remplacez les espaces dans les valeurs de la colonne des champs (catégories) par des traits de soulignement. Par exemple, utilisez `Item_Title` plutôt que `Item Title`.
{% endhint %}

### Erreurs de format Google Merchant Center

Si vous utilisez le format Google Merchant Center (GMC), la plupart des problèmes concernent la section `Category` , les valeurs de champ prédéfinies ou la structure XML.

#### Catégorie de produit Google manquante

Lorsque vous sélectionnez *erreurs* sur l’écran *Catalogues de produits* , vous pouvez voir *Catégorie de produit Google manquante* dans la colonne *Suggestions* . Cela signifie qu’aucun code de catégorie Google ni aucune chaîne complète de catégorie Google n’a été inclus dans votre catalogue.

Pour résoudre ce problème, consultez votre [compte Google Merchant Center](https://merchants.google.com/). Google suggère automatiquement des catégories pour les articles ; utilisez ces suggestions lors du téléversement du catalogue corrigé.

<div data-with-frame="true"><figure><img src="https://57104473-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>

#### Incompatibilité de catégorie de produit Google

Lorsque vous sélectionnez *erreurs* sur l’écran *Catalogues de produits* , vous pouvez voir *Incompatibilité de catégorie de produit Google* dans la colonne *Non valide* . Cela signifie que la catégorie utilisée pour les articles de votre catalogue ne correspond pas au [code de taxonomie](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) attendu (par exemple, 7386) ni au format de catégorie complet fourni par Google, par exemple :

`Animaux et articles pour animaux > Articles pour animaux > Articles pour oiseaux > Accessoires pour cages à oiseaux > Mangeoires et abreuvoirs pour cages à oiseaux`

Pour résoudre ce problème, corrigez le format dans lequel les catégories de produits Google sont répertoriées, puis téléversez à nouveau votre catalogue.

<div data-with-frame="true"><figure><img src="https://57104473-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>

#### Valeur de disponibilité non acceptée

Une erreur telle que *Could not parse field: availability with value* signifie qu’un champ prédéfini utilise une valeur que GMC ne reconnaît pas.

* Utilisez `availability` pour le champ de disponibilité.
* Utilisez l’une des valeurs de disponibilité prises en charge : `in_stock`, `out_of_stock`, `preorder`, ou `backorder`. impact.com accepte également les variantes ci-dessous et les convertit en valeur prise en charge.
* Vérifiez la présence de symboles spéciaux susceptibles d’affecter le formatage, comme un symbole monétaire dans un champ de valeur. Les codes de devise ne sont pas sensibles à la casse ; impact.com interprète donc `19.99 usd` comme `19.99 USD`.

| Valeur prise en charge | Également accepté            |
| ---------------------- | ---------------------------- |
| `in_stock`             | `In Stock`, `InStock`        |
| `out_of_stock`         | `Out Of Stock`, `OutOfStock` |
| `preorder`             | `PreOrder`                   |
| `backorder`            | `BackOrder`                  |

#### Erreurs de structure XML

Si vous importez un catalogue Google Merchant Center (au format XML) et que le message suivant s'affiche *Le fichier ne semble pas être au format d'un flux RSS ou Atom valide*, la structure XML est probablement incorrecte.

Le fichier XML doit contenir `rss`, `RDF`ou `feed` dans son élément de départ. Corrigez l'élément racine, puis importez à nouveau le fichier.

Si le message suivant s'affiche *Le fichier du catalogue n'est pas un fichier XML valide et n'a pas pu être lu*, le fichier est vide, tronqué ou contient des balises non fermées. Corrigez le XML pour qu'il soit bien formé, puis importez à nouveau le fichier.

### Comprendre le seuil d'erreur de 10 %

Si plus de 10 % des enregistrements d'un fichier importé contiennent des erreurs, le fichier n'est pas traité. Dans ce cas :

* Votre catalogue continue d'afficher la version du dernier import réussi. Un horodatage datant de la *dernière soumission réussie* est donc attendu.
* L'option **Afficher les produits** n'apparaît que si un fichier a déjà été importé avec succès pour cet ID de catalogue.

Corrigez les enregistrements signalés pour que moins de 10 % d'entre eux contiennent des erreurs, puis importez à nouveau le fichier.

## Résoudre les problèmes de visibilité pour les partenaires et de liens de suivi

Même un catalogue en bon état ne sera pas accessible à vos partenaires tant que vous ne l'aurez pas [rendu disponible](#partners-cant-see-the-catalog) et que vous ne respecterez pas les [conditions de visibilité pour les partenaires](#partners-cant-see-or-search-specific-products). Consultez cette section si le traitement de votre catalogue a réussi, mais que les partenaires rencontrent des problèmes de visibilité, d'accès aux produits ou de liens de suivi.

### Les partenaires ne voient pas le catalogue

Vérifiez les deux paramètres suivants :

* Vérifiez que le catalogue est disponible :
  1. Sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **Contenu** **→** **Produits** **→** [**Catalogues de produits**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) et recherchez le catalogue.
  2. Sélectionnez ![](https://57104473-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) **\[Plus]** puis sélectionnez **Rendre disponible à l’utilisation**.
* Vérifiez si l’accès des partenaires est restreint :
  1. Sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **Contenu** **→** **Produits** **→** [**Catalogues de produits**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) et recherchez le catalogue.
  2. Survolez le catalogue, puis sélectionnez **Modifier**.
  3. Dans la section *Restreindre l’accès des partenaires* , vérifiez si l’option **Autoriser l’accès uniquement à certains partenaires** est ![](https://57104473-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) activée.
  4. Si c’est le cas, ![](https://57104473-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) désactivez-la et sélectionnez **Enregistrer**.

{% hint style="success" %}
**Remarque :** L’option **Rendre disponible à l’utilisation** s’affiche uniquement pour les catalogues dont l’état de santé est *Excellent* ou *Bon* et qui sont *Inactifs* ou *En attente d’activation*.
{% endhint %}

### Les partenaires ne peuvent pas voir ni rechercher certains produits

Pour qu’un produit soit visible dans l’interface partenaire, il doit remplir toutes les conditions suivantes :

* Le prix d’origine est supérieur à 2,00 $ US.
* La disponibilité en stock du produit n’est pas *En rupture de stock.*
* Le produit possède une URL valide qui mène à une page de détails produit active.
* Le produit possède une URL d’image.
* Le produit se trouve dans un catalogue auquel aucune [règle](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/create-and-manage-product-catalog-rules.md) n’est appliquée.

### Les liens de suivi des partenaires renvoient une erreur « malformed »

Si les partenaires voient le message « The link you clicked on is malformed » lorsqu’ils utilisent les liens de suivi de vos produits, c’est généralement parce que le lien profond n’est pas activé ou que le domaine de la page de destination du produit n’est pas défini comme domaine autorisé. Pour activer les liens profonds, définir vos domaines autorisés et résoudre cette erreur, consultez [Configurer les domaines autorisés pour les liens profonds](https://help.impact.com/brand/fr/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/fr/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.
