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

O *Promoções de Produtos* recurso permite que você compartilhe ofertas e promoções especiais 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* etiqueta exibida diretamente no bloco do produto nos resultados de pesquisa.

{% hint style="warning" %}
**Importante:** Você precisará ter um catálogo de produtos ativo antes de poder começar. Para obter ajuda na criação do seu primeiro upload de produto, veja [Adicionar Catálogos de Produtos](https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/product-catalogs/add-product-catalogs-as-a-brand).
{% endhint %}

#### Carregar um arquivo de promoção

{% 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**.
2. No canto superior direito, selecione **Carregar Arquivo de Promoção**.
3. Insira seus **Nome do Arquivo de Promoção**.
4. Selecione o ![](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** método.
5. Selecione o arquivo **Formato**.
   * a impact.com só suporta *Google Merchant Center (formato TXT)* ou seja, `.txt` e *Google Merchant Center (formato CSV)* ou seja, `.csv` arquivos.
   * Consulte a [*Referência de campos do feed de promoções de produtos*](#para-idm73509110741608) abaixo para mais informações sobre esses campos.
6. Selecione **Escolher arquivo**.
   * Localize o arquivo que você deseja carregar no seu computador.
7. Selecione seu **Idioma** e **Salvar**.
   {% endtab %}

{% tab title="Puxar de URL" %}
Esta opção suporta puxar um arquivo de um servidor FTP/SFTP ou URL HTTP/HTTPS para garantir dados de promoção 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**.
2. No canto superior direito, selecione **Carregar Arquivo de Promoção**.
3. Insira seus **Nome do Arquivo de Promoção**.
4. Selecione o ![](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]** **Puxar de URL** método de upload.
5. Selecione o arquivo **Formato**.
   * a impact.com só suporta *Google Merchant Center (formato TXT)* ou seja, `.txt` e *Google Merchant Center (formato CSV)* ou seja, `.csv` arquivos.
   * Consulte a [*Referência de campos do feed de promoções de produtos*](#para-idm73509110741608) abaixo para mais informações sobre esses campos.
6. Insira o **nome** do seu arquivo em *Nome do Arquivo de Upload*.
   * [Veja este modelo](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) para orientação ao carregar suas promoções.
7. Insira o **URL de Pull** que aponta para o diretório onde seu arquivo de dados de promoção existe.
   * Esta URL pode ser um FTP ou HTTPS. Ex.: `ftp://ftp.acme.com` ou `https://acme.com/anvil_promotions/anvil.txt`
8. Selecione o **Frequência de Busca** sobre com que frequência a impact.com buscará o arquivo:
   * Diário
   * A cada 8 hora(s)
   * A cada 4 hora(s)
   * A cada 2 hora(s)
9. Selecione o **Hora de Busca** em que a impact.com buscará o arquivo.
   * As opções exibidas estão em GMT -05:00 Horário do Leste.
10. Selecione seu **Fuso Horário**.
11. Selecione seu **Idioma** e **Salvar**.
    {% endtab %}
    {% endtabs %}

<details>

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

| Campos esperados                             | Obrigatório? | Descrição                                                                                              | Formato                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| -------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID `[promotion_id]`                          | Sim          | O ID único de cada promoção.                                                                           | Este ID está em formato numérico e não deve conter espaços ou símbolos, por exemplo, `103330482`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Aplicabilidade `[product_applicability]`     | Sim          | Este atributo especifica se a promoção se aplica a todos os produtos ou apenas a produtos específicos. | <p>Valores suportados:</p><p>• <code>todos\_produtos</code></p><p>• <code>produtos\_específicos</code></p><p><strong>Observação:</strong> a impact.com só pode mapear as promoções em seu <a href="https://support.google.com/merchants/answer/2906014?hl=en">arquivo de feed de promoções do Google</a> com produtos específicos em seu <a href="../product-catalogs/add-product-catalogs-as-a-brand">catálogo de produtos</a> se o seu feed de produtos incluir <code>promotion\_id</code>. Em outras palavras, você não pode ter o <code>produtos\_específicos</code> valor se seu feed de produtos não incluir IDs de promoção.</p> |
| Descrição `[long_title]`                     | Sim          | O título completo de cada promoção.                                                                    | O comprimento máximo do título é 60 caracteres. Ex.: `Caneca grátis com a compra`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Vigência `[promotion_effective_dates]`       | Sim          | O período da promoção.                                                                                 | <p>• A <strong>início</strong> e <strong>fim</strong> as datas são separadas por uma barra (/).</p><p>• O formato da data é (AAAA-MM-DD), seguido pela letra ‘T’, a hora do dia em que a promoção começa ou termina, e uma expressã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 intervalo de tempo em que a promoção estará ativa.                 | O **início** e **fim** as datas 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 que a promoção é válida online ou na loja.                                        | <p>Valores suportados:</p><p>• <code>online</code></p><p>• <code>na\_loja</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Tipo de Código de Oferta `[offer_type]`      | Sim          | Este atributo indica se um código de cupom é necessário ou não para os clientes resgatarem a oferta.   | <p>Valores suportados:</p><p>• <code>sem\_código</code></p><p>• <code>código\_genérico</code></p><p><strong>Importante:</strong> Se o valor para este atributo for <code>código\_genérico</code>, então <code>código\_de\_resgate\_genérico</code> é necessá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 suportados:</p><p>• <code>Anúncios\_de\_compra</code></p><p>• <code>Listagens\_Comprar\_no\_Google</code></p><p>• <code>Listagens\_grátis</code></p><p>Para enviar sua promoção para um ou mais destinos, envie cada valor de destino como uma coluna separada.</p>                                                                                                                                                                                                                                                                                                                                                          |

</details>

#### Solução de problemas de mensagens de erro e aviso

<details>

<summary>Ver erros e avisos</summary>

Na *Promoções de Produtos* tela, sob o *Saúde* coluna, selecione *erros* ou *avisos* para ver mais informações sobre o erro, como o tipo de erro ou a mensagem de erro. Veja [Gerencie Seus Arquivos de Promoção de Produto](https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/product-promotions/manage-your-product-promotion-files) para mais informações sobre o *Saúde* do seu arquivo de promoção.

</details>

<details>

<summary>Pesquisar e filtrar erros</summary>

Você pode clicar no arquivo *erros* e *avisos* e usar o campo de pesquisa e os filtros para classificar todos os erros do arquivo de promoção carregado.

*Tipo de Erro* os filtros incluem:

* 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):{Campo obrigatório}     | Um ou mais dos campos obrigatórios estão ausentes no arquivo de upload.             |
| Registros ignorados devido a uma data de vigência expirada | A data de término efetiva da promoção está no passado e esse registro foi ignorado. |

</details>
