# Upload em massa de códigos promocionais

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

Consulte as *tabelas de referência para upload em massa de códigos promocionais* abaixo para ajudar na estruturação deste arquivo. Para garantir que o upload 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íveis a maiúsculas e minúsculas e espaços), caso contrário o upload do seu 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
Nome10PEROFF,4321,1299679,TRACKING,ALWAYS,LI,
```

{% endhint %}

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

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) **\[Engajar]** → **Conteúdo** → **Códigos Promocionais**.
2. Na *Códigos Promocionais* tela, selecione **Upload em Massa**.
3. Selecionar **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 colunas exigido 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 do 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 estar associado. A oferta já deve existir no seu programa.                                                    |
   | Data de Início da Atividade | Data    | Não         | Oferece a você a capacidade de agendar essa restrição. Esta é uma [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) data. Formato de exemplo: `2013-06-30T00:00:00-07:00`  |
   | Data de Fim da Atividade    | 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, o impact.com marcará a conversão resultante como conversão inválida e a reverterá.
4. Selecionar **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 na *Códigos Promocionais* tela.

#### Upload em massa de campos de códigos promocionais restritos

{% hint style="info" %}
**Observação:** Como parte das melhorias contínuas da plataforma, estamos descontinuando o *Códigos Promocionais Restritos* recurso 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 creditarão 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 ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engajar]** → **Conteúdo** → **Códigos Promocionais**.
2. Na *Códigos Promocionais* tela, selecione **Criar Código Promocional** ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menu suspenso]** → **Restrito**.
3. Na *Restrições de Códigos Promocionais* página, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **Configurar Restrições de Código Promocional**.
4. A página de Restrições de Código Promocional aparece, exibindo duas colunas para configuração:
   * Opcionalmente, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **Configurar Lista Branca**, para enviar códigos promocionais na lista branca.
   * Opcionalmente, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **Configurar Lista Negra**, para enviar códigos promocionais na lista negra.

**Etapa 2: Faça upload do seu arquivo**

1. Selecionar **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 colunas exigido 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>RESTRITO</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 da Atividade | Data    | Não         | Oferece a você a capacidade de agendar essa restrição. Esta é uma data ISO8601. Formato de exemplo: `2013-06-30T00:00:00-07:00`.                                           |
   | Data de Fim da Atividade    | 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. Selecionar **Próximo**.
3. Revise a lista de códigos restritos exibidos na *Upload em Massa de Códigos Promocionais* página.
   * 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 contornem esta regra e recebam crédito por códigos promocionais restritos**.

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