> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md).

# Imposta le regole di payout usando i gruppi di payout

<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">Segui il corso PXA</a>

*Gruppi di payout* ti consentono di impostare regole sui payout ai partner per le azioni che generano e sono inclusi nei tuoi [termini del template](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/create-template-terms.md). Se la condizione di un gruppo di payout è soddisfatta, applicherà la modifica del payout allo stesso livello (ordine o articolo) del *payout predefinito*.

Può essere applicato un solo gruppo di payout alla volta. I gruppi di payout personalizzati funzionano meglio quando sono mutuamente esclusivi, quindi se i gruppi di payout hanno condizioni sovrapposte, inserisci in alto i criteri del gruppo di payout più specifico (ad es. "Lo stato del cliente è Nuovo e il totale ordine ≥ $200") e in basso i criteri più comuni (ad es. "Totale ordine ≥ $200").

## Aggiungi un gruppo di payout a un termine del template

{% hint style="warning" %}
**Attenzione:** L'aggiunta di ulteriori regole di payout potrebbe richiedere alcune conoscenze tecniche. Se desideri configurare ulteriori regole di payout, [contatta l'assistenza](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml?execution=e3s1).
{% endhint %}

I gruppi di payout vengono solitamente aggiunti quando crei un termine del template, ma puoi sempre cambiare i contratti in seguito.

1. Dalla barra di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage] → Contratti →** [**Termini del template**](https://app.impact.com/secure/advertiser/engage/contracts/library/view-manage-ios-flow.ihtml).
2. In alto a destra, seleziona **Crea termine del template**.
3. Accanto a *Tipo di evento*, dal ![](/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8) **\[menu a discesa]**, seleziona il tipo di evento a cui si applica questo termine del template.
4. Accanto a *Gruppi di payout*, attiva ![](/files/bcb6da087265fb9beef85997a54e50203691b8d1) **\[Interruttore attivato]** **Configura gruppi di payout personalizzati**.
5. Per aggiungere un gruppo di payout, seleziona **Aggiungi nuovo**.
6. Configura le *regole di payout* usando i ![](/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8) **\[menu a discesa]** e i campi.
   * Facoltativamente, seleziona ![](/files/0aafef99ec4e77d9b7b3e0531467b63590add75d) **\[Aggiungi un altro]** per creare una seconda regola nello stesso gruppo di payout.
   * Se aggiungi più regole a 1 gruppo di payout, tutte le regole devono essere soddisfatte affinché il gruppo di payout si applichi.

<details>

<summary>Riferimento alle regole di payout</summary>

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Regola di pagamento</th><th>Descrizione</th></tr></thead><tbody><tr><td>Valuta</td><td><p>La valuta in cui è stato effettuato l'acquisto. Viene usata per calcolare i tassi di cambio verso le valute di funding e di pagamento, se necessario.</p><p>Se questo non viene inviato, verrà usata la valuta predefinita del tuo account.</p></td></tr><tr><td>Città del cliente</td><td>Città specificata dal cliente nella conversione.</td></tr><tr><td>Paese/Regione del cliente</td><td>La località specificata dal cliente nella conversione.</td></tr><tr><td>Codice postale del cliente</td><td>Codice postale (o ZIP) specificato dal cliente nella conversione.</td></tr><tr><td>Regione del cliente</td><td>Codice della regione del cliente nella conversione.</td></tr><tr><td>Stato del cliente</td><td><p>Stato del cliente (ad es. Nuovo, Di ritorno, ecc.).</p><p>Questi valori devono essere configurati nella <a href="/pages/c168cb19885997d5fbdf9293f8b6ca17186fba34">sezione Mappatura dello stato del cliente</a> quando si modifica un tipo di evento.</p></td></tr><tr><td>Data1-10</td><td><p>Campo data generico che accetta una data o una data e ora che desideri inviare. Questi valori compaiono nei tuoi report.<br></p><p>Formati accettati: <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>Gli intervalli di date includono l'inizio ed escludono la fine — ad esempio, <code>Data1 compresa tra 2024-08-01 e 2024-09-30</code> corrisponde dal 2024-08-01 al 2024-09-29, non al 2024-09-30.</p></td></tr><tr><td>Browser derivato</td><td>Browser determinato dall'indirizzo IP dell'utente al momento della conversione.</td></tr><tr><td>Paese/Regione derivato</td><td>Paese o regione determinati dall'indirizzo IP dell'utente al momento della conversione.</td></tr><tr><td>Tipo di dispositivo derivato</td><td>Il dispositivo elettronico determinato dall'indirizzo IP dell'utente al momento della conversione.</td></tr><tr><td>OS derivato</td><td>Il sistema operativo del dispositivo determinato dall'indirizzo IP dell'utente al momento della conversione.</td></tr><tr><td>Stato/Regione derivato</td><td>Lo stato o la regione geografica determinati dall'indirizzo IP dell'utente al momento della conversione.</td></tr><tr><td>Acquisto regalo</td><td>Se stai tracciando acquisti regalo, puoi contrassegnare l'ordine nella conversione come acquisto regalo.</td></tr><tr><td>Come ci hai conosciuti</td><td>Usato per acquisire come il cliente ha conosciuto la tua attività.</td></tr><tr><td>Marca dell'articolo</td><td>Il nome del marchio associato al prodotto.</td></tr><tr><td>Categoria dell'articolo</td><td>Categoria del prodotto indicato a livello di articolo.</td></tr><tr><td>Tipo di consegna dell'articolo</td><td>Il metodo di consegna specificato per un prodotto.</td></tr><tr><td>Sconto sull'articolo</td><td>Sconto applicato a ciascun articolo acquistato.</td></tr><tr><td>Nome dell'articolo</td><td>Il nome del prodotto acquistato.</td></tr><tr><td>Prezzo dell'articolo</td><td>Prezzo unitario di ciascun prodotto.</td></tr><tr><td>Quantità dell'articolo</td><td>Quantità dell'articolo acquistato nell'ordine, espressa come numero intero.</td></tr><tr><td>SKU dell'articolo</td><td>Valore univoco dell'unità di gestione delle scorte (SKU) del prodotto indicato a livello di articolo.</td></tr><tr><td>Sottocategoria dell'articolo</td><td>Se applicabile, la sottocategoria del prodotto indicato a livello di articolo.</td></tr><tr><td>Subtotale dell'articolo</td><td>Prezzo totale per questa riga di articolo (tutti i prodotti acquistati di questo tipo). Il valore finale sarà determinato sottraendo da questo valore gli sconti corrispondenti.</td></tr><tr><td>Denaro1-3</td><td>Campo numerico generico che accetta stringhe di qualsiasi dato monetario o finanziario che desideri inviare. Questi valori compaiono nei tuoi report.</td></tr><tr><td>Nota</td><td>Campo generico usato per trasmettere informazioni ai fini della reportistica a livello di evento.</td></tr><tr><td>Numerico1-10</td><td>Campo numerico generico che accetta stringhe di qualsiasi dato numerico che desideri inviare. Questi valori compaiono nei tuoi report.</td></tr><tr><td>Sconto sull'ordine</td><td><p>Per le vendite, questo è lo sconto applicato all'ordine nel suo complesso. L'importo viene sottratto automaticamente dal totale dell'ordine al momento dell'elaborazione. Se vengono usati importi per articolo, questo sconto sarà sottratto proporzionalmente da ogni importo articolo inviato.</p><p>In genere, gli sconti sulla spedizione sono esclusi.</p></td></tr><tr><td>ID località ordine</td><td>Usato principalmente per i viaggi, specifica l'identificatore univoco della località per questo acquisto.</td></tr><tr><td>Nome località ordine</td><td>Usato principalmente per i viaggi, specifica la località per l'acquisto.</td></tr><tr><td>Tipo di località ordine</td><td>Usato principalmente per i viaggi, specifica il tipo di località per l'acquisto.</td></tr><tr><td>Tipo di pagamento dell'ordine</td><td>Come il cliente ha pagato il suo ordine.</td></tr><tr><td>Codice promo ordine</td><td>L'azione include un codice promo usato dal cliente.</td></tr><tr><td>Spedizione ordine</td><td>Usato principalmente per le vendite al dettaglio con costi di spedizione per una conversione. L'importo totale della vendita usato ai fini del payout non includerà i costi di spedizione.</td></tr><tr><td>Tassa ordine</td><td>Usato principalmente per le vendite al dettaglio con costi fiscali per una conversione. L'importo totale della vendita usato ai fini del payout non includerà i costi fiscali.</td></tr><tr><td>Totale ordine</td><td>L'importo prima della detrazione delle imposte e dopo la detrazione di eventuali sconti.</td></tr><tr><td>Annuncio referral</td><td>Il nome e l'ID dell'annuncio che hanno generato il clic.</td></tr><tr><td>Campagna annuncio referral</td><td>Il nome della campagna pubblicitaria dell'annuncio che ha generato il clic (concezione di annuncio e campagna di terze parti/ad server).</td></tr><tr><td>ID campagna annuncio referral</td><td>L'ID della campagna pubblicitaria di terze parti acquisito dai parametri di tracciamento del clic di riferimento, ad es. Google Ads. Questo viene estratto automaticamente dai dati del clic associato anziché dai dati di conversione inviati dal brand.</td></tr><tr><td>Gruppo annuncio referral</td><td>Il gruppo pubblicitario di terze parti in cui è contenuto questo passaggio nel percorso di conversione (ad es. Ricerca a pagamento).</td></tr><tr><td>ID gruppo annuncio referral</td><td>L'ID di Google per il gruppo pubblicitario di terze parti.</td></tr><tr><td>Parola chiave annuncio referral</td><td>Parole chiave usate negli sforzi di Ricerca a pagamento.</td></tr><tr><td>Posizionamento annuncio referral</td><td>La posizione dell'annuncio nella pagina del partner. I valori tipici sono "Home" e "Forum".</td></tr><tr><td>Tipo annuncio referral</td><td>Quale distributore pubblicitario di terze parti ha pubblicato l'annuncio (ad es. Google Ads).</td></tr><tr><td>Offerta referral</td><td>Tipo dell'offerta associata all'annuncio.</td></tr><tr><td>Browser derivato referral</td><td>Il browser determinato dall'indirizzo IP dell'utente al momento del clic.</td></tr><tr><td>Paese/Regione derivato referral</td><td>Il paese o la regione determinati dall'indirizzo IP dell'utente al momento del clic.</td></tr><tr><td>Tipo di dispositivo derivato referral</td><td>Il tipo di dispositivo determinato dall'indirizzo IP dell'utente al momento del clic.</td></tr><tr><td>OS derivato referral</td><td>Il sistema operativo determinato dall'indirizzo IP dell'utente al momento del clic.</td></tr><tr><td>Stato/Regione derivato referral</td><td>Lo stato determinato dall'indirizzo IP dell'utente al momento del clic.</td></tr><tr><td>Landing page referral</td><td>L'URL della landing page per l'evento.</td></tr><tr><td>Param1-10 referral</td><td>Valori che i partner possono includere nella stringa di query del clic e che possono essere qualsiasi cosa desiderino.</td></tr><tr><td>SharedId referral</td><td>Campo SharedId generico che accetta stringhe di qualsiasi <a href="/pages/4a85f6ae6c91b568d2a7ec8f8dfba8a8e0dacb8e">ID condivisi</a> che desideri inviare. Appare nei tuoi report.</td></tr><tr><td>SKU referral</td><td>Identificatore univoco dell'articolo — di solito l'identificatore SKU (stock-keeping unit) del prodotto promosso.</td></tr><tr><td>ID subaccount referral</td><td>ID del partner o della fonte media che ha generato l'azione.</td></tr><tr><td>Nome subaccount referral</td><td>Nome del partner o della fonte media che ha generato il passaggio.</td></tr><tr><td>Tipo di traffico referral</td><td>Da dove provengono gli utenti quando un partner li indirizza al tuo sito.</td></tr><tr><td>Fonte di traffico referral</td><td>Dove è ospitato l'annuncio sul sito di riferimento.</td></tr><tr><td>URL referral</td><td>L'Uniform Resource Locator o link del sito web che ha indirizzato il cliente.</td></tr><tr><td>Categoria del sito</td><td>La categoria associata al tuo sito.</td></tr><tr><td>Versione del sito</td><td>Specifica la versione del sito visitata da questo cliente.</td></tr><tr><td>Testo1-50</td><td>Campo di testo generico che accetta stringhe di qualsiasi dato testuale che desideri inviare. Questi valori compaiono nei tuoi report.</td></tr><tr><td>* Le seguenti regole di payout sono disponibili solo per specifiche edizioni di impact.com:</td><td></td></tr><tr><td>Pubblico</td><td>Un valore strutturato che un partner trasmette in una conversione per identificare a quale segmento di pubblico appartiene l'utente che converte.  <br><br>Tu e il partner concordate il <em>Pubblico</em> segmento e il suo valore fuori piattaforma, quindi configuri il tuo contratto in modo che le conversioni che portano quel valore paghino automaticamente una tariffa diversa.</td></tr><tr><td>ID gruppo annuncio amplificazione</td><td>Identificatore univoco che collega un clic a un <a href="/pages/1a27d467d580913a2e4633c9c9a00361e596a07e">set di annunci amplificato</a>.</td></tr><tr><td>ID annuncio amplificazione</td><td>Identificatore univoco che collega un clic a un <a href="/pages/1a27d467d580913a2e4633c9c9a00361e596a07e">annuncio amplificato</a>.</td></tr><tr><td>ID campagna amplificazione</td><td>Identificatore univoco che collega un clic a un <a href="/pages/1a27d467d580913a2e4633c9c9a00361e596a07e">campagna amplificata</a>.</td></tr><tr><td>ID clic di Facebook</td><td>L'identificatore di clic di Meta per la reportistica delle conversioni e la condivisione dei dati.</td></tr><tr><td>Elenco per codice promo ordine</td><td><a href="/pages/22769eb4f50b766ac1709538b0e9f065304cfe8b">Elenco eccezioni codici promo</a> usato per pagare i partner a tariffe diverse in base ai codici promo associati alle azioni che hanno generato.</td></tr><tr><td>Elenco per codice promo articolo</td><td><a href="/pages/22769eb4f50b766ac1709538b0e9f065304cfe8b">Elenco eccezioni codici promo</a> usato per pagare i partner a tariffe diverse in base ai codici promo per specifiche righe dell'ordine presenti in un elenco predefinito.</td></tr><tr><td>Elenco per SKU articolo</td><td><a href="/pages/bfbbc0c86fc05e7c63220b2829e4db3bd7a61501">Elenco eccezioni SKU</a> usato per pagare i partner a tariffe diverse in base allo SKU associato all'azione che hanno generato.</td></tr><tr><td>Elenco per categoria articolo</td><td><a href="/pages/bfbbc0c86fc05e7c63220b2829e4db3bd7a61501">Elenco eccezioni categorie</a> usato per pagare i partner a tariffe diverse in base alla categoria associata all'azione che hanno generato.</td></tr><tr><td>Elenco per super categoria articolo</td><td><a href="/pages/bfbbc0c86fc05e7c63220b2829e4db3bd7a61501">Elenco eccezioni categorie</a> dove i valori sono una serie di categorie e sottocategorie (formattate come <code>{category}_{subcategory}</code>. Questo è progettato per i brand che devono calcolare commissioni in base a combinazioni specifiche di <code>Categoria articolo</code> e <code>Sottocategoria articolo</code>.</td></tr><tr><td>Produttore del catalogo articolo</td><td>L'entità che produce l'articolo. Lo SKU dell'evento di conversione viene usato per recuperare il valore del produttore corrispondente nel catalogo dei prodotti.</td></tr><tr><td>Categoria formato originale del catalogo articolo</td><td>La categoria dell'articolo dal formato originale del catalogo prodotti/articoli. Lo SKU dell'evento di conversione viene usato per recuperare il valore del produttore corrispondente nel catalogo dei prodotti.</td></tr><tr><td>Categoria del catalogo articolo</td><td>La categoria dal catalogo prodotti del brand. È utile quando i dati del catalogo forniscono un raggruppamento dei prodotti più accurato rispetto ai dati del punto vendita.</td></tr><tr><td>Sottocategoria del catalogo articolo</td><td>Il secondo o terzo livello di categorizzazione per un negozio di prodotti. Lo SKU dell'evento di conversione viene usato per recuperare il valore del produttore corrispondente nel catalogo dei prodotti.</td></tr><tr><td>Testo articolo1-10</td><td>Campo di testo generico che accetta stringhe di qualsiasi dato testuale per uno SKU.</td></tr><tr><td>Numerico articolo1-10</td><td>Campo numerico generico che accetta stringhe di qualsiasi dato numerico per uno SKU.</td></tr><tr><td>Data articolo1-10</td><td>Campo data generico che accetta una data o una data e ora per uno SKU.<br><br>Formati accettati: <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>Denaro articolo1-3</td><td>Campo numerico generico che accetta stringhe di qualsiasi dato monetario o finanziario per uno SKU.</td></tr><tr><td>Tasso di sconto ordine</td><td>Il tasso di sconto applicato a qualsiasi ordine. Ad es., <code>OrderDiscountRate50</code> rappresenta uno sconto del 50% per un ordine.</td></tr><tr><td>Tasso di sconto articolo</td><td>Il tasso di sconto applicato a ciascun articolo acquistato. Ad es., <code>ItemDiscountRate123_50</code> rappresenta uno sconto del 50% per un <code>ItemSku123</code>.</td></tr><tr><td>Conteggio canali del percorso</td><td>Quanti canali erano coinvolti nel percorso di conversione.</td></tr><tr><td>Canali di chiusura del percorso</td><td>Il canale che ha portato il partner all'ultimo referral di clic (vincitore).</td></tr><tr><td>Gruppi di chiusura del percorso</td><td>Il gruppo che ha portato il partner all'ultimo referral di clic (vincitore).</td></tr><tr><td>Media di chiusura del percorso</td><td>Il canale media che ha portato il partner all'ultimo referral di clic (vincitore).</td></tr><tr><td>Conteggio partner di impatto del percorso</td><td>Il numero di partner nel percorso di clic determinato da impact.com.</td></tr><tr><td>Canali introduttivi del percorso</td><td>Il canale che ha introdotto il primo partner nel percorso di clic.</td></tr><tr><td>Gruppi introduttivi del percorso</td><td>Il gruppo che ha introdotto il primo partner nel percorso di clic.</td></tr><tr><td>Media introduttivi del percorso</td><td>Il media che ha introdotto il primo partner nel percorso di clic.</td></tr><tr><td>Conteggio media del percorso</td><td>Quanti partner e fonti media erano coinvolti nel percorso di conversione.</td></tr><tr><td>Canali partecipanti del percorso</td><td>Il canale che ha portato qualsiasi partner tra il referral introduttivo e l'ultimo (vincitore).</td></tr><tr><td>Gruppi partecipanti del percorso</td><td>Il gruppo che ha portato qualsiasi partner tra il referral introduttivo e l'ultimo (vincitore).</td></tr><tr><td>Media partecipanti del percorso</td><td>Il media che ha portato qualsiasi partner tra il referral introduttivo e l'ultimo (vincitore).</td></tr><tr><td>Conteggio partner del percorso</td><td>Il numero di partner nel percorso di clic.</td></tr><tr><td>Passaggi del percorso</td><td>Quante attività (ad es. impression) si sono verificate nel percorso di conversione.</td></tr></tbody></table>

</details>

7. Inserisci l' **payout** importo e, se ti viene data l'opzione, specifica **Limiti** sugli articoli pagabili.

   * Se non vedi l' *Limiti* interruttore nel modale, [contatta l'assistenza](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) per richiedere che la funzionalità venga aggiunta al tuo account.

   <div data-with-frame="true"><figure><img src="/files/2e2913ec377ad5e24279a0d3bd33faf6fcef3670" alt="" width="563"><figcaption></figcaption></figure></div>
8. Nell'angolo in basso a destra del modale, seleziona **Aggiungi** per salvare il gruppo di payout.
9. Per creare un altro gruppo di payout, seleziona **Aggiungi nuovo**. Se crei più gruppi, puoi selezionarli e trascinarli per modificarne il rango.

<details>

<summary>Come funziona la classificazione</summary>

I tuoi gruppi di payout vengono valutati dall'alto verso il basso e si applica il primo gruppo le cui condizioni corrispondono alla conversione: tutti i gruppi con rango inferiore vengono ignorati. Inserisci le condizioni più specifiche in alto e quelle più ampie o generiche in basso.

Ad esempio, un gruppo rivolto a **Nuovi clienti con un totale ordine superiore a $200** deve trovarsi sopra un gruppo rivolto a **Nuovi clienti** soltanto. Se il gruppo più ampio ha un rango più alto, corrisponde a ogni ordine di un nuovo cliente prima che la regola più specifica possa essere applicata.

</details>

10. Continua [creando il tuo termine del template](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/create-template-terms.md).

{% hint style="success" %}
**Nota:** Quando configuri un gruppo di payout usando il *URL di referral* parametro, puoi usare il *carattere jolly* per corrispondere nonostante eventuali caratteri precedenti o successivi. Ad esempio, usa `*facebook*` per corrispondere a qualsiasi URL di referral proveniente da Facebook.
{% endhint %}

### Combina i criteri del gruppo di payout

* Le virgole nei criteri del tuo gruppo di payout non combineranno i due criteri (ad es., `La categoria dell'articolo è ACME, Incudini` verrà interpretato come Categoria articolo è ACME O Incudini). Puoi aggirare il problema mettendo le virgolette intorno alla regola che contiene una virgola (`La categoria dell'articolo è "ACME,Incudini"`).

## Gruppi di payout basati sulla posizione

Quando configuri gruppi di payout basati sulla posizione geografica, dovrai scegliere la fonte dati corretta. Puoi distinguere tra il luogo in cui ha avuto origine un clic e il luogo in cui risiede effettivamente il cliente.

| Requisito                                            | Parametro consigliato               | Fonte dati                                                       |
| ---------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------- |
| Gruppo di payout basato sull'indirizzo di spedizione | Paese/Regione del cliente           | Dati trasmessi tramite il tuo pixel di tracciamento al checkout. |
| Gruppo di payout basato sulla posizione del clic     | Paese/Regione derivato dal referral | L'indirizzo IP dell'utente al momento del 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/it/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.