> 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/partner/es/sobre-que-te-gustaria-aprender/platform-features/reporting-for-partners/partner-benchmarking.md).

# Comparativa de partners

En el benchmarking de partners, evalúas tu rendimiento como partner con una marca en comparación con la productividad del resto del segmento de partners con la misma marca. Este artículo te enseña a leer las diferentes secciones de *Benchmark de partners* pantalla y, en consecuencia, obtener información sobre cómo se comparan tus Indicadores Clave de Rendimiento (KPI) con los de otros partners del mismo segmento competitivo.

## Accede a la pantalla de Partner Benchmark

{% hint style="success" %}
Esta función solo está disponible en ciertas ediciones o complementos de impact.com. [Contáctanos](https://app.impact.com/support/portal.ihtml?createTicket=true) para actualizar tu cuenta y obtener acceso!
{% endhint %}

1. Desde la barra de navegación superior, selecciona **Informes** → **Benchmark**.
2. Desde la barra de filtros cerca de la parte superior de tu *Benchmark de partners* pantalla:
   * Selecciona la **Trimestre** para el que deseas ver datos de referencia.
   * Selecciona la **Región** para el que deseas ver datos de referencia.
   * Opcionalmente, **descargar** los informes de benchmark en formato CSV o PDF usando el ![](https://4119967529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-5a85ab28098ee50ab9b071bbdbbffa24d4fab327%2Fdfc9e3774c247872fad291a1838ba2a1d55d0007aae4628c1932e8e5a21fbf7a.svg?alt=media) **\[Descargar]** botón en la esquina superior derecha de la pantalla.

<details>

<summary>Resumen del segmento</summary>

El *Resumen del segmento* te muestra cuántos partners, marcas y segmentos de marca hay en tu segmento de partners. Esto te ofrece una base con la que puedes comparar tus propias colaboraciones.

<div data-with-frame="true"><figure><img src="https://4119967529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-17a3571b5232d071628cbdaba44a348351ba2d83%2F092568362256d9854cf57c8dd25dd318e722e34e60bebdf3624897b3e1076e81.png?alt=media" alt=""><figcaption></figcaption></figure></div>

| Métrica                    | Descripción                                                                 |
| -------------------------- | --------------------------------------------------------------------------- |
| Partners totales           | La cantidad de partners en tu segmento de partners.                         |
| Marcas totales             | La cantidad de marcas en tu segmento de partners que han generado acciones. |
| Segmentos de marca totales | La cantidad de segmentos de marca definidos por impact.com.                 |

</details>

<details>

<summary>Tu resumen</summary>

*Tu resumen* te muestra métricas sobre los pagos que has ganado y la cantidad de marcas con las que estás asociado. Esto puede ayudarte a identificar tu principal fuente de ingresos y, en consecuencia, tomar decisiones sobre nuevas colaboraciones.

<div data-with-frame="true"><figure><img src="https://4119967529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-91d1033c97421b0ccce986e08deb5527a3adb105%2Ffb0a17c925979bddbe0527bf91778918a7732556bcdc26a03ce377851fbe4d36.png?alt=media" alt=""><figcaption></figcaption></figure></div>

| Métrica                                   | Descripción                                                                                                |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Ganancias por acción                      | La cantidad de dinero en ingresos basados en acciones que has ganado.                                      |
| Ingresos no basados en acciones           | La cantidad de dinero en ingresos que has ganado y que no se basaron en acciones generadas.                |
| Tu rango de participación                 | Tu posición en un grupo de partners con acciones compartidas.                                              |
| Tu participación en ingresos por acciones | Tu porcentaje de ingresos compartidos frente al grupo del que formas parte.                                |
| Tu participación en ingresos              | Tu porcentaje de ingresos compartidos frente al grupo del que formas parte.                                |
| Tus marcas                                | La cantidad de marcas con las que estás asociado.                                                          |
| Tus segmentos de marca                    | La cantidad de segmentos de marca a los que pertenecen tus marcas asociadas.                               |
| Marcas para unirse                        | La cantidad de marcas con las que no trabajas que tienen potencial de comisión en tu segmento de partners. |

</details>

<details>

<summary>Mi rendimiento</summary>

*Mi rendimiento* te permite comparar los rankings de pago de tus marcas con sus rankings para otros partners de tu segmento competitivo. Si tu posición para una marca es considerablemente más baja que la del segmento, esto indica que otros partners de tu sector suelen obtener más de la marca que tú.

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

| Columna                            | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nombre de la marca                 | <p>El nombre de la marca.</p><p>• Selecciona el <strong>nombre de la marca</strong> para ver su perfil de Marketplace.</p><p>• Desde aquí puedes <a href="/partner/es/sobre-que-te-gustaria-aprender/platform-features/working-with-brands/contacting-a-brand/access-brand-contact-information.md">contacta con ellos</a> (si tienes una colaboración con ellos) o <a href="/partner/es/sobre-que-te-gustaria-aprender/platform-features/working-with-brands/applying-to-brands/find-and-apply-to-brands.md">solicitar trabajar con ellos</a>.</p> |
| Rango de marca por tipo de partner | Las principales marcas de tu segmento de partners, clasificadas por pagos basados en acciones.                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Tu rango                           | <p>Tu clasificación de la marca en comparación con las otras marcas con las que estás asociado. La clasificación se basa en el pago de la marca por acciones generadas durante el trimestre seleccionado.</p><p>• NaN (No es un número) significa que no hay clasificación para el trimestre elegido.</p>                                                                                                                                                                                                                                          |
| Diferencia de rango                | <p>Esto indica la diferencia entre la clasificación general de la marca en el segmento de partners y tu clasificación de la marca. Un número positivo grande indicaría que estás obteniendo más de tu colaboración que la mayoría de los otros partners, mientras que un número negativo grande indicaría que no estás aprovechando al máximo esta colaboración.</p><p>• Diferencia de rango = Rango del segmento de partners - Tu rango</p>                                                                                                       |

</details>

<details>

<summary>Rendimiento por marca</summary>

*Rendimiento por marca* te muestra tus marcas con mejor rendimiento durante el trimestre seleccionado, cuántas acciones has generado para cada marca y qué ingresos has acumulado al hacerlo. Esto puede darte una idea de cuáles son tus colaboraciones más productivas.

<div data-with-frame="true"><figure><img src="https://4119967529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-71e5ba9f7f3ab6ca02fc74c5b6b768de7211bfb8%2F236682a70a6c6fa789e1c32d03d4b97c8737b59da2dc2c79ddce2f76f21517a4.png?alt=media" alt=""><figcaption></figcaption></figure></div>

| Columna                            | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nombre de la marca                 | <p>El nombre de la marca.</p><p>• Selecciona el nombre de la marca para ver su perfil de Marketplace.</p><p>• Desde aquí puedes <a href="/partner/es/sobre-que-te-gustaria-aprender/platform-features/working-with-brands/contacting-a-brand/access-brand-contact-information.md">contacta con ellos</a>.</p>                                                                                                                                |
| Segmento de marca                  | Esta es la categoría del sector a la que pertenece la marca.                                                                                                                                                                                                                                                                                                                                                                                 |
| Tu rango                           | Tu clasificación de la marca en comparación con las otras marcas con las que estás asociado. La clasificación se basa en el pago de la marca por acciones generadas durante el trimestre seleccionado.                                                                                                                                                                                                                                       |
| Rango de marca por tipo de partner | La clasificación de la marca en el segmento de partners en su conjunto, basada en sus pagos por acciones.                                                                                                                                                                                                                                                                                                                                    |
| Diferencia de rango                | <p>Esto indica la diferencia entre la clasificación general de la marca en el segmento de partners y tu clasificación de la marca. Un número positivo grande indicaría que estás obteniendo más de tu colaboración que la mayoría de los otros partners, mientras que un número negativo grande indicaría que no estás aprovechando al máximo esta colaboración.</p><p>• Diferencia de rango = Rango del segmento de partners - Tu rango</p> |
| Clics                              | El número total de clics en enlaces que dirigieron a tu audiencia a la página de destino de la marca durante el trimestre seleccionado.                                                                                                                                                                                                                                                                                                      |
| Acciones                           | El número total de conversiones (ventas, instalaciones de aplicaciones, etc.) que generaste para la marca durante el trimestre seleccionado.                                                                                                                                                                                                                                                                                                 |
| Ganancias por acción               | Los pagos totales que ganaste por generar acciones para la marca durante el trimestre seleccionado.                                                                                                                                                                                                                                                                                                                                          |
| Ingresos no basados en acciones    | Los pagos totales que recibiste de la marca y que no provinieron de generar acciones durante el trimestre seleccionado.                                                                                                                                                                                                                                                                                                                      |
| Importe de ventas                  | El total de ventas de la marca generadas por ti.                                                                                                                                                                                                                                                                                                                                                                                             |

</details>

<details>

<summary>Relaciones productivas por segmento de marca</summary>

Esta sección te permite comparar los KPI en cada categoría de marca, incluyendo *Activa* y *Tasas productivas*.

**Tus marcas vs. Todas las marcas que usan Partner con el mismo modelo de negocio**

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

| Columna                  | Descripción                                                                                                                                                                                      |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Segmento de marca        | Esta es la categoría del sector a la que pertenece la marca.                                                                                                                                     |
| Marcas unidas a partners | El número de marcas que están vinculadas al segmento de partners (en este ejemplo, muestra el número de marcas de una categoría concreta que tienen colaboraciones con partners de tu segmento). |
| Asociadas contigo        | El número de marcas en el segmento de partners con las que estás vinculado.                                                                                                                      |
| No asociadas contigo     | El número de marcas en el segmento de partners con las que no estás vinculado.                                                                                                                   |

**Tasas por segmento**

<div data-with-frame="true"><figure><img src="https://4119967529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-3820ef81e6d602dbd3cfd8bb4c6044e579321c39%2F9df1046498e7bd78929969748c6799586c2adfdcaf407f21e906be50307752bf.png?alt=media" alt=""><figcaption></figcaption></figure></div>

* *Tasas activas por segmento de marca* compara el porcentaje de marcas de una categoría para las que generaste clics, en comparación con el segmento. Esto ayuda a evaluar tu capacidad para generar clics por categoría en comparación con tu competencia.
* *Tasas productivas por segmento de marca* compara el porcentaje de marcas de una categoría para las que generaste conversiones, en comparación con el segmento. Esto ayuda a evaluar tu capacidad para generar conversiones por categoría en comparación con tu competencia.

</details>

### Análisis de rendimiento por segmento de marca

El *Análisis de rendimiento por categoría de marca* los informes te muestran cómo han rendido tus marcas asociadas en sus segmentos de marca durante un trimestre seleccionado. Puedes comparar el rendimiento de tus distintas marcas en términos de Valor Medio del Pedido (AOV) y Tasa de Conversión (CR).

<details>

<summary>Tu AOV vs. el AOV del segmento de partners</summary>

Compara el valor medio del pedido (AOV) generado por tu audiencia con el de otros partners de tu segmento de partners durante el trimestre seleccionado. Consulta cómo varían estos valores entre categorías de marca, cómo influyen en tus métricas los tipos de productos que promocionas y cómo el tamaño de los pedidos que generas por categoría se compara con el de tus competidores.

<div data-with-frame="true"><figure><img src="https://4119967529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-84f3d06c5bf3cce4821c2a9e14db8028b8f3509e%2F83b1290fb149f66fc8006f952cfd5ddcaa384e0e23f659599b186be71a22f595.png?alt=media" alt=""><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Tu tasa de conversión vs. el segmento de partners</summary>

Compara la tasa de conversión de tu audiencia con la de otros partners de tu segmento de partners durante el trimestre seleccionado. Consulta cómo varían estos valores entre categorías de marca e identifica si eres mejor convirtiendo clics por categoría en comparación con tu competencia.

<div data-with-frame="true"><figure><img src="https://4119967529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-0c2a9b43c1e72e721b41c513ccabd606b45a20f9%2Fae0b5beca6836dddaedba763fa1ffeb8dfb6c050ce06bae8c12d0ebc5cd1c284.png?alt=media" alt=""><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Análisis de rendimiento por segmento de marca</summary>

Este informe te permite comparar tu rendimiento con el de otros partners de tu segmento de partners durante el trimestre seleccionado. Puedes ordenar las columnas de esta tabla para ayudarte a identificar en qué destacas frente a tu competencia y en qué segmentos puedes mejorar.

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

</details>

<details>

<summary>Referencia de la tabla de análisis de rendimiento</summary>

| Columna                                   | Descripción                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Segmento de marca                         | El nombre del segmento que está bajo consideración.                                                                                                                                                                                                                                                                                                                         |
| Tu AOV                                    | <p>El valor medio del pedido generado por tu audiencia. Se calcula como los ingresos generados divididos por el número de conversiones (también conocidas como acciones):</p><p>• AOV = Ingresos / # de acciones</p>                                                                                                                                                        |
| AOV del segmento de partners              | El valor medio del pedido de otros partners en tu segmento de partners.                                                                                                                                                                                                                                                                                                     |
| Índice AOV                                | <p>Un índice superior a 120 indica un sobreíndice en AOV. Esto puede darse cuando un programa vende artículos más caros que el segmento. Un índice inferior a 80 indica un subíndice en AOV. Esto puede darse cuando un programa vende artículos más baratos que el segmento:</p><p>• Índice AOV = Tu AOV / AOV del segmento de partners</p>                                |
| Tu CR                                     | <p>Tu tasa de conversión representa el porcentaje de clics en enlaces que generas y que resultan en conversiones (también llamadas acciones). Se calcula como el número de conversiones generadas dividido por el número de clics únicos:</p><p>• CR = # de acciones / # de clics</p>                                                                                       |
| CR del segmento de partners               | <p>La tasa de conversión del segmento de partners representa el porcentaje medio de clics en enlaces que resultan en conversiones (también llamadas acciones) para otros partners de tu segmento. Se calcula como el número de conversiones generadas del segmento dividido por el número de clics únicos:</p><p>• # de acciones del segmento / # de clics del segmento</p> |
| Índice CR                                 | <p>Un índice superior a 120 indica que eres mejor convirtiendo clics en ventas para este segmento de marca que tu competencia. Un índice inferior a 80 indica lo contrario:</p><p>• Índice CR = Tu CR / CR del segmento de partners</p>                                                                                                                                     |
| Tu EPA                                    | Tus ingresos por acción representan el valor monetario medio que has ganado al generar conversiones en el segmento de marca.                                                                                                                                                                                                                                                |
| EPA del segmento de partners              | Los ingresos por acción del segmento de partners representan el valor monetario medio ganado por todos los partners con el mismo modelo de negocio que tú al generar conversiones en el segmento de marca.                                                                                                                                                                  |
| Índice EPA                                | <p>Un índice superior a 120 indica un sobreíndice en EPA. Esto podría verse influido por que un programa venda artículos más caros que el segmento de marca o por comisiones más altas. Un índice inferior a 80 indica un subíndice en EPA:</p><p>• Índice EPA = valor de EPA de tu programa / valor de EPA del segmento \* 100</p>                                         |
| Tu tasa de comisión                       | Tu tasa de comisión representa el porcentaje del valor de las ventas que has ganado por generar conversiones en el segmento de marca.                                                                                                                                                                                                                                       |
| Tasa de comisión del segmento de partners | La tasa de comisión del segmento de partners representa el porcentaje del valor de las ventas ganado por todos los partners con el mismo modelo de negocio que tú por generar conversiones en el segmento de marca.                                                                                                                                                         |
| Índice de tasa de comisión                | <p>Un índice superior a 120 indica que es posible que estés recibiendo una tasa de comisión más alta para este segmento de marca en comparación con tus pares. Un índice inferior a 80 indica lo contrario:</p><p>• Índice de tasa de comisión = Tu tasa de comisión / Tasa de comisión del segmento de partners \* 100</p>                                                 |

</details>

### Oportunidades y recomendaciones de marcas

{% hint style="info" %}
**Criterios de elegibilidad para las recomendaciones:** Para que un partner reciba recomendaciones de marcas, necesita tener al menos 10 o más colaboraciones existentes en el segmento de marca.
{% endhint %}

El *Oportunidades y recomendaciones de marcas* sección de la *Benchmark de partners* pantalla enumera las marcas que están muy bien clasificadas en términos de pagos y que son ampliamente utilizadas por partners similares a ti. Estas son marcas con las que no estás asociado o que no aprovechas al máximo.

<details>

<summary>Optimizar relaciones existentes</summary>

Esta tabla te muestra posibles ingresos por comisión de marcas con las que ya estás asociado. Estas marcas están muy bien clasificadas en términos de pagos y son ampliamente utilizadas por partners similares a ti, pero actualmente no las estás aprovechando al máximo. Considera cómo puedes optimizar tus colaboraciones con estas marcas.

Consulta la *Referencia de la tabla de recomendaciones* a continuación para obtener más información sobre las columnas de la tabla.

{% hint style="info" %}
**Nota:** Si no ves datos, es porque no hay pares marca-partner con una estimación de comisión > 0.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://4119967529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-397c9afd4a27b4c7fe8f3f8821f1b3b4907ae230%2F4c03d8b8cadce625951283ab166e1c003f7d012233ad5ea13baa3f9d53545ac3.png?alt=media" alt=""><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Marcas recomendadas para unirse</summary>

Esta tabla te muestra posibles ingresos por comisión de marcas con las que actualmente no trabajas. Estas marcas están muy bien clasificadas en términos de pagos y son ampliamente utilizadas por partners similares a ti, pero no estás asociado con ellas. Considera solicitar unirte a su programa.

Consulta la *Referencia de la tabla de recomendaciones* a continuación para obtener más información sobre las columnas de la tabla.

{% hint style="info" %}
**Nota:** Si no ves datos, es porque no hay pares marca-partner con una estimación de comisión > 0.
{% endhint %}

</details>

<details>

<summary>Referencia de la tabla de recomendaciones</summary>

| Columna                   | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nombre de la marca        | <p>El nombre de la marca.</p><p>• Selecciona el nombre de la marca para ver su perfil de Marketplace.</p><p>• Desde aquí puedes <a href="/partner/es/sobre-que-te-gustaria-aprender/platform-features/working-with-brands/contacting-a-brand/access-brand-contact-information.md">contacta con ellos</a> (si tienes una colaboración con ellos) o <a href="/partner/es/sobre-que-te-gustaria-aprender/platform-features/working-with-brands/applying-to-brands/find-and-apply-to-brands.md">solicitar trabajar con ellos</a>.</p> |
| Segmento de marca         | Esta es la categoría del sector a la que pertenece la marca.                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Calificación de estrellas | El sistema de calificación por estrellas de impact.com para marcas es una puntuación de 0 a 5 que estima el potencial de ingresos de una marca.                                                                                                                                                                                                                                                                                                                                                                                   |
| EPC                       | <p>Ingresos por clic. Se calcula como el pago total obtenido de los clics generados dividido por el número de clics únicos:</p><p>• EPC = Pago / # de clics</p>                                                                                                                                                                                                                                                                                                                                                                   |
| Potencial de comisión     | La cantidad de comisión adicional que podrías generar por trimestre si te asocias con esta marca o si optimizas tu colaboración con la marca.                                                                                                                                                                                                                                                                                                                                                                                     |

</details>


---

# 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/partner/es/sobre-que-te-gustaria-aprender/platform-features/reporting-for-partners/partner-benchmarking.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.