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

# Fazer upload de arquivos de promoção de produtos

O *Promoções de produtos* permite compartilhar ofertas especiais e promoções com parceiros. Essas ofertas aparecem nos feeds de produtos dos parceiros, nas APIs de produtos e no marketplace de produtos da impact.com, onde uma *Oferta especial* tag é exibida diretamente no bloco do produto nos resultados da pesquisa.

{% hint style="warning" %}
**Importante:** Você precisará ter um catálogo de produtos ativo para começar. Para obter ajuda na criação do seu primeiro envio de produtos, consulte [Adicionar catálogos de produtos](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).
{% endhint %}

#### Fazer upload de um arquivo de promoção

Use o [modelo de arquivo de promoção](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) para criar seu arquivo. O mesmo formato de arquivo funciona com os dois métodos de upload.

{% tabs %}
{% tab title="Upload direto" %}

1. No menu de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Conteúdo → Produtos →** [**Promoções de produtos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-product-promotion-flow.ihtml).
2. No canto superior direito, selecione **Fazer upload do arquivo de promoção**.
3. Insira o **Nome do arquivo de promoção**.
4. Selecione o método de ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Botão de opção]** **Upload direto** .
5. Selecione o **Formato**.
   * A impact.com é compatível apenas com *Google Merchant Center (formato TXT)* ou seja, `.txt` e *Google Merchant Center (formato CSV)* ou seja, `.csv` .
   * Consulte a *Referência dos campos do feed de promoções de produtos* abaixo para obter mais informações sobre esses campos.
6. Selecione **Escolher arquivo**.
   * Localize no seu computador o arquivo que você quer enviar.
7. Selecione o **Idioma** de sua preferência e **Salvar**.
   {% endtab %}

{% tab title="Buscar por URL" %}
Esta opção permite buscar um arquivo em um servidor FTP/SFTP ou em uma URL HTTP/HTTPS para garantir que os dados da promoção estejam atualizados.

1. No menu de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Conteúdo → Produtos →** [**Promoções de produtos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-product-promotion-flow.ihtml).
2. No canto superior direito, selecione **Fazer upload do arquivo de promoção**.
3. Insira o **Nome do arquivo de promoção**.
4. Selecione o método de upload ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Botão de opção]** **Buscar por URL** .
5. Selecione o **Formato**.
   * A impact.com é compatível apenas com *Google Merchant Center (formato TXT)* ou seja, `.txt` e *Google Merchant Center (formato CSV)* ou seja, `.csv` .
   * Consulte a *Referência dos campos do feed de promoções de produtos* abaixo para obter mais informações sobre esses campos.
6. Insira o **nome** do seu arquivo em *Nome do arquivo enviado*.
7. Insira o **URL de busca** que aponta para o diretório onde está o arquivo de dados da sua promoção.
   * Esse URL pode ser FTP ou HTTPS. Por exemplo, `ftp://ftp.acme.com` ou `https://acme.com/anvil_promotions/anvil.txt`
8. Selecione a **Frequência de busca** com que a impact.com buscará o arquivo:
   * Diariamente
   * A cada 8 horas
   * A cada 4 horas
   * A cada 2 horas
9. Selecione o **Horário da busca** em que a impact.com buscará o arquivo.
   * As opções exibidas estão no fuso horário do Leste (GMT -05:00).
10. Selecione seu **Fuso horário**.
11. Selecione o **Idioma** de sua preferência e **Salvar**.
    {% endtab %}
    {% endtabs %}

<details>

<summary>Referência dos campos do feed de promoções de produtos</summary>

| Campos esperados                             | Obrigatório? | Descrição                                                                                               | Formato                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| -------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID `[promotion_id]`                          | Sim          | O ID exclusivo de cada promoção.                                                                        | O ID diferencia maiúsculas de minúsculas, pode ter até 50 caracteres e não pode conter espaços nem símbolos. Por exemplo, `103330482`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Aplicabilidade `[product_applicability]`     | Sim          | Este atributo especifica se a promoção se aplica a todos os produtos ou somente a produtos específicos. | <p>Valores compatíveis:</p><p>• <code>all\_products</code></p><p>•<code>specific\_products</code></p><p>A impact.com só pode associar as promoções do seu <a href="https://support.google.com/merchants/answer/2906014?hl=en">arquivo de feed de promoções do Google</a> a produtos específicos do seu <a href="https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md">catálogo de produtos</a> se o catálogo de produtos incluir <code>promotion\_id</code>. Não é possível usar o valor <code>specific\_products</code> a menos que o catálogo de produtos inclua IDs de promoção. Consulte <a href="#link-promotions-to-specific-products">Vincular promoções a produtos específicos</a>.</p> |
| Descrição `[long_title]`                     | Sim          | O título completo de cada promoção.                                                                     | O comprimento máximo do título é de 60 caracteres. Por exemplo, `Free mug with purchase`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Vigência `[promotion_effective_dates]`       | Sim          | O período da promoção.                                                                                  | <p>• A data de <strong>início</strong> e <strong>de</strong> término são separadas por uma barra (/).</p><p>• O formato da data é (YYYY-MM-DD), seguido da letra ‘T’, do horário em que a promoção começa ou termina e da indicação do fuso horário da promoção.</p><p>• Exemplo: <code>2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Exibição `[promotion_display_dates]`         | Não          | Este atributo especifica a data e o período em que a promoção estará ativa.                             | A data de **início** e a data de **término** são separadas por uma barra (/), por exemplo, `2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Canal `[redemption_channel]`                 | Sim          | Este atributo indica se a promoção é válida online ou em uma loja física.                               | <p>Valores compatíveis:</p><p>• <code>online</code></p><p>• <code>in\_store</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Tipo de código da oferta `[offer_type]`      | Sim          | Este atributo indica se é necessário um código de cupom para que os clientes resgatem a oferta.         | <p>Valores compatíveis:</p><p>• <code>no\_code</code></p><p>• <code>generic\_code</code></p><p><strong>Importante:</strong> Se o valor deste atributo for <code>generic\_code</code>, então <code>generic\_redemption\_code</code> é obrigatório.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Código da oferta `[generic_redemption_code]` | Não          | Este atributo especifica o código que pode ser usado online para resgatar a promoção.                   | O comprimento máximo é de 20 caracteres. Por exemplo, `EXTRA20`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Destino `[promotion_destination]`            | Não          | Este atributo especifica o formato de cada promoção.                                                    | <p>Valores compatíveis:</p><p>• <code>Shopping\_ads</code></p><p>•<code>Buy\_on\_Google\_listings</code></p><p>• <code>Free\_listings</code></p><p>Para enviar sua promoção a um ou mais destinos, inclua cada valor de destino em uma coluna separada.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

</details>

#### Vincule promoções a produtos específicos

Se uma promoção se aplicar apenas a alguns dos seus produtos, defina `product_applicability` como `specific_products` no arquivo da promoção. Em seguida, adicione o ID da promoção a cada produto elegível no catálogo de produtos para que o impact.com possa correspondê-los. Se a promoção se aplicar a todos os seus produtos, use `all_products` e ignore estas etapas.

1. No arquivo da promoção, atribua à promoção um valor exclusivo de `promotion_id`, por exemplo, `103330482`.
2. No catálogo de produtos do Google Merchant Center, adicione um campo `promotion_id` .
   * Consulte [Formatos de arquivo para catálogos de produtos](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/file-formats-for-product-catalogs.md) para ver os tipos de arquivo do Google Merchant Center compatíveis com o impact.com.
3. Para cada produto ao qual a promoção se aplica, informe o mesmo valor de `promotion_id` .
   * Os valores devem corresponder exatamente, inclusive as letras maiúsculas e minúsculas.
4. Faça upload do catálogo de produtos atualizado e do arquivo da promoção.
   * Para obter ajuda, consulte [Adicionar catálogos de produtos](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md) e [Fazer upload de um arquivo de promoção](#upload-a-promotion-file).
   * A promoção se aplica somente aos produtos cujo valor de `promotion_id` corresponde ao do catálogo de produtos.

{% hint style="info" %}
**Exemplo:** A promoção *Caneca grátis na compra* se aplica aos grãos de café e à prensa francesa, mas não à chaleira. Para facilitar a visualização, outras colunas obrigatórias foram omitidas.
{% endhint %}

Arquivo da promoção:

| promotion\_id | product\_applicability | long\_title             |
| ------------- | ---------------------- | ----------------------- |
| 103330482     | specific\_products     | Caneca grátis na compra |

Catálogo de produtos:

| id       | title               | promotion\_id |
| -------- | ------------------- | ------------- |
| SKU-1001 | Grãos de café, 1 kg | 103330482     |
| SKU-1002 | Prensa francesa     | 103330482     |
| SKU-1003 | Chaleira            |               |

#### Solucionar erros e mensagens de aviso

<details>

<summary>Ver erros e avisos</summary>

Na tela *Promoções de produtos* , na coluna *Status* , selecione *erros* ou *avisos* para ver mais informações sobre o erro, como o tipo ou a mensagem de erro. Consulte [Gerenciar arquivos de promoções de produtos](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-promotions/manage-your-product-promotion-files.md) para saber mais sobre o *Status* do arquivo de promoção.

</details>

<details>

<summary>Pesquisar e filtrar erros</summary>

Você pode clicar em *erros* e *avisos* do arquivo e usar o campo de pesquisa e os filtros para examinar todos os erros do arquivo de promoção enviado.

*Tipo de erro* incluem os filtros:

* Todos
* Aviso
* Erro
* Duplicar

</details>

<details>

<summary>Mensagens de erro e aviso</summary>

| Mensagem de erro                                           | Explicação                                                                           |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Campo(s) obrigatório(s) ausente(s):{Required field}        | Um ou mais campos obrigatórios estão ausentes no arquivo enviado.                    |
| Registros ignorados devido a uma data de vigência expirada | A data de término da vigência da promoção já passou, então esse registro é ignorado. |

</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/pt-br/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.
