> 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 produtos* O 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 cartão do produto nos resultados da 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 envio 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 %} #### Enviar um arquivo de promoção {% tabs %} {% tab title="Envio direto" %} 1. No menu de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[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 ![](/files/7e1c6d18e5a0a7c76ed315795915597447710759) **\[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 de campos do feed de promoção de produtos*](#para-idm73509110741608) abaixo para obter mais informações sobre esses campos. 6. Selecione **Escolher arquivo**. * Localize o arquivo que você deseja enviar do seu computador. 7. Selecione sua opção preferida de **Idioma** e **Salvar**. {% endtab %} {% tab title="Buscar da 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 ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[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 ![](/files/7e1c6d18e5a0a7c76ed315795915597447710759) **\[botão de opção]** **Buscar da 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 de campos do feed de promoção de produtos*](#para-idm73509110741608) abaixo para obter 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 seu arquivo de dados de promoção está localizado. * Essa 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** 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 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/sua **Fuso horário**. 11. Selecione sua opção preferida de **Idioma** e **Salvar**. {% endtab %} {% endtabs %}
Referência de campos do feed de promoção 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 nem 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 aceitos:

• 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 é 60 caracteres. Ex., `Caneca grátis na compra`. | | Vigência `[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’, pela hora do dia em que a promoção começa ou termina e por uma indicaçã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 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. |

Valores aceitos:

• online

• na\_loja

| | 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 aceitos:

• sem\_código

• código\_genérico

Importante: Se o valor deste atributo for código\_genérico, 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 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 aceitos:

• Shopping\_ads

• Buy\_on\_Google\_listings

• Free\_listings

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

|
#### Solucionar mensagens de erro e aviso
Ver erros e avisos Na *Promoções de produtos* tela, abaixo da *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 produtos](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-promotions/manage-your-product-promotion-files.md) para obter 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 final de 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.