> 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). # Enviar arquivos de promoção de produtos O *Promoções de Produto* este recurso permite que você compartilhe 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* 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 começar. Para obter ajuda para criar seu primeiro upload de produto, 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 %} #### Envie 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 Produto**. 2. No canto superior direito, selecione **Enviar 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** . 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 de campos do feed de promoções de produtos*](#para-idm73509110741608) abaixo para obter mais informações sobre estes campos. 6. Selecione **Escolher arquivo**. * Localize o arquivo que você deseja enviar do seu computador. 7. Selecione seu método de upload preferido **Idioma** e **Salvar**. {% endtab %} {% tab title="Obter da URL" %} Esta opção permite obter 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 Produto**. 2. No canto superior direito, selecione **Enviar 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]** **Obter da URL** de upload. 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 de campos do feed de promoções de produtos*](#para-idm73509110741608) abaixo para obter mais informações sobre estes campos. 6. Informe 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 enviar suas promoções. 7. Informe o **URL de origem** que aponta para o diretório onde existe seu arquivo de dados de promoção. * Esta URL pode ser uma URL FTP ou HTTPS. Por exemplo, `ftp://ftp.acme.com` ou `https://acme.com/anvil_promotions/anvil.txt` 8. Selecione o **Frequência de busca** com que frequência a impact.com buscará o arquivo: * Diariamente * A cada 8 hora(s) * A cada 4 hora(s) * A cada 2 hora(s) 9. Selecione o **Horário da 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 método de upload preferido **Idioma** e **Salvar**. {% endtab %} {% endtabs %}
Referência de 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. Por exemplo, `Caneca grátis na compra`. | | Vigente `[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 é (YYYY-MM-DD), seguido pela letra ‘T’, o horário em que a promoção começa ou termina e 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 intervalo de tempo 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 online 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 para que os clientes resgatem a oferta. |

Valores suportados:

• no\_code

• generic\_code

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

| | 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. |

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
Ver erros e avisos Na *Promoções de Produto* 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 [Gerencie seus arquivos de promoção de produto](/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 pesquisa e os filtros para classificar 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 de vigência expirada | A data de término da vigência da promoção está no passado 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.