> 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/product-promotions/upload-product-promotion-files.md).

# Cargar archivos de promoción de productos

La *Promociones de productos*  permite compartir ofertas especiales y promociones con los partners. Estas ofertas aparecen en los feeds de productos de los partners, en las API de productos y en el marketplace de productos de impact.com, donde se muestra una etiqueta de *Oferta especial* directamente en la tarjeta del producto en los resultados de búsqueda.

{% hint style="warning" %}
**Importante:** Necesitarás tener un catálogo de productos activo antes de empezar. Si necesitas ayuda para crear tu primera carga de productos, consulta [Añadir catálogos de productos](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).
{% endhint %}

#### Subir un archivo de promociones

Usa la [plantilla del archivo de promociones](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) para crear el archivo. El mismo formato de archivo sirve para ambos métodos de carga.

{% tabs %}
{% tab title="Carga directa" %}

1. En el menú de navegación de la 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) **\[Engage] → Contenido → Productos →** [**Promociones de productos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-product-promotion-flow.ihtml).
2. En la esquina superior derecha, selecciona **Subir archivo de promociones**.
3. Introduce el **Nombre del archivo de promociones**.
4. Selecciona el método ![](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]** **Carga directa** .
5. Selecciona el **formato**.
   * impact.com solo admite *Google Merchant Center (formato TXT)* es decir, `.txt` y *Google Merchant Center (formato CSV)* es decir, `.csv` .
   * Consulta la *referencia de campos del feed de promociones de productos* a continuación para obtener más información sobre estos campos.
6. Selecciona **Elegir archivo**.
   * Busca en tu computadora el archivo que quieres subir.
7. Selecciona el **idioma** que prefieras y **Guardar**.
   {% endtab %}

{% tab title="Obtener desde URL" %}
Esta opción permite obtener un archivo de un servidor FTP/SFTP o de una URL HTTP/HTTPS para mantener actualizados los datos de las promociones.

1. En el menú de navegación de la 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) **\[Engage] → Contenido → Productos →** [**Promociones de productos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-product-promotion-flow.ihtml).
2. En la esquina superior derecha, selecciona **Subir archivo de promociones**.
3. Introduce el **Nombre del archivo de promociones**.
4. Selecciona el método de carga ![](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]** **Obtener desde URL** .
5. Selecciona el **formato**.
   * impact.com solo admite *Google Merchant Center (formato TXT)* es decir, `.txt` y *Google Merchant Center (formato CSV)* es decir, `.csv` .
   * Consulta la *referencia de campos del feed de promociones de productos* a continuación para obtener más información sobre estos campos.
6. Introduce el **nombre** de tu archivo en *Nombre del archivo que se subirá*.
7. Introduce la **URL de extracción** que apunta al directorio donde se encuentra el archivo de datos de promociones.
   * Esta URL puede ser FTP o HTTPS. Por ejemplo: `ftp://ftp.acme.com` o `https://acme.com/anvil_promotions/anvil.txt`
8. Selecciona la **Frecuencia de extracción** con la que impact.com extraerá el archivo:
   * Diariamente
   * Cada 8 horas
   * Cada 4 horas
   * Cada 2 horas
9. Selecciona la **Hora de extracción** a la que impact.com extraerá el archivo.
   * Las opciones que se muestran están en GMT -05:00, hora del este.
10. Selecciona tu **Zona horaria**.
11. Selecciona el **idioma** que prefieras y **Guardar**.
    {% endtab %}
    {% endtabs %}

<details>

<summary>Referencia de campos del feed de promociones de productos</summary>

| Campos esperados                             | ¿Obligatorio? | Descripción                                                                                              | Formato                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| -------------------------------------------- | ------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID `[promotion_id]`                          | Sí            | El ID único de cada promoción.                                                                           | El ID distingue entre mayúsculas y minúsculas, puede tener hasta 50 caracteres y no puede contener espacios ni símbolos. Por ejemplo: `103330482`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Aplicabilidad `[product_applicability]`      | Sí            | Este atributo especifica si la promoción se aplica a todos los productos o solo a productos específicos. | <p>Valores admitidos:</p><p>• <code>all\_products</code></p><p>•<code>specific\_products</code></p><p>impact.com solo puede asociar las promociones de tu <a href="https://support.google.com/merchants/answer/2906014?hl=en">archivo del feed de promociones de Google</a> con productos específicos de tu <a href="https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md">catálogo de productos</a> si tu catálogo de productos incluye <code>promotion\_id</code>. No puedes usar el valor <code>specific\_products</code> a menos que tu catálogo de productos incluya IDs de promociones. Consulta <a href="#link-promotions-to-specific-products">Vincular promociones a productos específicos</a>.</p> |
| Descripción `[long_title]`                   | Sí            | El título completo de cada promoción.                                                                    | La longitud máxima del título es de 60 caracteres. Por ejemplo: `Free mug with purchase`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Vigencia `[promotion_effective_dates]`       | Sí            | El período de vigencia de la promoción.                                                                  | <p>• La fecha de <strong>inicio</strong> y <strong>finalización</strong> se separan con una barra diagonal (/).</p><p>• El formato de fecha es (YYYY-MM-DD), seguido de la letra «T», la hora del día en que comienza o termina la oferta y la expresión de la zona horaria de la oferta.</p><p>• Ejemplo: <code>2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Visualización `[promotion_display_dates]`    | No            | Este atributo especifica la fecha y el período durante el cual estará activa la promoción.               | Las fechas de **inicio** y **finalización** se separan con una barra diagonal (/). Por ejemplo: `2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Canal `[redemption_channel]`                 | Sí            | Este atributo indica si la promoción es válida en línea o en una tienda física.                          | <p>Valores admitidos:</p><p>• <code>online</code></p><p>• <code>in\_store</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Tipo de código de oferta `[offer_type]`      | Sí            | Este atributo indica si los clientes necesitan un código de cupón para canjear la oferta.                | <p>Valores admitidos:</p><p>• <code>no\_code</code></p><p>• <code>generic\_code</code></p><p><strong>Importante:</strong> Si el valor de este atributo es <code>generic\_code</code>, entonces <code>generic\_redemption\_code</code> es obligatorio.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Código de oferta `[generic_redemption_code]` | No            | Este atributo especifica el código que se puede usar en línea para canjear la promoción.                 | La longitud máxima es de 20 caracteres. Por ejemplo: `EXTRA20`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Destino `[promotion_destination]`            | No            | Este atributo especifica el formato de cada promoción.                                                   | <p>Valores admitidos:</p><p>• <code>Shopping\_ads</code></p><p>•<code>Buy\_on\_Google\_listings</code></p><p>• <code>Free\_listings</code></p><p>Para enviar tu promoción a uno o varios destinos, incluye cada valor de destino en una columna independiente.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

</details>

#### Vincular promociones a productos específicos

Si una promoción se aplica solo a algunos de tus productos, establece `product_applicability` en `specific_products` en el archivo de promociones. Después, añade el ID de la promoción a cada producto que cumpla los requisitos en tu catálogo de productos para que impact.com pueda asociarlos. Si la promoción se aplica a todos tus productos, usa `all_products` y omite estos pasos.

1. En el archivo de promociones, asigna a la promoción un valor único para `promotion_id`, por ejemplo, `103330482`.
2. En el catálogo de productos de Google Merchant Center, añade un campo `promotion_id` .
   * Consulta [Formatos de archivo para catálogos de productos](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/file-formats-for-product-catalogs.md) para ver los tipos de archivo de Google Merchant Center que admite impact.com.
3. Para cada producto al que se aplique la promoción, introduce el mismo valor de `promotion_id` .
   * Los valores deben coincidir exactamente, incluidas las letras mayúsculas y minúsculas.
4. Sube el catálogo de productos actualizado y el archivo de promociones.
   * Si necesitas ayuda, consulta [Añadir catálogos de productos](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md) y [Subir un archivo de promociones](#upload-a-promotion-file).
   * La promoción solo se aplica a los productos cuyo valor de `promotion_id` coincida en el catálogo de productos.

{% hint style="info" %}
**Ejemplo:** La promoción *Taza gratis con la compra* se aplica a los granos de café y a la prensa francesa, pero no al hervidor de té. Para mayor claridad, se omiten otras columnas obligatorias.
{% endhint %}

Archivo de promociones:

| promotion\_id | product\_applicability | long\_title               |
| ------------- | ---------------------- | ------------------------- |
| 103330482     | specific\_products     | Taza gratis con la compra |

Catálogo de productos:

| id       | title                | promotion\_id |
| -------- | -------------------- | ------------- |
| SKU-1001 | Granos de café, 1 kg | 103330482     |
| SKU-1002 | Prensa francesa      | 103330482     |
| SKU-1003 | Hervidor de té       |               |

#### Solucionar problemas de errores y advertencias

<details>

<summary>Ver errores y advertencias</summary>

En la pantalla *Promociones de productos* , en la columna *Estado* , selecciona *errores* o *advertencias* para ver más información sobre el error, como el tipo o el mensaje de error. Consulta [Administrar los archivos de promoción de productos](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-promotions/manage-your-product-promotion-files.md) para obtener más información sobre el *Estado* de tu archivo de promociones.

</details>

<details>

<summary>Buscar y filtrar errores</summary>

Puedes hacer clic en los *errores* y las *advertencias* del archivo para usar el campo de búsqueda y los filtros y revisar todos los errores del archivo de promociones cargado.

*Tipo de error* Los filtros incluyen:

* Todos
* Advertencia
* Error
* Duplicar

</details>

<details>

<summary>Mensajes de error y advertencia</summary>

| Mensaje de error                                          | Explicación                                                                                     |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Falta(n) campo(s) obligatorio(s):{Required field}         | Falta uno o más campos obligatorios en el archivo cargado.                                      |
| Registros omitidos debido a una fecha de vigencia vencida | La fecha de finalización de vigencia de la promoción ya pasó, por lo que se omite ese registro. |

</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/brand/es/what-would-you-like-to-learn-about/platform-features/product-promotions/upload-product-promotion-files.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.
