> 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/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md).

# Définir des règles de paiement à l'aide de groupes de paiement

<a href="https://pxa.impact.com/student/activity/1117596?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=con-350&#x26;utm_campaign=help-center" class="button primary">Suivre le cours PXA</a>

*Groupes de versement* vous permettent de définir des règles sur les versements partenaires pour les actions qu'ils génèrent, et elles sont incluses dans vos [conditions de modèle](/brand/fr/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/create-template-terms.md). Si la condition d'un groupe de versement est remplie, la modification du versement s'appliquera au même niveau (commande ou article) que le *versement par défaut*.

Un seul groupe de versement peut s'appliquer à la fois. Les groupes de versement personnalisés fonctionnent mieux lorsqu'ils sont mutuellement exclusifs ; si des groupes de versement ont des conditions qui se chevauchent, placez les critères du groupe de versement les plus spécifiques en haut (par ex. « Statut du client = Nouveau et total de la commande ≥ 200 $ ») et les critères les plus courants vers le bas (par ex. « Total de la commande ≥ 200 $ »).

## Ajouter un groupe de versement à une condition de modèle

{% hint style="warning" %}
**Attention :** L'ajout de règles de versement supplémentaires peut nécessiter certaines connaissances techniques. Si vous souhaitez configurer des règles de versement supplémentaires, [contactez le support](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml?execution=e3s1).
{% endhint %}

Les groupes de versement sont généralement ajoutés lorsque vous créez une condition de modèle, mais vous pouvez toujours remplacer les contrats plus tard.

1. Dans la barre de navigation de gauche, sélectionnez ![](/files/15f4c8f88cb75624c1f6a18cb768e8f494128ac4) **\[Engage] → Contrats →** [**Conditions de modèle**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
2. En haut à droite, sélectionnez **Créer une condition de modèle**.
3. À côté de *Type d'événement*, dans le ![](/files/b04f0278cecdb6d4cd1acab522796f8fbdcb0fa1) **\[menu déroulant]**, sélectionnez le type d'événement auquel cette condition de modèle s'applique.
4. À côté de *Groupes de versement*, activez ![](/files/305a4944a71dea362e7149113d0a2b30f3a73a14) **\[Activer]** **Configurer des groupes de versement personnalisés**.
5. Pour ajouter un groupe de versement, sélectionnez **Ajouter un nouveau**.
6. Configurez les *règles de versement* à l'aide des ![](/files/b04f0278cecdb6d4cd1acab522796f8fbdcb0fa1) **\[menu déroulant]** et des champs.
   * Facultativement, sélectionnez ![](/files/2e9a31a024d0b16eff92531050fb4093467526d2) **\[Ajouter un autre]** pour créer une deuxième règle au sein du même groupe de versement.
   * Si vous ajoutez plusieurs règles à 1 groupe de versement, toutes les règles doivent s'appliquer pour que le groupe de versement s'applique.

<details>

<summary>Référence des règles de versement</summary>

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Règle de paiement</th><th>Description</th></tr></thead><tbody><tr><td>Devise</td><td><p>La devise dans laquelle l'achat a été effectué. Elle est utilisée pour calculer les taux de change vers les devises de financement et de paiement si nécessaire.</p><p>Si cela n'est pas envoyé, la devise par défaut de votre compte sera utilisée.</p></td></tr><tr><td>Ville du client</td><td>Ville indiquée par le client dans la conversion.</td></tr><tr><td>Pays/Région du client</td><td>L'emplacement indiqué par le client dans la conversion.</td></tr><tr><td>Code postal du client</td><td>Code postal (ou ZIP) indiqué par le client dans la conversion.</td></tr><tr><td>Région du client</td><td>Code de région du client dans la conversion.</td></tr><tr><td>Statut du client</td><td><p>Statut du client (p. ex., nouveau, récurrent, etc.).</p><p>Ces valeurs doivent être configurées dans la <a href="/pages/d994ad99b8cbadbc82fcb74cab978d776546f148">section de mappage du statut client</a> lors de la modification d'un type d'événement.</p></td></tr><tr><td>Date1-10</td><td><p>Champ de date général qui accepte une date ou une date et heure que vous souhaitez envoyer. Ces valeurs apparaissent dans vos rapports.<br></p><p>Formats acceptés : <code>2026-08-21T07:25:00Z</code>, <code>2026-08-06</code>, <code>2026-08-06 13:14:57</code>, <code>2026-08-06T13:14:57.000Z</code>, <code>2026-08-06T13:14:57-07:00</code>, <code>2026-8-6</code>.<br></p><p>Les plages de dates incluent la date de début et excluent la date de fin — par exemple, <code>Date1 entre 2024-08-01 et 2024-09-30</code> correspond du 2024-08-01 au 2024-09-29, et non au 2024-09-30.</p></td></tr><tr><td>Navigateur dérivé</td><td>Navigateur déterminé par l'adresse IP de l'utilisateur au moment de la conversion.</td></tr><tr><td>Pays/Région dérivé</td><td>Pays ou région déterminé par l'adresse IP de l'utilisateur au moment de la conversion.</td></tr><tr><td>Type d'appareil dérivé</td><td>L'appareil électronique déterminé par l'adresse IP de l'utilisateur au moment de la conversion.</td></tr><tr><td>OS dérivé</td><td>Le système d'exploitation de l'appareil déterminé par l'adresse IP de l'utilisateur au moment de la conversion.</td></tr><tr><td>État/Région dérivé</td><td>L'état ou la région géographique déterminé par l'adresse IP de l'utilisateur au moment de la conversion.</td></tr><tr><td>Achat cadeau</td><td>Si vous suivez les achats cadeaux, vous pouvez marquer la commande dans la conversion comme un achat cadeau.</td></tr><tr><td>Comment avez-vous entendu parler de nous</td><td>Utilisé pour capturer comment le client a entendu parler de votre entreprise.</td></tr><tr><td>Marque de l'article</td><td>Le nom de la marque associé au produit.</td></tr><tr><td>Catégorie de l'article</td><td>Catégorie du produit référencé au niveau de l'article.</td></tr><tr><td>Type de livraison de l'article</td><td>Le mode de livraison spécifié pour un produit.</td></tr><tr><td>Remise sur l'article</td><td>Remise appliquée à chaque article acheté.</td></tr><tr><td>Nom de l'article</td><td>Nom du produit acheté.</td></tr><tr><td>Prix de l'article</td><td>Prix unitaire individuel de chaque produit.</td></tr><tr><td>Quantité de l'article</td><td>Quantité de l'article qui a été achetée dans la commande, exprimée en nombre entier.</td></tr><tr><td>SKU de l'article</td><td>Valeur unique d'unité de gestion de stock (SKU) du produit référencé au niveau de l'article.</td></tr><tr><td>Sous-catégorie de l'article</td><td>Le cas échéant, la sous-catégorie du produit référencé au niveau de l'article.</td></tr><tr><td>Sous-total de l'article</td><td>Prix total de cette ligne d'article (tous les produits achetés de ce type). La valeur finale sera déterminée en soustrayant de cette valeur les remises correspondantes.</td></tr><tr><td>Money1-3</td><td>Champ numérique général qui accepte des chaînes de toute donnée monétaire ou financière que vous souhaitez envoyer. Ces valeurs apparaissent dans vos rapports.</td></tr><tr><td>Note</td><td>Champ général utilisé pour transmettre des informations à des fins de reporting au niveau de l'événement.</td></tr><tr><td>Numeric1-10</td><td>Champ numérique général qui accepte des chaînes de toute donnée numérique que vous souhaitez envoyer. Ces valeurs apparaissent dans vos rapports.</td></tr><tr><td>Remise sur la commande</td><td><p>Pour les ventes, il s'agit de la remise appliquée à l'ensemble de la commande. Le montant est automatiquement soustrait du total de la commande lors du traitement. Si des montants d'articles sont utilisés, cette remise sera soustraite proportionnellement de chaque montant d'article transmis.</p><p>En général, les remises sur les frais de livraison sont exclues.</p></td></tr><tr><td>ID du lieu de la commande</td><td>Principalement utilisé pour le voyage, cela précise l'identifiant unique du lieu pour cet achat.</td></tr><tr><td>Nom du lieu de la commande</td><td>Principalement utilisé pour le voyage, cela précise le lieu de l'achat.</td></tr><tr><td>Type de lieu de la commande</td><td>Principalement utilisé pour le voyage, cela précise le type de lieu de l'achat.</td></tr><tr><td>Type de paiement de la commande</td><td>Comment le client a payé sa commande.</td></tr><tr><td>Code promo de commande</td><td>L'action inclut un code promo utilisé par le client.</td></tr><tr><td>Livraison de la commande</td><td>Principalement utilisé pour les ventes au détail avec des frais de livraison pour une conversion. Le montant total de la vente utilisé à des fins de paiement n'inclura pas les frais de livraison.</td></tr><tr><td>Taxe de la commande</td><td>Principalement utilisé pour les ventes au détail avec des taxes pour une conversion. Le montant total de la vente utilisé à des fins de paiement n'inclura pas les taxes.</td></tr><tr><td>Total de la commande</td><td>Le montant avant déduction de la taxe et après déduction de toute remise.</td></tr><tr><td>Annonce de référence</td><td>Le nom et l'ID de l'annonce qui ont déclenché le clic.</td></tr><tr><td>Campagne publicitaire de référence</td><td>Le nom de la campagne publicitaire de l'annonce qui a déclenché le clic (notion d'annonce et de campagne d'un tiers/serveur publicitaire).</td></tr><tr><td>ID de la campagne publicitaire de référence</td><td>L'ID de campagne publicitaire tiers capturé à partir des paramètres de suivi du clic référent, par ex. Google Ads. Cela est extrait automatiquement des données de clic associées plutôt que des données de conversion soumises par la marque.</td></tr><tr><td>Groupe d'annonces de référence</td><td>Le groupe d'annonces tiers dans lequel cette étape du parcours de conversion est contenue (par ex., recherche payante).</td></tr><tr><td>ID du groupe d'annonces de référence</td><td>L'ID Google du groupe d'annonces tiers.</td></tr><tr><td>Mot-clé de l'annonce de référence</td><td>Mots-clés utilisés dans les efforts de recherche payante.</td></tr><tr><td>Emplacement de l'annonce de référence</td><td>L'emplacement de l'annonce sur la page du partenaire. Les valeurs typiques sont "Home" et "Forum".</td></tr><tr><td>Type d'annonce de référence</td><td>Quel distributeur publicitaire tiers a diffusé l'annonce (par ex., Google Ads).</td></tr><tr><td>Offre de référence</td><td>Type d'offre associée à l'annonce.</td></tr><tr><td>Navigateur dérivé de référence</td><td>Le navigateur déterminé par l'adresse IP de l'utilisateur au moment du clic.</td></tr><tr><td>Pays/Région dérivé de référence</td><td>Le pays ou la région déterminé par l'adresse IP de l'utilisateur au moment du clic.</td></tr><tr><td>Type d'appareil dérivé de référence</td><td>Le type d'appareil déterminé par l'adresse IP de l'utilisateur au moment du clic.</td></tr><tr><td>OS dérivé de référence</td><td>Le système d'exploitation déterminé par l'adresse IP de l'utilisateur au moment du clic.</td></tr><tr><td>État/Région dérivé de référence</td><td>L'état déterminé par l'adresse IP de l'utilisateur au moment du clic.</td></tr><tr><td>Page d'atterrissage de référence</td><td>L'URL de la page d'atterrissage pour l'événement.</td></tr><tr><td>Param1-10 de référence</td><td>Valeurs que les partenaires peuvent inclure dans la chaîne de requête du clic et qui peuvent être ce qu'ils veulent.</td></tr><tr><td>SharedId de référence</td><td>Champ SharedId général qui accepte des chaînes de n'importe quelle <a href="/pages/d4a93f0ce7e6db969706354856ed72ee80085f7f">SharedIds</a> que vous souhaitez envoyer. Apparaît dans vos rapports.</td></tr><tr><td>SKU de référence</td><td>Identifiant unique de l'article—généralement l'identifiant d'unité de gestion de stock (SKU) du produit promu.</td></tr><tr><td>ID du sous-compte de référence</td><td>ID du partenaire ou de la source média qui a généré l'action.</td></tr><tr><td>Nom du sous-compte de référence</td><td>Nom du partenaire ou de la source média qui a généré l'étape.</td></tr><tr><td>Type de trafic de référence</td><td>D'où viennent les utilisateurs lorsqu'un partenaire les dirige vers votre site.</td></tr><tr><td>Source de trafic de référence</td><td>À quel endroit du site de référence l'annonce est hébergée.</td></tr><tr><td>URL de référence</td><td>L'URL ou le lien du site Web qui a référé le client.</td></tr><tr><td>Catégorie du site</td><td>La catégorie associée à votre site.</td></tr><tr><td>Version du site</td><td>Spécifie la version du site visité par ce client.</td></tr><tr><td>Text1-50</td><td>Champ de texte général qui accepte des chaînes de tout texte que vous souhaitez envoyer. Ces valeurs apparaissent dans vos rapports.</td></tr><tr><td>* Les règles de paiement suivantes sont uniquement disponibles pour certaines éditions impact.com :</td><td></td></tr><tr><td>Audience</td><td>Une valeur structurée qu'un partenaire transmet lors d'une conversion pour identifier à quel segment d'audience appartient l'utilisateur converti.  <br><br>Vous et le partenaire vous accordez sur le <em>Audience</em> segment et sa valeur hors plateforme, puis configurez votre contrat afin que les conversions portant cette valeur paient automatiquement un taux différent.</td></tr><tr><td>ID du groupe d'annonces d'amplification</td><td>Identifiant unique reliant un clic à un <a href="/pages/f5c78cba30add8caf025b81c705688a2726efbcb">ensemble publicitaire amplifié</a>.</td></tr><tr><td>ID de l'annonce d'amplification</td><td>Identifiant unique reliant un clic à un <a href="/pages/f5c78cba30add8caf025b81c705688a2726efbcb">annonce amplifiée</a>.</td></tr><tr><td>ID de campagne d'amplification</td><td>Identifiant unique reliant un clic à un <a href="/pages/f5c78cba30add8caf025b81c705688a2726efbcb">campagne amplifiée</a>.</td></tr><tr><td>ID de clic Facebook</td><td>L'identifiant de clic de Meta pour le reporting des conversions et le partage de données.</td></tr><tr><td>Liste pour le code promo de commande</td><td><a href="/pages/e0689daab333c8c4c78a4d4204263197dd7e6692">Liste d'exceptions des codes promo</a> utilisé pour rémunérer les partenaires à des taux différents en fonction des codes promo associés aux actions qu'ils ont générées.</td></tr><tr><td>Liste pour le code promo d'article</td><td><a href="/pages/e0689daab333c8c4c78a4d4204263197dd7e6692">Liste d'exceptions des codes promo</a> utilisé pour rémunérer les partenaires à des taux différents en fonction des codes promo de lignes d'articles spécifiques dans la commande figurant sur une liste prédéfinie.</td></tr><tr><td>Liste pour le SKU d'article</td><td><a href="/pages/133023fb70447678de9eaf141779068180a76828">Liste d'exceptions des SKU</a> utilisé pour rémunérer les partenaires à des taux différents en fonction du SKU associé à l'action qu'ils ont générée.</td></tr><tr><td>Liste pour la catégorie d'article</td><td><a href="/pages/133023fb70447678de9eaf141779068180a76828">Liste d'exceptions des catégories</a> utilisé pour rémunérer les partenaires à des taux différents en fonction de la catégorie associée à l'action qu'ils ont générée.</td></tr><tr><td>Liste pour la super-catégorie d'article</td><td><a href="/pages/133023fb70447678de9eaf141779068180a76828">Liste d'exceptions des catégories</a> où les valeurs sont une série de catégories et de sous-catégories (formatées comme <code>{category}_{subcategory}</code>. Cela est conçu pour les marques qui doivent verser des commissions selon des combinaisons spécifiques de <code>ItemCategory</code> et <code>ItemSubCategory</code>.</td></tr><tr><td>Fabricant du catalogue d'articles</td><td>L'entité qui fabrique l'article. Le SKU de l'événement de conversion est utilisé pour rechercher la valeur du fabricant correspondante dans le catalogue de produits.</td></tr><tr><td>Catégorie du format d'origine du catalogue d'articles</td><td>La catégorie de l'article issue du format d'origine du catalogue de produits/articles. Le SKU de l'événement de conversion est utilisé pour rechercher la valeur du fabricant correspondante dans le catalogue de produits.</td></tr><tr><td>Catégorie du catalogue d'articles</td><td>La catégorie du catalogue de produits de la marque. Cela est utile lorsque les données du catalogue fournissent un regroupement de produits plus précis que les données de point de vente.</td></tr><tr><td>Sous-catégorie du catalogue d'articles</td><td>Le deuxième ou troisième niveau de catégorisation pour un catalogue de produits. Le SKU de l'événement de conversion est utilisé pour rechercher la valeur du fabricant correspondante dans le catalogue de produits.</td></tr><tr><td>ItemText1-10</td><td>Champ de texte général qui accepte des chaînes de toute donnée textuelle pour un SKU.</td></tr><tr><td>ItemNumeric1-10</td><td>Champ numérique général qui accepte des chaînes de toute donnée numérique pour un SKU.</td></tr><tr><td>ItemDate1-10</td><td>Champ de date général qui accepte une date ou une date et heure pour un SKU.<br><br>Formats acceptés : <code>2026-08-21T07:25:00Z</code>, <code>2026-08-06</code>, <code>2026-08-06 13:14:57</code>, <code>2026-08-06T13:14:57.000Z</code>, <code>2026-08-06T13:14:57-07:00</code>, <code>2026-8-6</code>.</td></tr><tr><td>ItemMoney1-3</td><td>Champ numérique général qui accepte des chaînes de toute donnée monétaire ou financière pour un SKU.</td></tr><tr><td>Taux de remise de commande</td><td>Le taux de remise appliqué à toute commande. Par ex., <code>OrderDiscountRate50</code> représente une remise de 50 % pour une commande.</td></tr><tr><td>Taux de remise d'article</td><td>Le taux de remise appliqué à chaque article acheté. Par ex., <code>ItemDiscountRate123_50</code> représente une remise de 50 % pour un <code>ItemSku123</code>.</td></tr><tr><td>Nombre de canaux du parcours</td><td>Combien de canaux ont été impliqués dans le parcours de conversion.</td></tr><tr><td>Canaux de clôture du parcours</td><td>Le canal qui a généré le dernier clic de référence (gagnant) du partenaire.</td></tr><tr><td>Groupes de clôture du parcours</td><td>Le groupe qui a généré le dernier clic de référence (gagnant) du partenaire.</td></tr><tr><td>Médias de clôture du parcours</td><td>Le canal média qui a généré le dernier clic de référence (gagnant) du partenaire.</td></tr><tr><td>Nombre de partenaires impact.com du parcours</td><td>Le nombre de partenaires dans le parcours de clics déterminé par impact.com.</td></tr><tr><td>Canaux d'introduction du parcours</td><td>Le canal qui a introduit le premier partenaire dans le parcours de clics.</td></tr><tr><td>Groupes d'introduction du parcours</td><td>Le groupe qui a introduit le premier partenaire dans le parcours de clics.</td></tr><tr><td>Médias d'introduction du parcours</td><td>Le média qui a introduit le premier partenaire dans le parcours de clics.</td></tr><tr><td>Nombre de médias du parcours</td><td>Combien de partenaires et de sources média ont été impliqués dans le parcours de conversion.</td></tr><tr><td>Canaux participants du parcours</td><td>Le canal qui a amené un partenaire entre le premier et le dernier clic de référence (gagnant).</td></tr><tr><td>Groupes participants du parcours</td><td>Le groupe qui a amené un partenaire entre le premier et le dernier clic de référence (gagnant).</td></tr><tr><td>Médias participants du parcours</td><td>Le média qui a amené un partenaire entre le premier et le dernier clic de référence (gagnant).</td></tr><tr><td>Nombre de partenaires du parcours</td><td>Le nombre de partenaires dans le parcours de clics.</td></tr><tr><td>Étapes du parcours</td><td>Combien d'activités (par ex., impressions) ont eu lieu dans le parcours de conversion.</td></tr></tbody></table>

</details>

7. Saisissez le **Versement** montant, et si l'option vous est proposée, indiquez **Limites** sur les éléments payables.

   * Si vous ne voyez pas le *Limites* commutateur dans la fenêtre modale, [contactez le support](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) pour demander l'ajout de la fonctionnalité à votre compte.

   <div data-with-frame="true"><figure><img src="/files/565abc4b949727cd3a48eda2cdfed2d7f3287552" alt="" width="563"><figcaption></figcaption></figure></div>
8. Dans le coin inférieur droit de la fenêtre modale, sélectionnez **Ajouter** pour enregistrer le groupe de versement.
9. Pour créer un autre groupe de versement, sélectionnez **Ajouter un nouveau**. Si vous créez plusieurs groupes, vous pouvez les sélectionner et les faire glisser pour modifier leur rang.

<details>

<summary>Fonctionnement du classement</summary>

Vos groupes de versement sont évalués de haut en bas, et le premier groupe dont les conditions correspondent à la conversion s'applique — tous les groupes de rang inférieur sont ignorés. Placez vos conditions les plus précises en haut et les conditions plus larges ou génériques en bas.

Par exemple, un groupe ciblant **les nouveaux clients avec un total de commande supérieur à 200 $** doit être placé au-dessus d'un groupe ciblant **les nouveaux clients** uniquement. Si le groupe plus large est classé en premier, il correspond à chaque commande d'un nouveau client avant que la règle plus spécifique ait la possibilité de s'appliquer.

</details>

10. Continuer [la création de votre condition de modèle](/brand/fr/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/create-template-terms.md).

{% hint style="success" %}
**Remarque :** Lors de la configuration d'un groupe de versement à l'aide du *URL de référence* , vous pouvez utiliser l' *caractère générique* pour correspondre malgré tout caractère précédent ou suivant. Par exemple, utilisez `*facebook*` pour faire correspondre toute URL de référence provenant de Facebook.
{% endhint %}

### Combiner les critères du groupe de versement

* Les virgules dans vos critères de groupe de versement ne combineront pas les deux critères (p. ex., `La catégorie d'article est ACME, Anvils` sera interprété comme la catégorie d'article est ACME OU Anvils). Vous pouvez contourner ce problème en plaçant des guillemets autour de votre règle contenant une virgule (`La catégorie d'article est "ACME,Anvils"`).

## Groupes de versement basés sur la localisation

Lors de la configuration de groupes de versement basés sur la localisation géographique, vous devrez choisir la bonne source de données. Vous pouvez faire la distinction entre l'origine d'un clic et le lieu de résidence réel du client.

| Exigence                                             | Paramètre recommandé               | Source de données                                             |
| ---------------------------------------------------- | ---------------------------------- | ------------------------------------------------------------- |
| Groupe de versement basé sur l'adresse de livraison  | Pays/Région du client              | Données transmises via votre pixel de suivi lors du paiement. |
| Groupe de versement basé sur la localisation du clic | Pays/Région dérivé de la référence | L'adresse IP de l'utilisateur au moment du clic.              |


---

# 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/fr/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md?ask=<question>&goal=<endgoal>
```

`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.