> 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/pt-br/what-would-you-like-to-learn-about/platform-features/cross-channel-performance-insights/optimize-reports/contribution-report.md).

# Relatório de contribuição

<a href="https://pxa.impact.com/student/activity/2860074-micro-top-5-optimize-reports-for-brands?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=opt-351-1&#x26;utm_campaign=help-center" class="button primary">Faça o curso PXA</a>

O relatório de contribuição mostra com que frequência cada parceiro atua como Apresentador (primeiro contato), Conversor (último contato) ou Influenciador (qualquer outro ponto do caminho de conversão). Ele também mostra com que frequência cada parceiro é o único ponto de contato em um caminho de conversão (Solo), com que frequência cada parceiro recebeu crédito pela conversão e todas as ações assistidas em que um parceiro ajudou na ação, mas não recebeu o crédito. Saiba mais sobre [Optimize Essentials e Pro](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/cross-channel-performance-insights/compare-optimize-essentials-and-pro-tiers.md).

#### Gerenciar o relatório de contribuição

{% hint style="warning" %}
This feature is only available with specific impact.com editions or add-ons. If you see the ![](https://1651675991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpVKEIcehMut8QKRmaUZu%2Fuploads%2F5ikfGgRSMOFn089EEFxy%2Foptimize.svg%20\(1\).svg?alt=media\&token=91ff61f9-8618-4503-b0df-791e0353d124) **Optimize** icon, your account is eligible for the upgrade. Select the icon and get the Optimize add-on directly in the platform!
{% endhint %}

1. Na barra de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1e02b2659c94fa0756772cc6c1880977fc9aba73%2F6ad16bf9b7edb0a28ab3574d313014f32392aa7f9508686b63bfacfafc7a9735.svg?alt=media) **\[Optimize] → Valor de participação → Contribuição**.
2. Filtre os dados que você quer visualizar. Selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-3c5971fb7b03a98375488e97a4317afd60621298%2Fd0fbb4c2c189cdc83bc0eb8e906fa3cb66818d0a9daa1491ea48042160714ed2.svg?alt=media) **\[Pesquisar]** quando os filtros desejados estiverem definidos.

{% hint style="success" %}
**Observação:** A opção escolhida no filtro *Medida* altera os dados exibidos na tabela.
{% endhint %}

<details>

<summary>Referência do filtro</summary>

Você pode detalhar seus dados usando os filtros do relatório.

| Filtro                | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Período               | <p>Filtre os dados pela data de criação. É possível consultar dados de, no mínimo, 366 dias.</p><p>Os dados com mais de 2 anos podem ser arquivados periodicamente.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Nível de insights     | <p>Selecione o insight pelo qual você quer analisar os dados do relatório. Alterar esse filtro mudará a forma como os dados são agregados.</p><ul><li><strong>Anúncio:</strong> Veja cada anúncio que gerou dados de contribuição.</li><li><strong>Canal:</strong> Veja como os diferentes canais contribuíram para seu programa, por exemplo, redes sociais orgânicas, afiliados e pesquisa paga.</li><li><strong>Negócio:</strong> Veja uma análise detalhada de como os negócios contribuíram para seu programa.</li><li><strong>Grupo:</strong> Acompanhe como cada grupo (por exemplo, cashback, influenciadores e dispositivos móveis) contribuiu para seu programa.</li><li><strong>Parceiro:</strong> Veja as métricas de participação por parceiro.</li><li><strong>Parceiro e canal:</strong> Veja as métricas de participação de cada parceiro por canal. Esse insight permite comparar parceiros e canais em um único relatório.</li><li><strong>ID compartilhado:</strong> Acompanhe o <em>parceiro/site/influenciador/propriedade</em> individual que participou do seu programa. Saiba como diferenciar seu tráfego usando <a href="https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/dynamically-pay-partners-with-the-shared-id.md">IDs compartilhados</a>.</li></ul> |
| Medida                | Escolha a medida que você quer visualizar na tabela do relatório. Se escolher uma medida percentual (por exemplo, *% da receita*), a tabela exibirá os percentuais com que o nível de insight de uma linha contribuiu. Se escolher uma medida numérica (por exemplo, *Ações*), será exibido o valor numérico real com que o nível de insight de uma linha contribuiu.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Participou            | Escolha os parceiros cujos dados de contribuição você quer visualizar ou selecione **Todos** para ver os dados de contribuição de todos os seus parceiros.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Grupo                 | Selecione os grupos de parceiros cujos dados de contribuição você quer visualizar ou selecione **Todos os parceiros** para ver os dados de contribuição de todos os seus parceiros.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Tipo de evento        | Escolha os tipos de evento cujos dados de contribuição dos parceiros você quer visualizar ou selecione **Todos** para ver os dados de contribuição dos parceiros de todos os tipos de evento.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Participações mínimas | Escolha se quer visualizar **Todos** dados de contribuição ou apenas dados de contribuição para níveis de insight que geraram mais de 10 ações.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

**Mostrar:** Adicione colunas de dados à tabela do seu relatório. Esses pontos de dados serão adicionados à tabela do relatório, abaixo do gráfico, depois que você selecionar ![\[Search\]](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-d9034475259004cc4d724957e37096f4.svg) **\[Search]**.

**Explicação dos pontos de dados**

| Coluna                | Descrição                                                                                                                 |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Etapa única           | Conversões com uma única etapa na jornada do cliente, por exemplo, uma compra direta de um parceiro.                      |
| Várias etapas         | Conversões com várias etapas ao longo da jornada do cliente.                                                              |
| ROAS                  | O valor do retorno sobre o investimento em anúncios por tipo de evento durante o período selecionado.                     |
| Ações assistidas      | Ações assistidas ocorrem quando o parceiro contribuiu para a ação, mas não foi o responsável por ela.                     |
| Custo                 | O custo total de cada parceiro.                                                                                           |
| Valor médio do pedido | <p>O valor médio do pedido associado a um parceiro.</p><p><em>AOV</em> = <em>Receita</em> dividido por <em>Ações</em></p> |

</details>

#### Acessar os dados do relatório

O Relatório de contribuição tem dois componentes: um gráfico de tendências e uma tabela.

{% tabs %}
{% tab title="Gráfico de tendências" %}
O gráfico de tendências permite visualizar como métricas específicas mudaram ao longo do período do relatório.

1. Selecione o menu suspenso no canto superior direito e escolha uma métrica específica.
2. Alterne entre as visualizações de ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ad21568247832cd4fde0238f816f64ea9a3efcd7%2F93d13ab8cd3278467b4a4eee531a47f6c5fef7e1aa9f14937c6d4a8e8c93e01a.svg?alt=media) **\[Trend]**, ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-4f6f33cb850705d4769b40da9c4ada48d898a290%2F50f4c74e39733bfccf223c3de04d29376c8bcf916ae097f134ae6f1c8a252be6.svg?alt=media) **\[Bar]**, e ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b0e79bfaa02eede5ae8956b9af1371edc3a77d52%2Fb7c1c20ba44b256bcfcbff5d442eeaf210edc4313615aa0dd15994c7572910a3.svg?alt=media) **\[Treemap]** selecionando o ícone de visualização.<br>

   <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fy1jJdAw8KVUrd1zBoOgV%2FScreenshot%202026-05-25%20at%2009.53.05.png?alt=media&amp;token=87e55764-fe22-4272-a957-eb97dbee42c2" alt="" width="563"><figcaption></figcaption></figure></div>

{% endtab %}

{% tab title="Tabela de dados" %}
A tabela de dados apresenta uma divisão mais detalhada das contribuições dos seus parceiros. Os valores exibidos na tabela variam conforme o filtro **Medida** esteja definido como uma medida percentual (ou seja, *% Actions* ou *% Revenue*) ou como um filtro de **Número** (ou seja, *Actions* ou *Revenue*).

<details>

<summary>Medida percentual</summary>

| Coluna da tabela                                   | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nível de insight                                   | Cada nível de insight que gerou dados para uma determinada linha. Por exemplo, se você escolheu **Parceiro** para o filtro *Nível de insight* cada linha corresponderia aos diferentes parceiros que geraram dados de contribuição.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p>Participação/</p><p>Receita de participação</p> | <p>O número total de conversões das quais o parceiro participou no intervalo de datas especificado.</p><p>Se você escolheu <strong>% Actions</strong> para a <em>Medida</em> filtro, a quantidade de ações geradas pelo Nível de Insight daquela linha no intervalo de datas selecionado. O cabeçalho da coluna será <em>Participação</em> neste caso.</p><p>Se você escolheu <strong>% de receita</strong> para o seu filtro de <em>Métrica</em> filtro, a receita gerada pelo Nível de Insight daquela linha no intervalo de datas selecionado. O cabeçalho da coluna será <em>Receita de participação</em> neste caso.</p><p>Selecione os números nesta coluna para ver uma lista detalhada de ações para o nível de insight daquela linha.</p> |
| % Introdução                                       | <p>Com que frequência o parceiro gerou o primeiro clique em um caminho de conversão.</p><p>A porcentagem de vezes em que o Nível de Insight daquela linha gerou o primeiro clique no caminho de conversão.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| % Influência                                       | <p>Com que frequência o parceiro gerou um clique diferente do primeiro ou do último em um caminho de conversão.</p><p>A porcentagem de vezes em que o Nível de Insight daquela linha gerou um clique que não foi o primeiro nem o último no caminho de conversão.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| % Fechamento                                       | <p>Com que frequência o parceiro gerou o último clique em um caminho de conversão.</p><p>A porcentagem de vezes em que o Nível de Insight daquela linha gerou o último clique no caminho de conversão.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| % Exclusivo                                        | <p>Com que frequência o parceiro gerou pelo menos um clique em um caminho de conversão sem a participação de nenhum outro parceiro. Um caminho de conversão com vários cliques de um único parceiro ainda é considerado exclusivo, desde que não haja cliques de outro parceiro.</p><p>A porcentagem de vezes em que o Nível de Insight daquela linha gerou um caminho de conversão para o qual nenhum outro Nível de Insight contribuiu. Um caminho de conversão com vários cliques de um único Nível de Insight ainda é considerado exclusivo, desde que não haja cliques de outro Nível de Insight.</p><p>Selecione os números nesta coluna para ver uma lista detalhada de ações para o nível de insight daquela linha.</p>                    |
| % Creditado                                        | <p>Com que frequência o parceiro recebe crédito pelas conversões para as quais contribuiu de alguma forma.</p><p>A porcentagem de vezes em que o Nível de Insight recebe crédito por conversões para as quais contribuiu de alguma forma.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

<div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-38a0157ac72ffd68dc45b6b9951549fc01585046%2F58dbd58190f4c89362f4cae2fdbc8f066e7bddcfd939968c72364a9d743efac9.png?alt=media" alt=""><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Métrica numérica</summary>

| Coluna da tabela                        | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nível de insight                        | Cada nível de insight que gerou dados para uma determinada linha. Por exemplo, se você escolheu **Parceiro** para o filtro *Nível de insight* cada linha corresponderia aos diferentes parceiros que geraram dados de contribuição.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Participação ou Receita de participação | <p>O número total de conversões das quais o parceiro participou no intervalo de datas especificado.</p><p>Se você escolheu <strong>Ações</strong> para o seu filtro de <em>Métrica</em> filtro, a quantidade de ações geradas pelo Nível de Insight daquela linha no intervalo de dados selecionado. O cabeçalho da coluna será <em>Participação</em> neste caso, e todos os dados da tabela mostrarão o número real de contribuições (por exemplo, o número real de vezes em que um parceiro foi o responsável pelo último clique no caminho de conversão).</p><p>Se você escolheu <strong>Receita</strong> para o seu filtro de <em>Métrica</em> filtro, a receita gerada pelo Nível de Insight daquela linha no intervalo de datas selecionado. O cabeçalho da coluna será <em>Receita de participação</em> neste caso, e todos os dados da tabela mostrarão os valores de receita gerados pelas contribuições (por exemplo, a receita gerada quando um parceiro foi o responsável pelo último clique no caminho de conversão).</p><p>Selecione os números nesta coluna para ver uma lista detalhada de ações para o nível de insight daquela linha.</p> |
| Introdução / Receita de introdução      | <p>Com que frequência o parceiro gerou o primeiro clique em um caminho de conversão.</p><p>Se estiver usando a métrica <em>Ações</em> o número de vezes que o Nível de Insight daquela linha gerou o primeiro clique no caminho de conversão.</p><p>Se estiver usando a métrica <em>Receita</em> a receita gerada quando o Nível de Insight daquela linha gerou o primeiro clique no caminho de conversão.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Influência / Receita de influência      | <p>Com que frequência o parceiro gerou um clique diferente do primeiro ou do último em um caminho de conversão.</p><p>Se estiver usando a métrica <em>Ações</em> , o número de vezes que o nível de insight dessa linha gerou um clique que não foi o primeiro nem o último no caminho de conversão.</p><p>Se estiver usando a métrica <em>Receita</em> , a receita gerada quando o nível de insight dessa linha gerou um clique que não foi o primeiro nem o último no caminho de conversão.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Fechamento / Receita de fechamento      | <p>Com que frequência o parceiro gerou o último clique em um caminho de conversão.</p><p>Se estiver usando a métrica <em>Ações</em> , o número de vezes que o nível de insight dessa linha gerou o último clique no caminho de conversão.</p><p>Se estiver usando a métrica <em>Receita</em> , a receita gerada quando o nível de insight dessa linha gerou o último clique no caminho de conversão.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Exclusivo / Receita exclusiva           | <p>Com que frequência o parceiro gerou pelo menos um clique em um caminho de conversão sem a participação de nenhum outro parceiro. Um caminho de conversão com vários cliques de um único parceiro ainda é considerado exclusivo, desde que não haja cliques de outro parceiro.</p><p>Se estiver usando a métrica <em>Ações</em> , o número de vezes que o nível de insight dessa linha gerou um caminho de conversão para o qual nenhum outro nível de insight contribuiu. Um caminho de conversão com vários cliques de um único nível de insight ainda conta como Exclusivo, desde que não haja cliques de outro nível de insight.</p><p>Se estiver usando a métrica <em>Receita</em> , a receita gerada quando o nível de insight dessa linha gerou um caminho de conversão para o qual nenhum outro nível de insight contribuiu. Um caminho de conversão com vários cliques de um único nível de insight ainda conta como Exclusivo, desde que não haja cliques de outro nível de insight.</p><p>Selecione os números nesta coluna para ver uma lista detalhada de ações para o nível de insight daquela linha.</p>                                   |
| Atribuído / Receita atribuída           | <p>Com que frequência o parceiro recebe crédito pelas conversões para as quais contribuiu de alguma forma.</p><p>Se estiver usando a métrica <em>Ações</em> , o número de vezes que o nível de insight recebe crédito pelas conversões para as quais contribuiu de alguma forma.</p><p>Se estiver usando a métrica <em>Receita</em> , a receita gerada quando o nível de insight recebe crédito pelas conversões para as quais contribuiu de alguma forma.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

<div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-683b3605817005898f2cdde08027c626f125f926%2Fd80a7502bf53604b7be631af5f1d59be5a3a8ef18a33496a61f2eb70f4850f5f.png?alt=media" alt=""><figcaption></figcaption></figure></div>

</details>
{% endtab %}
{% endtabs %}

#### Por que o Relatório de contribuição é útil?

Ao detalhar as conversões das quais cada parceiro participou como **Iniciador**, **Influenciador**, e **Finalizador**, este relatório mostra com que frequência o parceiro contribui com valor em cada etapa do funil. A coluna mais à direita, **Atribuído**, mostra com que frequência esse parceiro é remunerado por uma conversão para a qual contribuiu. Em conjunto, esses dados permitem ver se os parceiros estão sendo remunerados proporcionalmente ao valor real que geram.

Por exemplo, se o *Parceiro A* está em um contrato de último clique, mas atua como **Iniciador** em 70% das vezes, provavelmente recebe muito pouco em relação ao valor real que gera. Por outro lado, se o *Parceiro B* (também em um contrato de último clique) geralmente atua como **Finalizador**, provavelmente recebe remuneração por quase todo o valor que gera.

<div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FBV6HvgmZnelRb8oHDQmM%2FScreenshot%202026-05-25%20at%2010.10.38.png?alt=media&amp;token=7e68abc1-dc01-48e7-b959-47d56410f3b6" alt="" width="563"><figcaption></figcaption></figure></div>

Para colocar esse insight em prática, você pode configurar um bônus por participação para o *Parceiro A*, que o recompensará por qualquer conversão para a qual contribua, mesmo que não gere o último clique. Se quiser evitar aumentar o pagamento total, você pode adicionar um ajuste de pagamento ao contrato para reduzir o pagamento pelo valor do bônus por participação sempre que ele for pago. Para saber mais sobre bônus por participação e ajustes de pagamento, consulte [Criar termos de modelo](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/create-template-terms.md) ou fale com seu CSM.

{% hint style="success" %}
**Lembre-se:** Cada conversão só pode ser atribuída uma vez. Portanto, se o Parceiro A, em um Contrato de primeiro clique, receber o primeiro clique, e o Parceiro B, em um Contrato de último clique, receber o último clique, o vencedor será determinado de acordo com o método de atribuição preferencial que você definiu: primeiro ou último clique.
{% endhint %}


---

# 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/pt-br/what-would-you-like-to-learn-about/platform-features/cross-channel-performance-insights/optimize-reports/contribution-report.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.
