> 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/es/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/promotional-themes-for-assets.md).

# Configurar detalles promocionales para recursos

Usa la sección *Detalles promocionales* de un recurso para vincularlo a una oferta, controlar cuándo está disponible, determinar qué sucede cuando vence o etiquetarlo con una temática de temporada. Esto te ayuda a organizar los recursos por campaña o época del año y a que los partners encuentren los recursos adecuados para sus propias iniciativas de marketing.

## Añadir detalles promocionales durante la configuración del recurso

La configuración de los detalles promocionales de un recurso es opcional. A continuación, te explicamos cómo hacerlo durante la configuración del tipo de recurso que elijas:

{% stepper %}
{% step %}

### Añade una *oferta* a tu recurso

1. Después de completar *Detalles del recurso* y *Configuración del recurso* para tu recurso, ve a *Detalles promocionales*.
2. En *Oferta*, elige una oferta existente en el ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menú desplegable]**.
3. También puedes seleccionar **Añadir oferta nueva** ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menú desplegable]** y [crear una oferta nueva](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/deals/deal-types-overview.md) para asignarla a este recurso.

<div data-with-frame="true"><figure><img src="https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FDCL43npMvdsHRKHRZ13w%2FScreenshot_2026-10-21_at_2_05_43%E2%80%AFPM.png?alt=media&amp;token=4632a3fa-c705-47d7-9428-af2eef619a99" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Añade *Fechas de disponibilidad* a tu recurso

1. En *Fechas de disponibilidad*, selecciona el ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-82e75b518a6cfe0fb2fedc3e1d21154fc9dee900%2F3754728747f89a16597a42d74f841edf8612889648f257c01aff47a200ac144d.svg?alt=media) **\[Selector de fecha]** para establecer una *Fecha de inicio* y una *Fecha de finalización* para este recurso.
2. En el ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menú desplegable]**, especifica una **Zona horaria**.

{% hint style="success" %}
**Nota:** Los recursos con fechas futuras no se activan hasta la fecha de inicio. Para que los partners puedan verlos antes de esa fecha, activa **Mostrar anuncios futuros** en tus [valores predeterminados de anuncios](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/asset-filter-reference-for-brands.md#manage-a-d-defaults).
{% endhint %}
{% endstep %}

{% step %}

### Redirige a los partners cuando venza tu recurso

1. Selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla] Cambiar la página de destino al vencimiento**.
2. Selecciona **Configurar regla**.
3. En *Acción*, elige la regla de expiración que quieras aplicar:

<details>

<summary>Redireccionar</summary>

1. En el ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media)**\[Menú desplegable]** selecciona **Redireccionar**.
2. Introduce el enlace al que se redireccionará el recurso.
3. Opcionalmente, ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Activar]** **Página intersticial** para activar y configurar una página intersticial asociada a esta regla.
4. En el **Plantilla** ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menú desplegable]** selecciona **Personalizada** o **Instalación de la aplicación**.
   * **Personalizada**
     1. Introduce un **Texto del encabezado**.
     2. Opcionalmente, introduce un **Texto del cuerpo**.
     3. Opcionalmente, introduce **Términos adicionales** para este recurso.
     4. Opcionalmente, selecciona la ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para **Exigir la confirmación del usuario**.
     5. Selecciona la ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para **Mostrar el logotipo del socio (marca compartida)** y mostrar juntos tu logotipo y el del socio para ofrecer una experiencia de marca compartida.
     6. Selecciona la ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para **Personalizar CSS** y añade el código CSS deseado en el cuadro de texto.
     7. Selecciona **Vista previa**.
   * **Instalación de la aplicación**
     1. Introduce un **Texto del encabezado** y **Color de fuente del encabezado**.
     2. Introduce un **Subencabezado** y **Color de fuente del subtítulo**.
     3. Para **Subir logotipo** y **Subir imagen de portada**, selecciona **Elegir archivo**. Recuerda que se admiten los formatos de archivo GIF, JPG, PNG y SVG. El tamaño máximo del archivo es 1 MB.
     4. Introduce un **Etiqueta del botón Descargar** (por ejemplo, *Descargar ahora*).
        * Introduce un **Color de fuente del botón Descargar** y **Color de fondo del botón Descargar**.
        * Introduce una **Etiqueta del botón Continuar** y **Color de fuente del botón Continuar**.
     5. Introduce una **Cuenta regresiva de redirección automática** con la cantidad de segundos permitidos antes de la redirección.
     6. Opcionalmente, introduce un **Texto del cuerpo**.
     7. Selecciona la ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para **Mostrar el logotipo del socio (marca compartida)** y mostrar juntos tu logotipo y el del socio para ofrecer una experiencia de marca compartida.
     8. Selecciona la ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para **Personalizar CSS** y añade el código CSS deseado en el cuadro de texto.
     9. Selecciona **Vista previa**.

</details>

<details>

<summary>Bloquear</summary>

1. Opcionalmente, ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Activar]** para **Usar página intersticial** para habilitar y configurar una página intersticial asociada a esta regla.
2. En la **Plantilla** ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menú desplegable]** selecciona **Personalizada**.
3. Introduce un **Texto del encabezado**.
4. Opcionalmente, introduce un **Texto del cuerpo**.
5. Selecciona **Vista previa**.

</details>

<details>

<summary>Página intersticial</summary>

1. En el **Plantilla** ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menú desplegable]** selecciona **Personalizada** o **Instalación de la aplicación**.
   * **Personalizada**
     1. Introduce un **Texto del encabezado**.
        * Opcionalmente, introduce un **Texto del cuerpo**.
        * Opcionalmente, introduce **Términos adicionales** y condiciones que se aplicarán.
        * Selecciona la ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para **Solicitar la confirmación del usuario**.
        * Selecciona la ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para **Mostrar el logotipo del socio (marca compartida)** y mostrar juntos tu logotipo y el del socio para ofrecer una experiencia de marca compartida.
        * Selecciona la ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para **Personalizar CSS** y añade el código CSS deseado en el cuadro de texto.
        * Selecciona **Vista previa**.
   * **Instalación de la aplicación**
     1. Introduce un **Texto del encabezado** y **Color de fuente del encabezado**.
     2. Introduce un **Subencabezado** y **Color de fuente del subtítulo**.
     3. Para **Subir logotipo** y **Subir imagen de portada**, selecciona **Elegir archivo**. Recuerda que se admiten los formatos de archivo GIF, JPG, PNG y SVG. El tamaño máximo del archivo es 1 MB.
     4. Introduce un **Etiqueta del botón Descargar** (por ejemplo, *Descargar ahora*).
        * Introduce un **Color de fuente del botón Descargar** y **Color de fondo del botón Descargar**.
        * Introduce una **Etiqueta del botón Continuar** y **Color de fuente del botón Continuar**.
     5. Introduce una **Cuenta regresiva de redirección automática**, para indicar los segundos permitidos antes de la redirección.
     6. Opcionalmente, introduce un **Texto del cuerpo**.
     7. Selecciona la ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para **Mostrar el logotipo del socio (marca compartida)** y mostrar juntos tu logotipo y el del socio para ofrecer una experiencia de marca compartida.
     8. Selecciona la ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para **Personalizar CSS** y añade el código CSS deseado en el cuadro de texto.
     9. Selecciona **Vista previa** y, cuando estés conforme con la vista previa, selecciona **Enviar**.

</details>

<details>

<summary>Enlaces profundos para móviles</summary>

1. En el **plantilla** ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menú desplegable]**, selecciona **Enlaces profundos para móviles**.
2. Introduce el **Texto del encabezado** y **Color de fuente del encabezado**.
3. Introduce el **Subencabezado** y **Color de fuente del subencabezado**.
4. Para **Subir logotipo** y **Subir imagen de portada**, selecciona **Elegir archivo**. Recuerda que se admiten los formatos de archivo GIF, JPG, PNG y SVG. El tamaño máximo del archivo es 1 MB.
5. Introduce una **Etiqueta del botón para abrir la aplicación** (p. ej., *Ir a la aplicación*).
   * Introduce un **Color de fuente del botón para abrir la aplicación** y **Color de fondo del botón para abrir la aplicación**.
   * Introduce una **Etiqueta del enlace para continuar** y **Color de fuente del enlace para continuar**.
6. Elige cuándo se **abre la aplicación** seleccionando una de estas opciones: ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Botón de opción]** **En cuanto se cargue la página intersticial** o ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Botón de opción]** **Al tocar el botón**.
7. Selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para activar la **Redirección automática** e introduce el número de segundos que deben transcurrir antes de la redirección.
8. Introduce una **Ruta URI predeterminada** que se utilizará al crear la [URI móvil](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/tracking/mobile-app-tracking/configure-deep-linking-logic-with-uri-schemes.md) mediante el esquema de URL del programa configurado en [*Configuración general de seguimiento*](https://app.impact.com/secure/advertiser/tracking-settings/general-trackingsettings-flow.ihtml).
9. Introduce una **Expresión regular de URI personalizada** para definir el patrón con el que se compararán las URI móviles del esquema de URL personalizado de la aplicación.
10. Selecciona la ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casilla sin marcar]** para **Personalizar CSS** y añade el código CSS deseado en el cuadro de texto.
11. Selecciona **Vista previa**.

</details>

4. Para guardar la regla, selecciona **Enviar.**
   {% endstep %}

{% step %}

### Aplica una *De temporada* el tema de tu recurso

1. En *De temporada*, aplica un período de temporada al recurso desde el ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menú desplegable]**.
2. En **Opciones promocionales adicionales**, selecciona las opciones que correspondan:
   * ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9fd92d4378edf839f6a1f6fc0beaa1660b3892b5%2F69842c54f03332c1e2eed608d72b25ad10248384a914164a7255a1e94dc76ee2.svg?alt=media) **\[Casillas sin marcar]** **El producto es uno de los más vendidos**
   * ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9fd92d4378edf839f6a1f6fc0beaa1660b3892b5%2F69842c54f03332c1e2eed608d72b25ad10248384a914164a7255a1e94dc76ee2.svg?alt=media) **\[Casillas sin marcar]** **Permite que un socio de medios solicite su propio código promocional único para esta promoción**
     {% endstep %}

{% step %}

### Completa la configuración de tu recurso

1. Para obtener instrucciones sobre cómo completar *Configuración avanzada* o guardar tu recurso, consulta el documento de ayuda correspondiente al tipo de recurso:
   * [**Imagen, correo electrónico, texto patrocinado, enlace de texto, cupón, artículo o video**](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/ads/create-an-asset.md#advanced-settings)
   * [**Widget personalizado**](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/generate-leads/create-a-custom-widget.md#update-advanced-settings)
     {% endstep %}
     {% endstepper %}

## Configura los detalles promocionales de un recurso existente

Puedes agregar detalles promocionales a un recurso existente en cualquier momento.

1. En la barra de navegación izquierda, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Interactuar]** → **Contenido** → [**Anuncios**](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml).
2. Pasa el cursor sobre el recurso que quieres actualizar y selecciona **Actualizar**.
3. En la sección *Detalles promocionales* , completa cualquiera de los campos descritos anteriormente y selecciona **Guardar**.

<div data-with-frame="true"><figure><img src="https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F8m7I1OCBEVXiqicnzbwI%2FScreenshot_2026-10-21_at_1_54_45%E2%80%AFPM.png?alt=media&amp;token=df31d115-1f7d-41a7-9dfb-3b40c1b8c741" alt="" width="563"><figcaption></figcaption></figure></div>


---

# 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/es/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/promotional-themes-for-assets.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.
