> 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/reach-out-to-partners/partner-management/manage-my-partners.md).
# Gestisci i tuoi partner
Una volta che hai [reclutato partner](/brand/it/what-would-you-like-to-learn-about/performance-program/recruiting-partners.md) per il tuo programma, puoi gestirli dalla *schermata I miei partner* .
{% hint style="warning" %}
Una nuova versione della schermata I miei partner viene distribuita gradualmente. La schermata legacy rimane la visualizzazione predefinita. [Contattaci](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) per ottenere accesso anticipato alla nuova versione.
{% endhint %}
{% tabs %}
{% tab title="Schermata legacy I miei partner" %}
1. Dal menu di navigazione a sinistra, seleziona  **\[Engage] → Partner →** [**Partner**](https://app.impact.com/secure/advertiser/engage/mediapartners/view-mediapartners-flow.ihtml).
* Se hai un programma creator, fai riferimento a [Gestisci i tuoi creator](/brand/it/what-would-you-like-to-learn-about/creator-program/working-with-creators/manage-your-creators.md).
2. Dall'angolo in alto a destra, puoi fare quanto segue:
* Per visualizzare i dati del partner selezionato, seleziona  **\[Icona grafico del report]** nell'angolo in alto a destra. Qui puoi visualizzare il [**report Prestazioni per partner**](/brand/it/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-partner-report.md) , il **impostazioni di tracciamento partner**, oppure l' [**elenco contatti partner**](/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-management/get-partner-contact-information.md#view-all-partners-contact-information).
* Per modificare più partner contemporaneamente, seleziona **Modifica in blocco** e carica il tuo file Excel o CSV. Vedi [Modifica in blocco i partner in un gruppo](/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-groups/bulk-edit-partners-in-a-group.md#bulk-edit-partner-groups) per ulteriori informazioni.
3. Cerca partner usando la barra dei filtri qui sotto *schermata I miei partner*.
* Consulta la *Riferimento filtri* di seguito per ulteriori informazioni.
4. Seleziona  **\[Colonne]** per aggiungere colonne aggiuntive al *schermata I miei partner* .
* Consulta la *riferimento colonne* qui sotto per ulteriori informazioni sulle diverse colonne.
5. Passa il mouse su un partner e seleziona  **\[More]** per eseguire varie azioni per ciascun partner.
* Fai riferimento a *riferimento azioni* qui sotto per vedere cosa puoi fare.
* In alternativa, seleziona il nome di un partner per accedere al pannello laterale del partner. Scopri di più su [informazioni di base](/brand/it/what-would-you-like-to-learn-about/performance-program/recruiting-partners/prospective-partners/view-prospective-partners.md#view-the-partner-s-basic-information-0-0), [proprietà dei media e dettagli](/brand/it/what-would-you-like-to-learn-about/performance-program/recruiting-partners/prospective-partners/view-prospective-partners.md#view-the-partner-s-media-properties-and-details-0-1).
Riferimento filtri
| Filtro | Descrizione |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Barra di ricerca | Filtra i tuoi partner cercando il loro nome, ID partner univoco o URL. |
| Stato del contratto | Filtra i tuoi partner in base al fatto che si trovino in uno *Attivo*, *Scaduto*, oppure *Sospeso* stato della partnership. |
| Gruppi | Filtra i tuoi partner in base al gruppo di partner specifico a cui sono assegnati. |
| Contratto | Filtra i partner in base al tipo di contratto a cui sono iscritti. |
| Aggiornamenti dei termini | Filtra i tuoi partner in base a eventuali aggiornamenti ai loro termini, ad es. partner che hanno *proposte in sospeso*, oppure partner i cui contratti sono *scaduti di recente*. |
| Tipo di rapporto | Filtra i partner che hanno collaborato direttamente con te o che hanno collaborato con te tramite il marketplace. |
| Paese | Filtra i partner in base al paese di provenienza. |
| Stato/Provincia | Filtra i partner in base allo stato o alla provincia di provenienza. |
Riferimento colonne
| Colonna | Descrizione |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Accesso |
Questa colonna fornisce un URL che concede l'accesso temporaneo all'account del partner.
|
| Partner | In questa colonna sono riportati il nome univoco, l'ID e la località del partner. |
| Partner diretto | Mostra un  **\[Controllo]** se un partner è un partner diretto con te, invece di uno che si è iscritto tramite il marketplace. |
| Gruppi | Mostra un elenco di etichette che indicano i diversi gruppi a cui è associato il partner. |
| Contratto | I vari contratti a cui il partner è attualmente iscritto. |
| Data di iscrizione | Mostra la data in cui il partner si è iscritto al tuo programma. |
| Report | Seleziona i  **\[Grafico]** per visualizzare il report sulle prestazioni di un partner specifico. |
riferimento azioni
| Azione | Descrizione |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Note |
Nota: Ti consigliamo di utilizzare il registro attività nel pannello laterale del partner invece di questa azione.
|
| Contratto | Questa azione ti consente di scegliere tra una serie di azioni associate al contratto tra te e il partner. Per saperne di più, consulta i [contratti](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts.md) . |
| Tracciamento | Questa azione ti offre una serie di opzioni relative al tracciamento degli eventi tra te e il partner. Per saperne di più, consulta il [tracciamento](/brand/it/what-would-you-like-to-learn-about/platform-features/tracking/tracking-explained.md) . |
| Integrazione partner | Questa azione ti consente di aiutare i tuoi partner a configurare pixel di tracciamento partner o postback (vedi l'articolo di supporto rivolto ai partner su [postback](/partner/it/di-cosa-vorresti-saperne-di-piu/platform-features/action-management/event-notifications-and-postbacks/introduction-to-postbacks-for-partners.md) per saperne di più) per sincronizzare i dati degli eventi con il sistema del partner. |
| Account manager |
Questa azione ti consente di specificare un account manager per il partner selezionato e rendere disponibili le informazioni di contatto per i partner diretti.
Nota: Ti consigliamo di utilizzare il campo Assegnato a nel pannello laterale del partner invece di questa azione.
|
| Impostazioni dei costi cliente | Questa azione ti consente di abilitare i costi cliente per il partner. Seleziona qui il tipo di costo predefinito e le eccezioni del tracker azioni. |
| Impostazioni di conformità | Questa azione ti consente di personalizzare i programmi di revisione e le tariffe di audit. Puoi modificare la frequenza del programma di revisione di un partner così come la frequenza con cui viene sottoposto ad audit. |
| Gestisci collegamenti account | Questa azione ti consente di supervisionare e regolare le relazioni tra account partner connessi, incluso il motivo e le modalità con cui sono collegati. |
| Messaggio | Questa azione apre la finestra di chat. Dalla finestra di chat puoi inviare un messaggio al partner. |
{% endtab %}
{% tab title="Nuova schermata I miei partner" %}
1. Dal menu di navigazione a sinistra, seleziona  **\[Engage] → Partner →** [**Partner**](https://app.impact.com/secure/advertiser/engage/mediapartners/view-mediapartners-flow.ihtml).
* Se hai un programma creator, fai riferimento a [Gestisci i tuoi creator](/brand/it/what-would-you-like-to-learn-about/creator-program/working-with-creators/manage-your-creators.md).
2. Dall'angolo in alto a destra, puoi fare quanto segue:
* Per visualizzare il [**report Prestazioni per partner**](/brand/it/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-partner-report.md) report, seleziona  **\[Icona grafico del report]** nell'angolo in alto a destra.
* Seleziona  **\[More]** per:
* **Esporta elenco partner.**
* Accedi alle tue **Impostazioni di tracciamento partner.**
* Accedi alla schermata legacy selezionando **Torna alla vecchia interfaccia**. Fai riferimento alla [Schermata legacy I miei partner](#legacy-my-partners-screen) scheda.
3. Cerca partner usando la barra dei filtri qui sotto *schermata I miei partner*.
* Consulta la *Riferimento filtri* di seguito per ulteriori informazioni.
4. Seleziona  **\[Colonne]** per aggiungere colonne aggiuntive al *schermata I miei partner* .
* Consulta la *riferimento colonne* qui sotto per ulteriori informazioni sulle diverse colonne.
5. Per vedere i dati sulle prestazioni di un partner, passa il mouse su un partner e seleziona **Prestazioni**.
1. Da qui puoi monitorare le prestazioni in varie categorie, inclusi tipi di evento, annunci, codici promozionali e tendenze mensili.
6. Passa il mouse su un partner e seleziona  **\[More]** per eseguire varie azioni per ciascun partner.
* Fai riferimento a *riferimento azioni* qui sotto per vedere cosa puoi fare.
* In alternativa, seleziona il nome di un partner per accedere al pannello laterale del partner. Scopri di più su [informazioni di base](/brand/it/what-would-you-like-to-learn-about/performance-program/recruiting-partners/prospective-partners/view-prospective-partners.md#view-the-partner-s-basic-information-0-0), [proprietà dei media e dettagli](/brand/it/what-would-you-like-to-learn-about/performance-program/recruiting-partners/prospective-partners/view-prospective-partners.md#view-the-partner-s-media-properties-and-details-0-1).
7. Per gestire più partner contemporaneamente, vedi la [sezione Gestisci partner in blocco](#partner-groups) qui sotto che descrive in dettaglio le azioni di massa che puoi applicare.
Riferimento filtri
| Filtro | Descrizione |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Barra di ricerca | Filtra i tuoi partner cercando il loro nome, ID partner univoco o URL. |
| Gruppi | Filtra i tuoi partner a un gruppo di partner specifico a cui sono assegnati. |
| Fase del contratto |
Filtra i tuoi partner in base allo stato del loro contratto con te. Puoi filtrare:
Contratti che hai scelto di controproporre, rifiutare o ritirare
Contratti in attesa della tua approvazione, della data di inizio del contratto o dell'approvazione del publisher
Contratti scaduti o in scadenza
Contratti archiviati o annullati
Contratti ai quali i publisher si sono iscritti, hanno controproposto, rifiutato o ritirato
Contratti sostituiti o sospesi
Nota: Nella schermata legacy, questo filtro raggruppava diverse fasi sotto lo Attivo stato. Nella nuova schermata, ogni fase è separata, quindi il conteggio legacy Attivo non corrisponderà al Iscritti conteggio qui.
|
| Contratto | Filtra i partner in base al tipo di contratto a cui sono iscritti. |
| Paese | Filtra i partner in base al paese di provenienza. |
| Dimensione | Filtra i partner in base alla loro [dimensione](/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-management/partner-size-rating-criteria.md#partner-size-scale). |
| Campi personalizzati | Filtra i partner in base alle loro risposte ai [campi personalizzati nei tuoi sondaggi](/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/surveys/create-custom-fields-for-surveys.md). |
| Seleziona  **\[More]** per visualizzare filtri aggiuntivi |
Fase del rapporto:
Filtra i partner in base al loro stato di relazione con te:
Nuovo - Partner che hai contrassegnato come prospect, ma a cui non hai ancora inviato un'email o una proposta.
Contattati tramite messaggio, a condizione che non siano già prospect.
Negoziazione - Partner senza un contratto accettato, inclusi quelli in attesa di una decisione, quelli che non hanno accettato la tua proposta, quelli che hanno controproposto la tua proposta e quelli la cui candidatura hai controproposto.
Iscritti - Partner iscritti al tuo programma.
Scaduto - Partner con contratti scaduti.
Modello di business: Filtra i partner in base al tipo di attività che gestiscono, ad esempio loyalty, email o coupon.
Assegnato a: Filtra i partner in base all'utente dell'account assegnato a gestirli o negoziare con loro.
Fonte di prospecting:
Filtra i partner in base alla fonte da cui sono stati individuati, ad esempio:
Domande: Prospect aggregati da applicazioni esterne. Ciò include sia le candidature dirette sia i partner che hanno fatto domanda tramite il marketplace del brand.
Marketplace: Prospect aggregati dal marketplace dei partner.
Ricerca estesa: Prospect identificati tramite le funzionalità di ricerca estesa.
Impact AI: Prospect aggregati dagli strumenti di Impact AI.
Messaggistica: Prospect aggregati tramite la funzionalità di messaggistica in-app di impact.com.
Consigliato dal personale: Prospect personalizzati per te dal tuo CSM.
Importazione prospect: Prospect importati utilizzando la funzione Importazione prospect.
Ricerca creator: Prospect identificati tramite la funzione Ricerca creator.
Altro: Prospect non aggregati da nessuna delle fonti sopra indicate.
Aree promozionali: Filtra i partner in base alle località in cui si trova il loro pubblico.
|
Riferimento colonne
| Colonna | Descrizione |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Partner | In questa colonna sono riportati il nome univoco, l'ID e la località del partner. |
| Gruppi | Mostra un elenco di etichette che indicano i diversi gruppi a cui è associato il partner. |
| Contratto | I vari contratti a cui il partner è attualmente iscritto. |
| Paese | Il paese in cui si trova il partner. |
| Dimensione | Il partner [dimensione](/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-management/partner-size-rating-criteria.md#partner-size-scale). |
| Email | L'indirizzo email del partner. |
| Data di iscrizione | Mostra la data in cui il partner si è iscritto al tuo programma. |
| Proprietà media | Le proprietà media connesse del partner, come account social media e siti web. |
| Modello di business | Il tipo di attività che il partner gestisce, ad esempio loyalty, email o coupon. |
| Portata social | La presenza social complessiva del partner, basata sul numero di follower su tutte le proprietà social media. |
| Partner diretto | Mostra un  **\[Controllo]** se un partner è un partner diretto con te, invece di uno che si è iscritto tramite il marketplace. |
| Data di candidatura al marketplace | La data della candidatura al marketplace del partner. |
| Paese del pubblico | Dove si trova il pubblico del partner. |
| ID partner | Il numero identificativo impact.com del partner. |
| Assegnato a | L'utente dell'account brand a cui è assegnato il partner. |
| Descrizione | La descrizione del profilo del partner. |
| Aree promozionali | Queste sono le località o i paesi in cui il partner promuove. |
| Nome del contatto | Un elenco di persone di contatto che puoi contattare se desideri inviare un messaggio o proporre un contratto. |
| Indirizzo | L'indirizzo fisico in cui si trova il partner. |
| Autorità del dominio Moz | Mostra quanto è probabile che un sito web si posizioni più in alto nei risultati di ricerca. Più alto è il punteggio, più forte è il potenziale di posizionamento. |
| Categorie | Queste sono le categorie di contenuto del partner, in base alle sue proprietà media negli ultimi 6 mesi. I dati si aggiornano ogni 90 giorni. |
| Fonte di prospecting |
Dove hai trovato originariamente questo partner.
Domande
Prospect aggregati da applicazioni esterne. Ciò include sia le candidature dirette sia i partner che hanno fatto domanda tramite il marketplace del brand.
Prospect identificati tramite la funzione Ricerca creator.
Altro
Prospect non aggregati da nessuna delle fonti sopra indicate.
|
| Campi personalizzati | Le risposte del partner ai campi personalizzati nel tuo sondaggio. Ogni campo personalizzato può essere aggiunto come colonna separata. |
riferimento azioni
| Azione | Descrizione |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Contratto | Questa azione ti consente di scegliere tra una serie di azioni associate al contratto tra te e il partner. Per saperne di più, consulta i [contratti](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts.md) . |
| Tracciamento | Questa azione ti offre una serie di opzioni relative al tracciamento degli eventi tra te e il partner. Per saperne di più, consulta il [tracciamento](/brand/it/what-would-you-like-to-learn-about/platform-features/tracking/tracking-explained.md) . |
| Invita alla mia campagna | Questa azione ti consente di invitare il partner a una campagna specifica. |
| Invita al mio sondaggio | Questa azione ti consente di invitare il partner a un sondaggio specifico. |
| Integrazione partner | Questa azione ti consente di aiutare i tuoi partner a configurare pixel di tracciamento partner o postback (vedi l'articolo di supporto rivolto ai partner su [postback](/partner/it/di-cosa-vorresti-saperne-di-piu/platform-features/action-management/event-notifications-and-postbacks/introduction-to-postbacks-for-partners.md) per saperne di più) per sincronizzare i dati degli eventi con il sistema del partner. |
| Impostazioni dei costi cliente | Questa azione ti consente di abilitare i costi cliente per il partner. Seleziona qui il tipo di costo predefinito e le eccezioni del tracker azioni. |
| Impostazioni di conformità | Questa azione ti consente di personalizzare i programmi di revisione e le tariffe di audit. Puoi modificare la frequenza del programma di revisione di un partner così come la frequenza con cui viene sottoposto ad audit. |
| Account manager |
Questa azione ti consente di specificare un account manager per il partner selezionato e rendere disponibili le informazioni di contatto per i partner diretti.
Nota: Ti consigliamo di utilizzare il campo Assegnato a nel pannello laterale del partner invece di questa azione.
|
| Gestisci collegamenti account | Questa azione ti consente di supervisionare e regolare le relazioni tra account partner connessi, incluso il motivo e le modalità con cui sono collegati. |
| Messaggio | Questa azione apre la finestra di chat. Dalla finestra di chat puoi inviare un messaggio al partner. |
### sezione Gestisci partner in blocco
{% hint style="success" %}
**Nota**: La disponibilità di queste azioni in blocco dipende dalle autorizzazioni dell'account utente.
{% endhint %}
Dalla nuova *schermata I miei partner* schermata, puoi eseguire azioni in blocco su più partner contemporaneamente. Per iniziare un'azione in blocco:
1. Passa il mouse sui partner che desideri modificare e seleziona il  **\[Caselle non selezionate]** accanto ai loro nomi.
* In alternativa, seleziona  **\[Casella non selezionata]** **Seleziona tutto** per apportare modifiche a tutti i tuoi partner.
2. Seleziona l'azione desiderata tra le opzioni disponibili sotto i filtri. Consulta le schede qui sotto per sapere come eseguire l'azione desiderata.
{% tabs %}
{% tab title="Gruppi partner" %}
Cambia i gruppi a cui sono assegnati i tuoi partner.
1. Seleziona **Cambia gruppi \**  **\[Menu a discesa]**. Da questo menu a discesa, esegui una delle seguenti operazioni:
1. Assegna a un gruppo: Seleziona il  **\[Casella non selezionata]** accanto al gruppo desiderato oppure seleziona **Seleziona tutto** per assegnarli a tutti i gruppi.
2. Rimuovi da un gruppo: Deseleziona il  **\[Casella selezionata]** accanto al nome del gruppo, oppure seleziona **Cancella** per rimuoverli da tutti i gruppi.
2. Seleziona **Applica** **→ Conferma**.
{% hint style="success" %}
**Nota**: Gli aggiornamenti potrebbero non essere immediatamente visibili. Attendi alcuni minuti prima di aggiornare il browser.
{% endhint %}
{% endtab %}
{% tab title="Assegna account manager" %}
Assegna in blocco i partner a specifici account manager.
1. Seleziona **Assegnato a** per aprire l'elenco a discesa degli account manager.
2. Scegli l'account manager a cui desideri assegnare i partner.
3. Seleziona **Applica** **→ Conferma**.
{% hint style="success" %}
**Nota**: Gli aggiornamenti potrebbero non essere immediatamente visibili. Attendi alcuni minuti prima di aggiornare il browser.
{% endhint %}
{% endtab %}
{% tab title="Invia email ai partner" %}
Invia email in blocco ai partner.
1. Seleziona **Email**.
2. Compila i dettagli dell'email nella finestra popup.
3. Seleziona **Invia**.
{% endtab %}
{% tab title="Aggiorna contratti" %}
Aggiorna in blocco i contratti dei tuoi partner.
1. Seleziona **Contratto.**
2. Scegli una delle seguenti opzioni:
* **Passa al contratto esistente**
* **Passa al nuovo contratto**
* **Sospendi**
* [**Scade**](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/expire-partner-contracts.md#expire-a-partner-contract)
* [**Modifica impostazioni**](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/revert-a-partner-contract-switch-or-expiry.md)
{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}
---
# 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/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-management/manage-my-partners.md?ask=&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.
