# Upload em Massa de Códigos Promocionais

Se você quiser criar vários códigos promocionais, use o **Upload em Massa** recurso para enviar um arquivo CSV, XLS ou XLSX com os dados do seu código promocional.

Consulte a *tabelas de referência para upload em massa de código promocional* abaixo para ajudar a estruturar este arquivo. Para garantir que o envio seja bem-sucedido, mantenha o tamanho do arquivo abaixo de 1 MB para XLS/XLSX ou 5 MB para CSV. A validação é baseada estritamente no tamanho do arquivo, portanto não há um limite específico para o número de linhas.

{% hint style="warning" %}
**Aviso:** Certifique-se de que os cabeçalhos das colunas no seu arquivo CSV/XLS correspondam exatamente aos nomes das colunas abaixo (sensível a maiúsculas e minúsculas e espaços); caso contrário, o upload do arquivo poderá ser rejeitado.
{% endhint %}

{% hint style="info" %}
**Exemplo:** O exemplo abaixo é de um código promocional de exemplo `10PEROFF`.

```programlisting
Código Promocional,ID da Campanha,ID da Mídia,Tipo,Regra de Crédito,Modo de Correspondência,Oferta
Name10PEROFF,4321,1299679,TRACKING,ALWAYS,LI,
```

{% endhint %}

#### Upload em massa de códigos promocionais de tracking

1. No menu de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[Engage]** → **Conteúdo** → **Códigos Promocionais**.
2. Na *Códigos Promocionais* na tela, selecione **Upload em Massa**.
3. Selecione **Escolher arquivo** e então localize e selecione o arquivo Excel/CSV com os códigos promocionais que você deseja enviar.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Observação:</strong> Certifique-se de que seu arquivo use o formato de coluna obrigatório mostrado na tabela abaixo.</p></div>

   | Coluna                  | Tipo    | Obrigatório | Descrição                                                                                                                                                                  |
   | ----------------------- | ------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Código Promocional      | String  | Sim         | O código promocional exclusivo a ser atribuído.                                                                                                                            |
   | ID do Programa          | Inteiro | Sim         | O ID exclusivo do programa impact.com ao qual o anúncio pertence.                                                                                                          |
   | ID da Mídia             | Inteiro | Sim         | O ID da mídia impact.com ao qual o código promocional será atribuído. Isso pode ser o ID do parceiro ou o ID da fonte de mídia.                                            |
   | Tipo                    | String  | Sim         | <p>O tipo de código promocional. Valores permitidos:</p><p><code>TRACKING</code></p>                                                                                       |
   | Regra de crédito        | String  | Sim         | <p>A regra de crédito do código promocional. Valores permitidos:</p><p><code>ALWAYS</code></p><p><code>INVOLVED</code></p><p><code>WINNER</code></p>                       |
   | Modo de correspondência | String  | Sim         | <p>O modo de correspondência do código promocional. Valores permitidos:</p><p><code>LI</code> (Exato/Literal)</p><p><code>RE</code> (Regex/Expressão Regular)</p>          |
   | ID da Oferta            | Inteiro | Não         | O ID exclusivo da oferta à qual este código promocional deve ser associado. A oferta já deve existir no seu programa.                                                      |
   | Data de início ativa    | Data    | Não         | Oferece a você a capacidade de agendar esta restrição. Este é um [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) Data. Formato de exemplo: `2013-06-30T00:00:00-07:00`   |
   | Data de término ativa   | Data    | Não         | Esta é uma data ISO8601. Formato de exemplo: `2013-06-30T00:00:00-07:00`                                                                                                   |
   | Fuso horário            | String  | Não         | O fuso horário é derivado da data de início, mas se você quiser substituí-lo por um fuso horário específico, digite o nome completo aqui, por exemplo, `America/New_York`. |

   Cada código promocional de tracking enviado só pode ser atribuído a 1 parceiro ou fonte de mídia por meio do `ID da Mídia` campo. Se outro parceiro promover esse código, a impact.com sinaliza a conversão resultante como uma conversão inválida e a reverte.
4. Selecione **Próximo**.
5. Revise a lista de códigos promocionais que serão enviados. Se os detalhes estiverem corretos, selecione **Aceitar e Criar Códigos Promocionais**.
6. Se o upload for bem-sucedido, os novos *códigos promocionais de tracking* são criados e listados no *Códigos Promocionais* .

#### campos de upload em massa de código promocional restrito

{% hint style="info" %}
**Observação:** Como parte das melhorias contínuas da plataforma, estamos descontinuando o *recurso de Códigos Promocionais Restritos* no final de fevereiro. Revise suas configurações atuais e planeje-se adequadamente.
{% endhint %}

Antes de começar, entenda a diferença entre os dois tipos de restrição:

* **Lista Branca**
  * Objetivo: definir uma lista de códigos promocionais que devem ser usados para que um Parceiro receba crédito por uma venda.
  * Isso é recomendado se sua lista autorizada de códigos promocionais for menor do que sua lista não autorizada.
* **Lista Negra**
  * Objetivo: definir uma lista de códigos promocionais que, se usados, não darão crédito de uma venda a um Parceiro.
  * Isso é recomendado se sua lista não autorizada de códigos promocionais for menor do que sua lista autorizada.

**Etapa 1: Escolha o tipo de restrição**

1. No menu de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[Engage]** → **Conteúdo** → **Códigos Promocionais**.
2. Na *Códigos Promocionais* na tela, selecione **Criar Código Promocional** ![](/files/fd163b7ecfbcabc8d4b0b2247a6ffecec5a92253) **\[Menu suspenso]** → **Restrito**.
3. Na *Restrições de Códigos Promocionais* da página, selecione ![](/files/f04b408fd368673af7defa3c8a7a0cac711f0eb8) **Configurar Restrições de Códigos Promocionais**.
4. A página de Restrições de Código Promocional aparece, exibindo duas colunas para configuração:
   * Opcionalmente, selecione ![](/files/f04b408fd368673af7defa3c8a7a0cac711f0eb8) **Configurar Lista Branca**, para enviar códigos promocionais da lista branca.
   * Opcionalmente, selecione ![](/files/f04b408fd368673af7defa3c8a7a0cac711f0eb8) **Configurar Lista Negra**, para enviar códigos promocionais da lista negra.

**Etapa 2: Envie seu arquivo**

1. Selecione **Escolher arquivo**, depois localize e selecione o arquivo Excel/CSV com os códigos promocionais restritos que você deseja enviar.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Observação:</strong> Certifique-se de que seu arquivo use o formato de coluna obrigatório mostrado na tabela abaixo.</p></div>

   | Coluna                  | Tipo    | Obrigatório | Descrição                                                                                                                                                                  |
   | ----------------------- | ------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Código Promocional      | String  | Sim         | O código promocional exclusivo a ser atribuído.                                                                                                                            |
   | ID do Programa          | Inteiro | Sim         | O ID exclusivo do programa impact.com ao qual o anúncio pertence.                                                                                                          |
   | Tipo                    | String  | Sim         | <p>O tipo de código promocional. Valor permitido:</p><p><code>RESTRICTED</code></p>                                                                                        |
   | Modo de correspondência | String  | Sim         | <p>O código de correspondência do código promocional. Valores permitidos:</p><p><code>LI</code> (Exato/Literal)</p><p><code>RE</code> (Regex/Expressão Regular)</p>        |
   | Data de início ativa    | Data    | Não         | Oferece a você a capacidade de agendar esta restrição. Esta é uma data ISO8601. Formato de exemplo: `2013-06-30T00:00:00-07:00`.                                           |
   | Data de término ativa   | Data    | Não         | Esta é uma data ISO8601. Formato de exemplo: `2013-06-30T00:00:00-07:00`                                                                                                   |
   | Fuso horário            | String  | Não         | O fuso horário é derivado da data de início, mas se você quiser substituí-lo por um fuso horário específico, digite o nome completo aqui, por exemplo, `America/New_York`. |
2. Selecione **Próximo**.
3. Revise a lista de códigos restritos exibida no *Upload em Massa de Códigos Promocionais* .
   * Opcionalmente, para ver apenas as entradas que contêm erros, selecione **Mostrar apenas erros**.
4. Se os detalhes estiverem corretos, selecione **Aceitar e Criar Códigos Promocionais**.

**Etapa 3: Adicione exceções de parceiros de mídia**

1. Na *Controles de Parceiros de Mídia* página, escolha como as regras de restrição serão aplicadas:
   1. Opcionalmente, selecione **Aplicar a todos os parceiros**, se você quiser que esta regra se aplique a todos.
   2. Opcionalmente, selecione **Permitir que certos parceiros ignorem esta regra e recebam crédito por códigos promocionais restritos**.

      Se você escolher permitir uma exceção, selecione **Pesquisar** e então selecione e **Adicionar** os parceiros específicos da lista.
2. Selecione **Salvar e Ativar**.
3. A nova regra de Código Promocional Restrito é ativada e os códigos enviados são aplicados ao escolhido *Lista Branca* ou *Lista Negra*.


---

# Agent Instructions: 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:

```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/promo-codes/bulk-upload-promo-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
