> 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* recurso 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 um *Oferta especial* rótulo exibido diretamente no cartão do produto nos resultados de pesquisa. {% hint style="warning" %} **Importante:** Você precisará ter um catálogo de produtos ativo antes de começar. Para ajuda na criação do seu primeiro envio de produtos, consulte [Adicionar catálogos de produtos](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md). {% endhint %} #### Enviar um arquivo de promoção {% tabs %} {% tab title="Envio 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 **Enviar arquivo de promoção**. 3. Insira os 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]** **Envio direto** método. 5. Selecione o arquivo **Formato**. * A impact.com oferece suporte apenas a *Google Merchant Center (formato TXT)* ou seja `.txt` e *Google Merchant Center (formato CSV)* ou seja `.csv` arquivos. * Consulte a [*Referência dos 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 enviar do seu computador. 7. Selecione o seu método preferido **Idioma** e **Salvar**. {% endtab %} {% tab title="Buscar de URL" %} Esta opção permite buscar um arquivo de um servidor FTP/SFTP ou de uma 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 **Enviar arquivo de promoção**. 3. Insira os 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]** **Buscar de URL** método de envio. 5. Selecione o arquivo **Formato**. * A impact.com oferece suporte apenas a *Google Merchant Center (formato TXT)* ou seja `.txt` e *Google Merchant Center (formato CSV)* ou seja `.csv` arquivos. * Consulte a [*Referência dos campos do feed de promoções de produtos*](#para-idm73509110741608) abaixo para mais informações sobre esses campos. 6. Informe o **nome** do seu arquivo em *Nome do arquivo enviado*. * [Veja este modelo](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) para orientação ao enviar suas promoções. 7. Informe o **URL de busca** que aponta para o diretório onde está o seu arquivo de dados de promoção. * Esta URL pode ser uma URL FTP ou HTTPS. Ex.: `ftp://ftp.acme.com` ou `https://acme.com/anvil_promotions/anvil.txt` 8. Selecione o **Frequência de busca** para definir com que frequência a impact.com buscará o arquivo: * Diariamente * A cada 8 horas * A cada 4 horas * A cada 2 horas 9. Selecione o **Horário de busca** em que a impact.com buscará o arquivo. * As opções exibidas estão no horário GMT -05:00 do Horário do Leste. 10. Selecione seu **Fuso horário**. 11. Selecione o seu método preferido **Idioma** e **Salvar**. {% endtab %} {% endtabs %}
Referência dos campos do feed de promoções de produtos | Campos esperados | Obrigatório? | Descrição | Formato | | -------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ID `[promotion_id]` | Sim | O ID exclusivo de cada promoção. | Este ID está no 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. |

Valores suportados:

• all\_products

• specific\_products

Observação: A impact.com só pode mapear as promoções no seu arquivo de feed de promoções do Google com produtos específicos no seu catálogo de produtos se o seu feed de produtos incluir promotion\_id. Em outras palavras, você não pode ter o specific\_products valor se o seu feed de produtos não incluir IDs de promoção.

| | Descrição `[long_title]` | Sim | O título completo de cada promoção. | O comprimento máximo do título é de 60 caracteres. Ex.: `Caneca grátis na compra`. | | Efetivo `[promotion_effective_dates]` | Sim | O período da promoção. |

• A início e fim as datas são separadas por uma barra (/).

• O formato da data é (AAAA-MM-DD), seguido da letra ‘T’, do horário em que a promoção começa ou termina e de uma expressão do fuso horário da promoção.

• Exemplo: 2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00

| | Exibição `[promotion_display_dates]` | Não | Este atributo especifica a data e o período em que a promoção ficará 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 on-line ou na loja. |

Valores suportados:

• online

• in\_store

| | Tipo de código da oferta `[offer_type]` | Sim | Este atributo indica se um código de cupom é necessário ou não para que os clientes resgatem a oferta. |

Valores suportados:

• no\_code

• generic\_code

Importante: Se o valor deste atributo for generic\_code, depois generic\_redemption\_code é obrigatório.

| | Código da oferta `[generic_redemption_code]` | Não | Este atributo especifica o código que pode ser usado on-line 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. |

Valores suportados:

• Shopping\_ads

• Buy\_on\_Google\_listings

• Free\_listings

Para enviar sua promoção para um ou mais destinos, envie cada valor de destino em uma coluna separada.

|
#### Solucionar problemas com mensagens de erro e aviso
Visualizar erros e avisos Na *Promoções de produtos* tela, na *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. Consulte [Gerenciar seus arquivos de promoção de produtos](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-promotions/manage-your-product-promotion-files.md) para mais informações sobre o *Saúde* do seu arquivo de promoção.
Pesquisar e filtrar erros Você pode clicar no arquivo *erros* e *avisos* e usar o campo de busca e os filtros para organizar todos os erros do arquivo de promoção enviado. *Tipo de erro* os filtros incluem: * Todos * Aviso * Erro * Duplicar
Mensagens de erro e aviso | Mensagem de erro | Explicação | | ------------------------------------------------------ | ---------------------------------------------------------------------- | | Campo(s) obrigatório(s) ausente(s):{Required field} | Um ou mais dos campos obrigatórios estão ausentes no arquivo enviado. | | Registros ignorados devido a uma data efetiva expirada | A data final efetiva da promoção já passou e esse registro é ignorado. |
--- # 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=&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.