> 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/getting-started/introduction-to-impactcom-reporting-for-brands.md).

# Introduction aux rapports impact.com pour les marques

impact.com propose un puissant ensemble de fonctionnalités de reporting, accessibles selon votre programme impact.com. Cet article présente notre suite de rapports et indique leur disponibilité selon le programme ou l’édition du compte. En savoir plus sur la [édition Starter pour les marques](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/getting-started/starter-edition-for-brands-overview.md) et l’ [édition Essentials](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/getting-started/grow-your-partnerships-with-essentials-edition.md) ou consultez la [*Référence des éditions de compte*](#account-editions-reference) ci-dessous pour en savoir plus.

&#x20;<img src="https://1651675991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpVKEIcehMut8QKRmaUZu%2Fuploads%2FiaGgKM32jOcur3x3IZNO%2Fai-sparkles.svg?alt=media&amp;token=65c2c155-b61d-45f8-990e-c349f0d7afdc" alt="" data-size="original"> ask impact supports this feature in chat.

{% hint style="info" %}
**Conseil :** Essayez de poser votre question dans ask impact :

* *Quels ont été les résultats de mon programme le mois dernier : clics, actions et revenus ?*
* *Comparer mes revenus de ce mois à ceux du même mois l’année dernière.*
  {% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FBVJI56L4rDVh8Sy6aBm8%2Ffund-150-5.mp4?alt=media&token=f432efa0-e817-43d9-8ec4-a25abb3cde7a>" %}

<details>

<summary>Suite de rapports de la plateforme</summary>

Les rapports répertoriés ici ne se limitent pas à un type de programme précis, mais peuvent être soumis aux restrictions des [éditions de compte](#account-editions-reference). La plupart de ces rapports peuvent être épinglés pour y accéder rapidement, programmés pour être envoyés dans votre boîte de réception ou téléchargés (au format PDF, Excel ou CSV). La plupart proposent également des graphiques de tendance et des tableaux, ce qui facilite la comparaison des indicateurs clés au fil du temps.

{% hint style="success" %}
**Remarque :** Pour vérifier si un rapport spécifique peut être récupéré via l’API, consultez [Vérifier la disponibilité d’un rapport via l’API](https://help.impact.com/other/fr/reference-documentation/verifier-la-disponibilite-de-lapi-dun-rapport.md). Les rapports personnalisés créés dans Data Lab ne peuvent pas être récupérés via l’API, mais vous pouvez les [télécharger sur la plateforme](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/data-lab-custom-reports/download-a-custom-report.md).
{% endhint %}

| Rapport                                      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rapports Data Lab                            | Data Lab vous permet de créer de puissants rapports personnalisés adaptés à vos besoins spécifiques. Vous pouvez créer des rapports comprenant différentes visualisations qui présentent les ensembles de données de diverses façons, selon les données que vous choisissez d’inclure. En savoir plus sur les [rapports Data Lab](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/data-lab-custom-reports/data-lab-introduction.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Rapports opérationnels                       | Vous y trouverez des données opérationnelles clés, telles que les [échéances de contrats à venir](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/operations-reports/recent-and-upcoming-contracts-report.md), [conversions non valides](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/operations-reports/invalid-conversions-report.md), ainsi que l’ [état des candidatures des partenaires](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/operations-reports/partner-applications-report.md), afin de prendre des décisions éclairées concernant vos partenariats. Qu’il s’agisse d’identifier les partenaires qui diffusent des publicités obsolètes, de repérer des problèmes de trafic ou de gérer les structures de groupes de partenaires, ces rapports opérationnels vous aident à maintenir votre programme exact, à jour et optimisé. En savoir plus sur les [rapports opérationnels](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/operations-reports.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Rapports détaillés                           | Ces rapports avec exploration détaillée vous donnent accès aux événements de clic individuels, qu’il s’agisse de chaque clic enregistré ou uniquement de ceux considérés comme rémunérables. Ils fournissent des informations clés sur l’attribution des clics, les publicités associées et les détails des paiements. En savoir plus sur les [rapports détaillés](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/listing-reports.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Rapports financiers                          | Ces rapports financiers vous renseignent sur les flux de trésorerie de votre compte et les coûts liés aux partenaires. Suivez l’évolution de vos flux de trésorerie grâce au [rapport historique des flux de trésorerie](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/finance/finance-reporting/cash-flow-history-report.md) et planifiez en conséquence avec le [rapport des paiements à venir aux partenaires](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/finance/finance-reporting/upcoming-partner-payments-report.md). Vous pouvez également comparer tous les coûts associés aux partenaires (hors paiements aux partenaires), tels que les paiements compensatoires et les primes de performance, à l’aide du [rapport des autres coûts](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/finance-reports/other-costs-report.md). En savoir plus sur les [rapports financiers](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/finance/finance-reporting.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Rapports de performance pour les marques     | Les rapports de performance vous offrent une vue détaillée et personnalisable des résultats de votre programme de partenariat, selon un large éventail d’indicateurs. Vous pouvez suivre l’activité des partenaires, l’efficacité des publicités ou le comportement des clients. Découvrez précisément quels partenaires génèrent des résultats grâce à des indicateurs tels que les clics, les conversions et les revenus dans le [rapport de performance par partenaire](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-partner-report.md), ou analysez les performances de publicités spécifiques et comparez leur efficacité dans le [rapport de performance par publicité](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-ad-report.md). En savoir plus sur les [rapports de performance](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Rapports sur les dépassements de partenaires | Vous pouvez consulter ici les dernières interactions des partenaires dans un parcours de conversion sur une période donnée, afin d’obtenir des informations utiles pour prendre des décisions éclairées lors du réglage des règles d’attribution et de la structure des commissions de votre programme. Consultez des rapports avec exploration détaillée qui présentent les données relatives aux dépassements : les partenaires qui remportent le plus souvent les conversions ou qui se font le plus souvent dépasser, les détails des conversions entre partenaires, ainsi que le parcours de conversion d’une commande sélectionnée. En savoir plus sur [Rapports de détection des ventes au dernier clic](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/leapfrogging-reports.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Rapport de recherche d’ID de commande        | Ce rapport vous permet d’obtenir davantage d’informations sur une commande spécifique, notamment le programme auquel elle est associée, son statut et le paiement correspondant. En savoir plus sur le [rapport de recherche d’ID de commande](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/orderid-lookup-report.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Rapports sur les risques liés aux événements | <p><strong>Remarque :</strong> Ces rapports sont uniquement disponibles avec le module complémentaire <img src="https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-db1131f1b95ffbfa026aac99b07a7ffe0564b3b6%2F477fa23d9ffe966a6d1191fbd504e9a68f4c3918efe5cee5cb7bbd826e591fea.svg?alt=media" alt=""> <strong>\[Protect]</strong> .</p><p>Ces rapports vous donnent une vision claire des risques liés à votre programme et vous aident à comprendre la qualité globale des événements générés par vos partenaires. Le <a href="https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/protect-and-monitor-your-performance-program/event-risk/risk-by-partner-report.md">rapport sur les risques par partenaire</a> présente une vue d’ensemble du niveau de risque de chaque partenaire, avec des indicateurs tels que le risque total associé aux clics et aux actions, les coûts correspondants et les taux de conversion. Le <a href="https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/protect-and-monitor-your-performance-program/event-risk/same-ip-actions-report.md">rapport sur les actions provenant d’une même adresse IP</a> permet de repérer les activités potentiellement frauduleuses en affichant, au fil du temps, les actions associées à un même type d’événement et provenant d’une même adresse IP. En savoir plus sur les <a href="https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/protect-and-monitor-your-performance-program/event-risk/event-risk-explained.md">rapports sur les risques liés aux événements</a>.</p> |

</details>

<details>

<summary>Rapports de performance du programme</summary>

Ces rapports sont propres à ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-81365ab1e9414f66498604921f52870f117b8cc7%2Fd33a611679a65f191574b81820ac09c98c5cc774faa6ff5a8a739a9cc7a87234.svg?alt=media) **\[Competitive Insights]** et ne sont disponibles qu’avec certaines éditions de compte ou certains modules complémentaires impact.com. Consultez la [*référence des éditions de compte*](#account-editions-reference) pour en savoir plus.

| Rapport                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rapport de référence financière      | <p>Ces rapports vous aident à comparer votre programme de partenariat à ceux de votre segment concurrentiel.</p><p>• <a href="https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/performance-program/performance-program-reports/competitive-insights/finance-benchmark-report/finance-benchmark-overview.md">Vue d’ensemble des références financières</a> vous permet de comparer les indicateurs de votre programme aux résultats moyens de programmes similaires.</p><p>• <a href="https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/performance-program/performance-program-reports/competitive-insights/finance-benchmark-report/finance-benchmark-partner-analysis.md">Analyse comparative des partenaires – Références financières</a> va plus loin en indiquant le classement de vos partenaires par rapport à leurs résultats dans d’autres programmes et en mettant en évidence les domaines où vos résultats sont supérieurs ou inférieurs à la moyenne.</p><p>• <a href="https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/performance-program/performance-program-reports/competitive-insights/finance-benchmark-report/finance-benchmark-recommendations.md">Recommandations des références financières</a> identifie les partenaires les plus performants de votre segment, qui offrent de solides perspectives de revenus pour votre programme, et vous permet de filtrer les partenaires actuels et ceux qui ne vous ont pas encore rejoint afin de déterminer quelles collaborations pourraient apporter de la valeur à votre programme.</p>                                                                                                                   |
| Rapports de comparaison              | <p>Ces rapports vous montrent comment votre programme se compare à d’autres, les possibilités de croissance et les partenaires susceptibles de contribuer à cette croissance.</p><p>• <a href="https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/performance-program/performance-program-reports/competitive-insights/benchmarking/brand-benchmarking-overview.md">Vue d’ensemble comparative de la marque</a> compare les résultats de votre programme de partenariat à ceux d’autres programmes de votre segment concurrentiel. Il présente notamment les niveaux d’activité de vos partenaires, l’efficacité de vos programmes et la répartition des types de partenaires.</p><p>• <a href="https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/performance-program/performance-program-reports/competitive-insights/benchmarking/benchmark-partner-analysis.md">Analyse comparative des partenaires</a> classe vos partenaires en fonction de leurs résultats dans votre programme par rapport à ceux obtenus dans d’autres programmes. Elle met en évidence les lacunes et les possibilités de croissance, ainsi que les indicateurs de performance pour lesquels vos résultats sont supérieurs ou inférieurs à la moyenne.</p><p>• <a href="https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/performance-program/performance-program-reports/competitive-insights/benchmarking/benchmark-recommendations.md">Recommandations comparatives</a> met en avant les partenaires les plus performants de votre segment. Vous pouvez filtrer les partenaires actuels et ceux qui ne vous ont pas encore rejoint, afin de savoir lesquels recruter ou auprès desquels investir.</p> |
| Rapport sur les tendances du secteur | Ce rapport vous fournit des informations sur l’ensemble du secteur et vous permet de consulter les indicateurs moyens des programmes de votre secteur d’activité. Ces informations sont regroupées pour vous donner une vue d’ensemble de votre programme, de ses principaux indicateurs et des meilleurs partenaires de votre secteur. En savoir plus sur le [rapport sur les tendances du secteur](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/performance-program/performance-program-reports/competitive-insights/industry-insights-report.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

</details>

<details>

<summary>Rapports sur les programmes de créateurs</summary>

Les rapports sur les créateurs sont disponibles dans votre programme de créateurs impact.com. Ils regroupent des indicateurs de campagne provenant de diverses sources, comme les données de performance d’impact.com et des sources externes telles que les réseaux sociaux. Consultez la page [Présentation des rapports sur les créateurs](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/creator-program/creator-reports/creator-reports-overview.md) pour en savoir plus.

| Rapport                             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rapports sur les performances       | Ces rapports vous fournissent un large éventail de données de suivi, ventilées selon différentes métriques liées aux créateurs. Ils comprennent le [Rapport récapitulatif du contenu et des campagnes](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/creator-program/creator-reports/content-and-campaign-overview-report.md), qui regroupe les données par campagne, créateur, plateforme sociale et publication. Ces rapports présentent divers indicateurs clés de performance (KPI), comme les actions ou les clics. En savoir plus sur les [rapports sur les performances](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/creator-program/creator-reports.md). |
| Rapport récapitulatif des créateurs | Ce rapport vous offre un espace centralisé pour suivre les performances de votre campagne. Vous pouvez consulter des indicateurs clés, comme les performances globales de la campagne, les créateurs et les contenus les plus performants, et bien plus encore. Une fois la campagne terminée, vous pouvez en partager les résultats, démontrer sa valeur et obtenir des informations exploitables pour optimiser votre prochaine campagne. En savoir plus sur le [rapport récapitulatif des créateurs](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/creator-program/creator-reports/creator-wrap-report.md).                                                                           |

</details>

<details>

<summary>Rapports sur les programmes Advocate</summary>

impact.com propose diverses métriques et analyses pour vous aider à évaluer la santé et la réussite de votre programme Advocate. Vous trouverez des rapports téléchargeables sur votre programme et les données relatives aux participants. Tous les rapports offrent des options de filtrage pour mieux contrôler les données téléchargées. Chaque rapport peut être téléchargé au format .csv ou Excel.

| Rapport                                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Présentation des analyses Advocate : explications | La présentation des analyses vous donne un aperçu des données de l’ensemble de vos programmes de recommandation. Vous pouvez y évaluer l’impact global de votre programme au fil du temps et obtenir des informations sur les performances de tous vos programmes Advocate pour une date sélectionnée. En savoir plus sur la [présentation des analyses Advocate](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-analytics-overview-explained.md). |
| Analyses des programmes Advocate : explications   | Les analyses des programmes fournissent des informations sur un programme Advocate donné pour une période sélectionnée. Vous pouvez suivre les indicateurs clés et consulter les performances du programme à l’aide de graphiques simples. En savoir plus sur les [analyses des programmes Advocate](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-analytics-explained.md).                                                               |
| Rapports des programmes Advocate                  | Ces rapports fournissent des informations sur les participants, l’activité, les récompenses et les données fiscales de votre programme de recommandation. Ils vous aident à gérer l’engagement des utilisateurs, à suivre la réussite des recommandations et à attribuer ou gérer les récompenses. En savoir plus sur les [rapports des programmes Advocate](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).         |

</details>

## Référence des éditions de compte

Voici une comparaison des rapports disponibles selon les éditions de compte.

| Rapports                                     | Starter                                      | Essentials                                   | Professional                                 | Enterprise                                   |
| -------------------------------------------- | -------------------------------------------- | -------------------------------------------- | -------------------------------------------- | -------------------------------------------- |
| Rapports personnalisés de Data Lab           | <mark style="color:$danger;">**Non**</mark>  | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> |
| Rapports opérationnels                       | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> |
| Rapports de référencement                    | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> |
| Rapports financiers                          | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> |
| Rapports sur les performances des marques    | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> |
| Rapports de dépassement                      | <mark style="color:$danger;">**Non**</mark>  | **Limité**                                   | **Limité**                                   | **Limité**                                   |
| Rapports sur les risques liés aux événements | <mark style="color:$danger;">**Non**</mark>  | <mark style="color:$danger;">**Non**</mark>  | <mark style="color:$success;">**Oui**</mark> | <mark style="color:$success;">**Oui**</mark> |
| Analyses concurrentielles                    | <mark style="color:$danger;">**Non**</mark>  | **Limité**                                   | **Limité**                                   | **Limité**                                   |


---

# 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/getting-started/introduction-to-impactcom-reporting-for-brands.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.
