> 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 Iniciador (primeiro toque), Fechador (último toque) ou Influenciador (qualquer outro ponto no caminho de conversão). Ele também mostra com que frequência cada Parceiro fornece 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 nas quais um Parceiro auxiliou a ação, mas não foi o vencedor. Saiba mais sobre [Optimize Essentials e Pro](/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" %}
Este recurso está disponível apenas em edições ou complementos específicos do impact.com. Se você vir o ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F8bqCvTj35m0v4w2fMoV7%2Foptimize.svg%20\(1\).svg?alt=media\&token=3b8a53da-1dd9-42a7-99eb-767be6fa7da7) **Optimize** ícone, sua conta é elegível para a atualização. Selecione o ícone e obtenha o complemento Optimize diretamente na plataforma!
{% 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) **\[Otimizar] → Valor de Participação → Contribuição**.
2. Filtre os dados que você deseja 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 aplicados.

{% hint style="success" %}
**Observação:** Sua escolha para o *Medida* o filtro alterará quais dados são apresentados na tabela de dados.
{% endhint %}

<details>

<summary>Referência de filtros</summary>

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

| Filtro                | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Intervalo de datas    | <p>Filtre os dados pela data de criação. Você pode extrair um mínimo de 366 dias de dados.</p><p>Dados com mais de 2 anos podem ser arquivados periodicamente.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Nível de insights     | <p>Selecione por qual insight você quer analisar os dados no relatório. Alterar esse filtro mudará 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 o quanto os diferentes canais contribuíram para o seu programa, por exemplo, Social Orgânico vs. Afiliado vs. Pesquisa Paga.</li><li><strong>Negócio:</strong> Veja uma análise de como os negócios contribuíram para o seu programa.</li><li><strong>Grupo:</strong> Acompanhe como cada grupo (por exemplo, Cashback, Influenciadores, Mobile) contribuiu para o seu programa.</li><li><strong>Parceiro:</strong> Veja 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. Este insight permite comparar parceiros e canais em um único relatório.</li><li><strong>ID Compartilhado:</strong> Acompanhe o <em>individual</em> parceiro/site/influenciador/propriedade que participou do seu programa. Saiba como diferenciar seu tráfego usando <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/dynamically-pay-partners-with-the-shared-id">IDs Compartilhados</a>.</li></ul> |
| Medida                | Escolha qual métrica você deseja visualizar na tabela do relatório. Escolher uma métrica percentual (por exemplo, *% de receita*) preencherá a tabela com os valores percentuais aos quais o nível de insight de uma linha contribuiu. Escolher uma métrica numérica (por exemplo, *Ações*) mostrará a quantidade numérica real com que o nível de insight de uma linha contribuiu.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Participou            | Escolha o(s) parceiro(s) para os quais você deseja visualizar os dados de contribuição ou selecione **Todos** para visualizar os dados de contribuição de todos os seus parceiros.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Grupo                 | Selecione o(s) grupo(s) de parceiros para os quais você deseja visualizar os dados de contribuição ou selecione **Todos os parceiros** para visualizar os dados de contribuição de todos os seus parceiros.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Tipo de evento        | Escolha o(s) tipo(s) de evento para os quais você deseja visualizar os dados de contribuição do parceiro ou selecione **Todos** para visualizar os dados de contribuição do parceiro para todos os seus tipos de evento.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Participações mínimas | Escolha se você quer ver **Todos** dados de contribuição ou apenas dados de contribuição para níveis de insight que geraram mais de 10 ações.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

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

**Pontos de dados explicados**

| Coluna           | Descrição                                                                                                                 |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Etapa única      | Conversões com uma única etapa na jornada do cliente, por exemplo, uma compra direta de um parceiro.                      |
| Múltiplas Etapas | Conversões com várias etapas ao longo da jornada do cliente.                                                              |
| ROAS             | O valor do retorno sobre o gasto com anúncios por tipo de evento no período selecionado.                                  |
| Ações Assistidas | Ações Assistidas ocorrem quando o parceiro auxiliou a ação, mas não “venceu” a ação.                                      |
| Custo            | O custo total de cada parceiro.                                                                                           |
| AOV              | <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ência e uma tabela.

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

1. Selecione o menu suspenso no canto superior direito e escolha uma métrica específica.
2. Alterne entre as ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ad21568247832cd4fde0238f816f64ea9a3efcd7%2F93d13ab8cd3278467b4a4eee531a47f6c5fef7e1aa9f14937c6d4a8e8c93e01a.svg?alt=media) **\[Tendência]**, ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-4f6f33cb850705d4769b40da9c4ada48d898a290%2F50f4c74e39733bfccf223c3de04d29376c8bcf916ae097f134ae6f1c8a252be6.svg?alt=media) **\[Barras]**, 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) **\[Mapa de árvore]** visualizações 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 mostra uma análise mais detalhada das contribuições dos seus parceiros. Os valores apresentados na tabela variarão dependendo se o **Medida** filtro estiver definido como uma métrica percentual (ou seja, *% Ações* ou *% de receita*) ou um **Número** filtro (ou seja, *Ações* ou *Receita*).

<details>

<summary>Métrica 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 seu *Nível de insight* filtro, cada linha seria os vários parceiros que geraram dados de contribuição.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p>Participar/</p><p>Participar Receita</p> | <p>Quantas conversões totais o Parceiro participou, para o intervalo de datas especificado.</p><p>Se você escolheu <strong>% Ações</strong> para seu <em>Medida</em> filtro, a quantidade de ações que o Nível de Insight para essa linha gerou no intervalo de datas selecionado. O cabeçalho da coluna será <em>Participar</em> neste caso.</p><p>Se você escolheu <strong>% de receita</strong> para seu <em>Medida</em> filtro, a quantidade de receita que o Nível de Insight para essa linha gerou no intervalo de datas selecionado. O cabeçalho da coluna será <em>Participar Receita</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 dessa linha.</p> |
| % Primeiro toque                            | <p>Com que frequência o Parceiro gerou o primeiro clique em um caminho de conversão.</p><p>A porcentagem de vezes que o Nível de Insight para essa linha gerou o primeiro clique no caminho de conversão.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| % Influência                                | <p>Com que frequência o Parceiro gerou um clique que não fosse o primeiro ou o último em um caminho de conversão.</p><p>A porcentagem de vezes que o Nível de Insight para essa linha gerou qualquer clique, exceto o primeiro ou o último clique no caminho de conversão.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| % Último toque                              | <p>Com que frequência o Parceiro gerou o último clique em um caminho de conversão.</p><p>A porcentagem de vezes que o Nível de Insight para essa linha gerou o último clique no caminho de conversão.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| % Solo                                      | <p>Com que frequência o Parceiro gerou pelo menos um clique em um caminho de conversão que não incluía nenhum outro Parceiro. Um caminho de conversão com vários cliques de um Parceiro ainda conta como Solo, desde que não haja cliques de outro Parceiro.</p><p>A porcentagem de vezes que o Nível de Insight para essa linha gerou um caminho de conversão no qual nenhum outro Nível de Insight contribuiu. Um caminho de conversão com vários cliques de um Nível de Insight ainda conta como Solo, 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 dessa linha.</p>                                                |
| % Creditado                                 | <p>Com que frequência o Parceiro recebe crédito pelas conversões para as quais contribuiu de qualquer forma.</p><p>A porcentagem de vezes que o Nível de Insight recebe crédito pela conversão para a qual contribuiu de qualquer 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 seu *Nível de insight* filtro, cada linha seria os vários parceiros que geraram dados de contribuição.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Participar ou Participar Receita           | <p>Quantas conversões totais o Parceiro participou, para o intervalo de datas especificado.</p><p>Se você escolheu <strong>Ações</strong> para seu <em>Medida</em> filtro, a quantidade de ações que o Nível de Insight para essa linha gerou no intervalo de datas selecionado. O cabeçalho da coluna será <em>Participar</em> neste caso, e todos os dados da tabela mostrarão a quantidade real de contribuições (por exemplo, o número real de vezes em que um parceiro foi o Fechador no caminho de conversão).</p><p>Se você escolheu <strong>Receita</strong> para seu <em>Medida</em> filtro, a quantidade de receita que o Nível de Insight para essa linha gerou no intervalo de datas selecionado. O cabeçalho da coluna será <em>Participar Receita</em> neste caso, e todos os dados da tabela mostrarão os valores de receita gerados pelas contribuições (por exemplo, a receita gerada por um parceiro ser o Fechador 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 dessa linha.</p> |
| Primeiro toque / Receita de primeiro toque | <p>Com que frequência o Parceiro gerou o primeiro clique em um caminho de conversão.</p><p>Se estiver usando a <em>Ações</em> métrica, a quantidade de vezes que o Nível de Insight para essa linha gerou o primeiro clique no caminho de conversão.</p><p>Se estiver usando a <em>Receita</em> métrica, a receita gerada quando o Nível de Insight para essa 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 que não fosse o primeiro ou o último em um caminho de conversão.</p><p>Se estiver usando a <em>Ações</em> métrica, a quantidade de vezes que o Nível de Insight para essa linha gerou qualquer clique diferente dos primeiros ou últimos cliques no caminho de conversão.</p><p>Se estiver usando a <em>Receita</em> métrica, a receita gerada quando o Nível de Insight para essa linha gerou qualquer clique diferente dos primeiros ou últimos cliques no caminho de conversão.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Último toque / Receita de último toque     | <p>Com que frequência o Parceiro gerou o último clique em um caminho de conversão.</p><p>Se estiver usando a <em>Ações</em> métrica, a quantidade de vezes que o Nível de Insight para essa linha gerou o último clique no caminho de conversão.</p><p>Se estiver usando a <em>Receita</em> métrica, a receita gerada quando o Nível de Insight para essa linha gerou o último clique no caminho de conversão.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Solo / Receita Solo                        | <p>Com que frequência o Parceiro gerou pelo menos um clique em um caminho de conversão que não incluía nenhum outro Parceiro. Um caminho de conversão com vários cliques de um Parceiro ainda conta como Solo, desde que não haja cliques de outro Parceiro.</p><p>Se estiver usando a <em>Ações</em> métrica, a quantidade de vezes que o Nível de Insight para essa linha gerou um caminho de conversão no qual nenhum outro Nível de Insight contribuiu. Um caminho de conversão com vários cliques de um Nível de Insight ainda conta como Solo, desde que não haja cliques de outro Nível de Insight.</p><p>Se estiver usando a <em>Receita</em> métrica, a receita gerada quando o Nível de Insight para essa linha gerou um caminho de conversão no qual nenhum outro Nível de Insight contribuiu. Um caminho de conversão com vários cliques de um Nível de Insight ainda conta como Solo, 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 dessa linha.</p>        |
| Creditado / Receita creditada              | <p>Com que frequência o Parceiro recebe crédito pelas conversões para as quais contribuiu de qualquer forma.</p><p>Se estiver usando a <em>Ações</em> métrica, a quantidade de vezes que o Nível de Insight recebe crédito pelas conversões para as quais contribuiu de qualquer forma.</p><p>Se estiver usando a <em>Receita</em> métrica, a receita gerada quando o Nível de Insight recebe crédito pelas conversões para as quais contribuiu de qualquer 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 nas quais cada Parceiro participou em **Iniciador**, **Influenciador**, e **Fechador**, este relatório mostra com que frequência o Parceiro agrega valor em cada ponto do funil. A coluna mais à direita, **Creditado**, mostra com que frequência esse Parceiro é pago por uma conversão para a qual contribuiu. Em conjunto, esses pontos de dados permitem ver se os Parceiros estão sendo compensados proporcionalmente ao valor real que geram.

Por exemplo, se *Parceiro A* está em um Contrato de último clique, mas atua como um **Iniciador** 70% do tempo, é provável que esteja recebendo muito pouco em relação ao valor real que produz. Por outro lado, se *Parceiro B* (também em um Contrato de último clique) geralmente atua como um **Fechador**, é provável que esteja recebendo pagamento por quase todo o valor que produz.

<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 agir com base nesse insight, você pode optar por configurar um bônus de participação para *Parceiro A*, que o recompensará por qualquer conversão para a qual contribuir, mesmo que não obtenha o último clique. Se você quiser evitar aumentar seu pagamento total, poderá então adicionar um ajuste de pagamento em seu Contrato para reduzir o pagamento pelo valor do bônus de participação sempre que esse bônus for pago. Para saber mais sobre bônus de participação e ajustes de pagamento, você pode consultar [Criar termos do modelo](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/create-template-terms.md) ou perguntar ao seu CSM.

{% hint style="success" %}
**Lembre-se:** Cada conversão só pode ser creditada uma vez; então, se o Parceiro A em um Contrato de primeiro clique obtiver o primeiro clique e o Parceiro B em um Contrato de último clique obtiver o último clique, o vencedor será determinado com base em se você definiu o primeiro ou o último clique como seu método de creditamento preferido.
{% 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 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/pt-br/what-would-you-like-to-learn-about/platform-features/cross-channel-performance-insights/optimize-reports/contribution-report.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.
