> 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/ads/manage-ads/bulk-upload-assets.md).

# Fazer upload em massa de ativos

Use a ferramenta de envios em massa para enviar vários ativos de uma vez usando um arquivo CSV, em vez de enviar os ativos individualmente. Os campos de ინფორმაცია são semelhantes ao [objeto de anúncios](https://integrations.impact.com/brand-api-reference/reference/ads) para ajudar você a coordenar quais informações vão em cada lugar.

**Você precisará de dois arquivos para realizar um envio em massa de anúncios:**

* Um arquivo de metadados do ativo (CSV)
* Arquivos criativos (por exemplo, imagens ou vídeos)

{% stepper %}
{% step %}
**Etapa 1: Prepare o arquivo de metadados do ativo**

Há campos obrigatórios e valores aceitos para o arquivo CSV que você enviar. Seus ativos aparecerão exatamente como o seu arquivo, então qualquer espaço, sinal de pontuação ou caractere especial estará presente se for usado. Para começar, copie o modelo CSV exibido abaixo e cole-o em um aplicativo de planilha ou![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1c990ed7d1179d6bc54ec8a2f98688d63ffdf977%2F1ca7fd10d94ed494c076e86be8f0d3f371693b11c47f1b26ec0435a27e0e48c5.svg?alt=media)[baixe-o aqui](https://res.cloudinary.com/product-enablement/raw/upload/v1765961581/CSVs/Assets/Bulk_upload_ads_template_-_Sheet1.csv) e importe-o diretamente.

```csv
Operation,AdID,State,Name,Description,ProgramId,AdType,HostedBy,Creative,IabAdUnit,ThirdPartyServableAdCreativeHeight,ThirdPartyServableAdCreativeWidth,Labels,AllowDeepLinking,AllowCustomPromoCode,CustomisationCharge,ImageAlternativeTag,LandingPage,iOSMobileFallbackAppId,AndroidMobileFallbackAppId,Language,LimitedTimeStartDate,LimitedTimeEndDate,FallbackAd,GetHtmlCodeType,Season,TopSeller,LinkText,ThirdPartyImpressionPixel,RestrictedToPartners,RestrictedToGroups,Metadata,DealId,DealName,DealType,DealScope,DealDescription,DealProducts,DealCategories,DealDefaultDiscountCode,DealLandingPage,DealMetadata,DealAllowDeepLinking,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes

```

{% hint style="info" %}
**Dica:** Recomendamos usar o *formato do arquivo* detalhes disponíveis na [*Envio em Massa*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) tela para conferir suas entradas antes de enviar!
{% endhint %}

Antes de criar ou atualizar ativos usando um arquivo de metadados, observe os seguintes pontos importantes sobre atualizações parciais:

* Atualizações parciais são suportadas. Se você deixar uma célula em branco, esse campo será ignorado e o valor existente permanecerá inalterado.
* Para limpar ou apagar um valor, insira explicitamente `$CLEAR$` nessa célula. Isso remove qualquer valor armazenado anteriormente para esse campo.

```csv
Operation,AdID,Name,Description,ProgramId,AdType,HostedBy,Creative,IabAdUnit,ThirdPartyServableAdCreativeHeight,ThirdPartyServableAdCreativeWidth,Labels,AllowDeepLinking,AllowCustomPromoCode,CustomisationCharge,ImageAlternativeTag,LandingPage,iOSMobileFallbackAppId,AndroidMobileFallbackAppId,Language,LimitedTimeStartDate,LimitedTimeEndDate,LimitedTimeZone,FallbackAd,GetHtmlCodeType,Season,TopSeller,LinkText,ThirdPartyImpressionPixel,RestrictedToPartners,RestrictedToGroups,Metadata,DealId,DealName,DealType,DealScope,DealDescription,DealProducts,DealCategories,DealDefaultDiscountCode,DealLandingPage,DealMetadata,DealAllowDeepLinking,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes
CREATE,,Exemplo de banner,Este é um exemplo de um novo anúncio de banner que você enviaria.,12345,BANNER,IR,Banner_Creative1,,,,"Banner, NewBanner",TRUE,,,,,,,ENGLISH,2020-07-01T00:00:00-08:00,2038-09-19T03:14:00-08:00,FRAME_ONLY,,,,,"1234567, 8901234",,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,,,,,
UPDATE,123456,Exemplo de link de texto,Este é um exemplo de atualização de um anúncio de link de texto.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Clique aqui para saber mais!,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,

```

* O `CREATE` a linha mostra um novo ativo de banner.
* O `UPDATE` a linha demonstra uma atualização parcial — apenas os campos preenchidos serão atualizados.
* Se você quisesse limpar um valor (por exemplo, remover `Rótulos`), você usaria `$CLEAR$` nesse campo.

Exemplo de limpeza de campos (CSV):

```csv
UPDATE,123456,Exemplo de link de texto,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
```

{% endstep %}

{% step %}
**Etapa 2: Envie o arquivo de metadados do ativo**

1. Na barra de navegação à esquerda, selecione ![\[Engage\] v2](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-aa671735ec2b65af79961eaf59ab60af.svg) **\[Engage]** → **Conteúdo** → [**Anúncios**](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml)**.**
2. No canto superior direito, selecione **Envio em Massa**.
3. Selecione  **Escolher arquivo**, envie seu arquivo em massa e selecione **Abrir**.
   * Selecione  **Mostrar/ocultar detalhes do formato do arquivo** para ver informações sobre as colunas obrigatórias, suas descrições, valores aceitos e se elas são obrigatórias no *colunas de cabeçalho de anúncio* e *colunas de cabeçalho de oferta* referências abaixo.

{% hint style="success" icon="memo" %}
**Observação:** a impact.com avisará você se houver algum erro no arquivo.
{% endhint %}

4. Selecione **Próximo**.

<details>

<summary>colunas de cabeçalho de anúncio</summary>

| Nome da coluna                                                                                                                     | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>Operação</em> (Texto)</p><p>Obrigatório - sempre.</p>                                                                       | <p>Operação a ser executada sobre os detalhes do ativo fornecidos.</p><p>Valores permitidos:</p><p><code>CREATE</code>, <code>UPDATE</code>, <code>DELETE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>ID do programa</em> (Inteiro)</p><p>Obrigatório - sempre.</p>                                                               | O identificador exclusivo da impact.com para o ativo. Esse valor não pode ser atualizado e deve corresponder ao programa em que o envio em massa está sendo executado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>ID do anúncio</em> (Texto)</p><p>Obrigatório - ao executar a operação em um ativo existente.</p>                            | Identificador exclusivo da impact.com para o ativo. Deixe em branco ao criar um novo ativo. Obrigatório se *Operação* = `UPDATE`, `DELETE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Estado</em> (Texto)</p><p>Obrigatório - Não.</p>                                                                            | <p>O estado do ativo.</p><p>Valores permitidos:</p><p><code>ATIVO</code>, <code>PENDENTE</code>, <code>EXPIRADO</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Nome</em> (Texto)</p><p>Obrigatório - ao criar um ativo.</p>                                                                | *Nome do ativo*. Obrigatório se *Operação* = `CREATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>AdType</em> (Texto)</p><p>Obrigatório - ao criar um ativo.</p>                                                              | <p>Ao atualizar um anúncio existente, o tipo de anúncio não pode ser alterado.</p><p>Obrigatório se <em>Operação</em> = <code>CREATE</code>.</p><p>Valores permitidos:</p><p><code>IMAGEM</code>, <code>LINK\_DE\_TEXTO</code>, <code>CUPOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>Hospedado por</em> (Texto)</p><p>Obrigatório - ao criar um ativo de imagem.</p>                                             | <p>Onde o criativo do ativo está hospedado. Obrigatório se</p><p><em>Operação</em> = <code>CREATE</code> e <em>AdType</em> = <code>IMAGEM</code>.</p><p>Valores permitidos:</p><p><code>IR</code>, <code>URL</code>, <code>HTML</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Criativo</em> (Texto)</p><p>Obrigatório - ao criar um ativo de imagem.</p>                                                  | <p>Nome do arquivo criativo a ser enviado. Obrigatório se</p><p><em>Operação</em> = <code>CREATE</code> e <em>AdType</em> = <code>IMAGEM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>Unidade de anúncio IAB</em> (Texto)</p><p>Obrigatório - ao criar um ativo de imagem.</p>                                    | <p>Tamanho padrão de ativo IAB. Obrigatório se <em>Operação</em> =</p><p><code>CREATE</code> e <em>AdType</em> = <code>IMAGEM</code> e <em>Hospedado por</em> != <code>IR</code>.</p><p>Valores permitidos: <code>DESCONHECIDO</code>, <code>RETÂNGULO\_MÉDIO</code>, <code>POP\_UP\_QUADRADO</code>, <code>RETÂNGULO\_VERTICAL</code>, <code>RETÂNGULO\_GRANDE</code>, <code>RETÂNGULO</code>, <code>RETÂNGULO\_3\_1\_</code>, <code>POP\_UNDER, BANNER\_COMPLETO</code>, <code>MEIO\_BANNER, MICRO\_BANNER</code>, <code>BOTÃO\_1</code>, <code>BOTÃO\_2</code>, <code>BANNER\_VERTICAL</code>, <code>BOTÃO\_QUADRADO</code>, <code>PAINEL\_HORIZONTAL</code>, <code>ARRANHA-CÉU\_LARGO</code>, <code>ARRANHA-CÉU</code>, <code>ANÚNCIO\_DE\_MEIA\_PÁGINA</code>, <code>PERSONALIZADO</code>.</p>                                                                                                                                                                                                                                                                    |
| <p><em>Altura do criativo do anúncio veiculável por terceiros</em> (Inteiro)</p><p>Obrigatório - ao criar um ativo de imagem.</p>  | <p>Altura da imagem veiculável por terceiros, em pixels.</p><p>Obrigatório se <em>Operação</em> = <code>CREATE</code> e <em>Unidade de anúncio IAB</em> =</p><p><code>PERSONALIZADO</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>Largura do criativo do anúncio veiculável por terceiros</em> (Inteiro)</p><p>Obrigatório - ao criar um ativo de imagem.</p> | <p>Largura da imagem veiculável por terceiros, em pixels.</p><p>Obrigatório se <em>Operação</em> = <code>CREATE</code> e <em>Unidade de anúncio IAB</em> =</p><p><code>PERSONALIZADO</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>Idioma</em> (Texto)</p><p>Obrigatório - ao criar um ativo.</p>                                                              | <p>Valores permitidos:</p><p><code>AFRICÂNS</code>, <code>ÁRABE</code>, <code>BÚLGARO</code>, <code>CHINÊS</code>, <code>CHINÊS\_TRADICIONAL</code>, <code>TCHECO</code>, <code>DINAMARQUÊS</code>, <code>HOLANDÊS</code>, <code>INGLÊS</code>, <code>INGLÊS\_GB</code>, <code>INGLÊS\_AU</code>, <code>INGLÊS\_CA</code>, <code>INGLÊS\_NZ</code>, <code>INGLÊS\_ZA</code>, <code>ESTONIANO</code>, <code>FILIPINO</code>, <code>FINLANDÊS</code>, <code>FRANCÊS</code>, <code>FRANCÊS\_CA</code>, <code>ALEMÃO</code>, <code>HEBRAICO</code>, <code>HÍNDI</code>, <code>INDONÉSIO</code>, <code>ITALIANO</code>, <code>JAPONÊS</code>, <code>COREANO</code>, <code>LETÃO</code>, <code>LITUANO</code>, <code>MALAIO</code>, <code>MALTÊS</code>, <code>NORUEGUÊS</code>, <code>PORTUGUÊS</code>, <code>PORTUGUÊS\_BR</code>, <code>POLONÊS</code>, <code>RUSSO</code>, <code>ESLOVENO</code>, <code>ESPANHOL</code>, <code>ESPANHOL\_MX</code>, <code>SUECO</code>, <code>TAILANDÊS</code>, <code>TURCO</code>, <code>VIETNAMITA</code>.</p>                         |
| <p><em>Data de término por tempo limitado</em> (Data)</p><p>Obrigatório - se LimitedTimeStartDate for informado</p>                | Esta é uma data ISO8601. Formato de exemplo: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Texto do link</em> (Texto)</p><p>Obrigatório - ao criar um ativo de link de texto ou cupom.</p>                             | Texto real exibido para o link. Obrigatório se *Operação* = `CREATE` e *AdType* = `LINK_DE_TEXTO` ou `CUPOM`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Descrição</em></p><p>Obrigatório - Não.</p>                                                                                 | Descrição do ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Rótulos</em> (string CSV)</p><p>Obrigatório - Não.</p>                                                                      | Etiquetas do ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Permitir deep linking</em> (Booleano)</p><p>Obrigatório - Não.</p>                                                          | <p>Determina se será permitido vincular a uma página mais profunda dentro do site do anunciante.</p><p>Padrão para <code>verdadeiro</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>Permitir código promocional personalizado</em> (Booleano)</p><p>Obrigatório - Não.</p>                                      | <p>Permite que o parceiro solicite seu próprio código promocional exclusivo para esta promoção.</p><p>Padrão para <code>falso</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Cobrança de personalização</em> (Decimal 10,2)</p><p>Obrigatório - Não.</p>                                                 | Valor da cobrança de personalização do ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Tag alternativa da imagem</em> (Texto)</p><p>Obrigatório - Não.</p>                                                         | Tag alternativa a ser usada no código do ativo de imagem.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Página de destino</em> (Texto)</p><p>Obrigatório - Não.</p>                                                                 | <p>A URL da página de destino. Ela deve conter o protocolo da URL.</p><p>Padrão para a página de destino padrão do programa ao criar um ativo, quando não for fornecida.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>ID do app de fallback móvel para iOS</em> (Texto)</p><p>Obrigatório - Não.</p>                                              | Especifique se o tráfego móvel deve redirecionar para a página de destino do seu app iOS se nenhum app for detectado. O ID do app deve corresponder ao ID do app do sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>ID do app de fallback móvel para Android</em> (Texto)</p><p>Obrigatório - Não.</p>                                          | Especifique se o tráfego móvel deve redirecionar para a página de destino do seu app Android se nenhum app for detectado. O ID do app deve corresponder ao ID do app do sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>Data de início por tempo limitado</em> (Texto)</p><p>Obrigatório - Não.</p>                                                 | Esta é uma data ISO8601. Formato de exemplo: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Anúncio de fallback</em> (Texto)</p><p>Obrigatório - Não.</p>                                                               | Especifique um ID de ativo de fallback, aplicável apenas a `IMAGEM` ativos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Tipo de código HTML a obter</em> (Texto)</p><p>Obrigatório - Não.</p>                                                       | Valores permitidos: `SOMENTE_IFRAME`, `HTML_E_IFRAME`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>Temporada</em> (Texto)</p><p>Obrigatório - Não.</p>                                                                         | <p>Valores permitidos:</p><p><code>INVERNO</code>, <code>PRIMAVERA</code>, <code>VERÃO</code>, <code>OUTONO</code>, <code>ANO\_NOVO</code>, <code>DIA\_DOS\_PRESIDENTES</code>, <code>DIA\_DOS\_NAMORADOS</code>, <code>DIA\_DE\_SÃO\_PATRÍCIO</code>, <code>PÁSCOA</code>, <code>DIA\_DAS\_MÃES</code>, <code>DIA\_DA\_MEMÓRIA</code>, <code>DIA\_DOS\_PAIS</code>, <code>DIA\_DA\_INDEPENDÊNCIA</code>, <code>VOLTA\_ÀS\_AULAS</code>, <code>DIA\_DO\_TRABALHO</code>, <code>HALLOWEEN</code>, <code>DIA\_DE\_AÇÃO\_DE\_GRAÇAS</code>, <code>BLACK\_FRIDAY</code>, <code>CYBER\_MONDAY</code>, <code>HANUCÁ</code>, <code>NATAL</code>, <code>DIA\_DA\_FAMÍLIA</code>, <code>SEXTA-FEIRA\_SANTA</code>, <code>DIA\_DA\_VITÓRIA</code>, <code>DIA\_DO\_CANADÁ</code>, <code>FERIADO\_CÍVICO\_DE\_AGOSTO</code>, <code>DIA\_DA\_LEMBRANÇA</code>, <code>BOXING\_DAY</code>, <code>DIA\_DA\_AUSTRÁLIA</code>, <code>DIA\_ANZAC</code>, <code>ANIVERSÁRIO\_DA\_RAINHA</code>, <code>FIM\_DO\_ANO\_FISCAL</code>, <code>DIA\_DE\_WAITANGI</code>, <code>OUTRO</code>.</p> |
| <p><em>Mais vendido</em> (Booleano)</p><p>Obrigatório - Não.</p>                                                                   | Mais vendido. Padrão para `falso`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Pixel de impressão de terceiros</em> (Texto)</p><p>Obrigatório - Não.</p>                                                   | HTML do pixel de impressão de terceiros a ser usado com este ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Restrito a parceiros</em> (string CSV)</p><p>Obrigatório - Não.</p>                                                         | IDs de parceiros separados por vírgula que devem ter acesso a este ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Restrito a grupos</em> (string CSV)</p><p>Obrigatório - Não.</p>                                                            | IDs de grupos de parceiros separados por vírgula que devem ter acesso a este ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Metadados</em> (string CSV)</p><p>Obrigatório - Não.</p>                                                                    | Parâmetros de string de consulta separados por vírgula que serão adicionados à URL de rastreamento.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

</details>

<details>

<summary>colunas de cabeçalho de oferta</summary>

| Nome da coluna                                                                                                            | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>Nome da oferta</em> (Texto)</p><p>Obrigatório - ao criar uma nova oferta.</p>                                      | Nome da oferta a ser criada e vinculada ao ativo. Obrigatório se *ID da oferta* não for fornecido.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>Tipo da oferta</em> (Texto)</p><p>Obrigatório - ao criar uma nova oferta.</p>                                      | <p>Tipo de oferta a ser criada. Obrigatório se <em>ID da oferta</em> não for fornecido e DealName for.</p><p>Valores permitidos:</p><p><code>VENDA\_GERAL</code>,<code>FRETE\_GRÁTIS</code>, <code>BRINDE\_COM\_COMPRA</code>, <code>REEMBOLSO</code>, <code>COMPRE\_1\_E\_LEVE\_1</code>, <code>LANÇAMENTO\_DE\_PRODUTO</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>Escopo da oferta</em> (Texto)</p><p>Obrigatório - ao criar uma nova oferta.</p>                                    | <p>Obrigatório se <em>ID da oferta</em> não for fornecido, <em>Nome da oferta</em> for, e <em>Tipo da oferta</em> != BOGO.</p><p>Valores permitidos:</p><p><code>LOJA\_INTEIRA</code>, <code>CATEGORIA</code>, <code>PRODUCT</code>, <code>PRODUTOS</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Produtos da oferta</em> (string CSV)</p><p>Obrigatório - ao criar uma nova oferta.</p>                             | <p>Produtos da oferta. Obrigatório se <em>ID da oferta</em> não for fornecido, <em>Nome da oferta</em> for, e <em>Escopo da oferta</em> = <code>PRODUCT</code>.</p><p>Valores permitidos:</p><p>Opção 1: lista de nomes de produtos, por exemplo: <code>"Produto1, Produto2"</code>.</p><p>Opção 2: lista de pares de valores do produto, por exemplo: <code>"name=Produto1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Produto2;"</code> em que os vários produtos são separados por vírgula e os diversos campos do produto são separados por ponto e vírgula.</p><p>Campos válidos: <code>nome</code> - nome do produto, <code>imagem</code> - nome do arquivo de imagem do produto que você pretende enviar na etapa dois do envio em massa, <code>limite</code> - quantidade permitida, <code>preço regular</code> - preço antes do desconto, <code>preço da oferta</code> - preço após o desconto.</p> |
| <p><em>Categorias da oferta</em> (string CSV)</p><p>Obrigatório - ao criar uma nova oferta.</p>                           | Categorias da oferta. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, e *Escopo da oferta* = `CATEGORIA`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Página de destino da oferta (String)</em><br>Obrigatório - Não</p>                                                 | A URL da página de destino desta oferta. Se for deixado em branco ao criar uma nova oferta, será usada a página de destino padrão do programa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Metadados da oferta (string CSV)</em><br>Obrigatório - Não</p>                                                     | Parâmetros de string de consulta separados por vírgula para o link de rastreamento da oferta. Se for deixado em branco, nenhum parâmetro extra será adicionado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Permitir deep linking da oferta (Booleano)</em><br>Obrigatório - Não</p>                                           | Determina se o deep linking é permitido para a página de destino da oferta. Se for deixado em branco, o padrão será FALSE.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>Tipo de desconto da oferta</em> (string CSV)</p><p>Obrigatório - ao criar uma nova oferta.</p>                     | <p>Obrigatório se <em>ID da oferta</em> não for fornecido, <em>Nome da oferta</em> for, e <em>Tipo da oferta</em> = VENDA\_GERAL.</p><p>Valores permitidos:</p><p><code>FIXO</code>, <code>PERCENTUAL</code>, <code>FAIXA\_PERCENTUAL</code>, <code>PERCENTUAL\_MÁXIMO</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>Valor do desconto da oferta</em> (Decimal 10,2)</p><p>Obrigatório - ao criar uma nova oferta.</p>                  | Valor do desconto da promoção. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, *Tipo da oferta* = `VENDA_GERAL`, e *Tipo de desconto da oferta* = `FIXO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Percentual de desconto da oferta</em> (Decimal 10,2)</p><p>Obrigatório - ao criar uma nova oferta.</p>             | Percentual de desconto da promoção. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, *Tipo da oferta* = `VENDA_GERAL`, e *Tipo de desconto da oferta* = `PERCENTUAL`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>Percentual inicial do desconto da oferta</em> (Decimal 10,2)</p><p>Obrigatório - ao criar uma nova oferta.</p>     | Percentual inicial da faixa de desconto da oferta. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, *Tipo da oferta* = `VENDA_GERAL`, e *Tipo de desconto da oferta* = `FAIXA_PERCENTUAL`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Percentual final do desconto da oferta</em> (Decimal 10,2)</p><p>Obrigatório - ao criar uma nova oferta.</p>       | Percentual inicial da faixa de desconto da oferta. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, *Tipo da oferta* = `VENDA_GERAL`, e *Tipo de desconto da oferta* = `FAIXA_PERCENTUAL`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Percentual máximo de desconto da oferta</em> (Decimal 10,2)</p><p>Obrigatório - ao criar uma nova oferta.</p>      | Percentual máximo de desconto da oferta. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, *Tipo da oferta* = `VENDA_GERAL`, e *Tipo de desconto da oferta* = `PERCENTUAL_MÁXIMO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>Brinde da oferta</em> (Texto)</p><p>Obrigatório - ao criar uma nova oferta.</p>                                    | Detalhes do brinde. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, e *Tipo da oferta* = `BRINDE_COM_COMPRA`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>Reembolso da oferta</em> (Decimal 10,2)</p><p>Obrigatório - ao criar uma nova oferta.</p>                          | Valor do reembolso. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, e *Tipo da oferta* = `REEMBOLSO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Valor mínimo de compra da oferta</em> (Decimal 10,2)</p><p>Obrigatório - ao criar uma nova oferta.</p>             | Valor mínimo de compra da oferta. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, e *Tipo da oferta* = `COMPRE_1_E_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>Valor máximo de economia da oferta</em> (Decimal 10,2)</p><p>Obrigatório - ao criar uma nova oferta.</p>           | Valor máximo de economia da oferta. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, e *Tipo da oferta* = `COMPRE_1_E_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>Limite de compra BOGO da oferta</em> (Inteiro)</p><p>Obrigatório - ao criar uma nova oferta.</p>                   | Quantidade máxima de itens permitidos a este preço. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, e *Tipo da oferta* = `COMPRE_1_E_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>Quantidade de compra BOGO da oferta</em> (Inteiro)</p><p>Obrigatório - ao criar uma nova oferta.</p>               | Quantidade de compra do BOGO. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, e *Tipo da oferta* = `COMPRE_1_E_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Tipo de item de compra BOGO da oferta</em> (Texto)</p><p>Obrigatório - ao criar uma nova oferta.</p>               | <p>Tipo de item de compra do BOGO. Obrigatório se <em>ID da oferta</em> não for fornecido, <em>Nome da oferta</em> for, e <em>Tipo da oferta</em> = <code>COMPRE\_1\_E\_LEVE\_1</code>.</p><p>Valores permitidos:</p><p><code>PRODUCT</code>, <code>CATEGORIA</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>Nome de compra BOGO da oferta</em> (Texto)</p><p>Obrigatório - ao criar uma nova oferta.</p>                       | Nome do produto ou categoria de compra. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, e *Tipo da oferta* = `COMPRE_1_E_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>Quantidade de recebimento BOGO da oferta</em> (Inteiro)</p><p>Obrigatório - ao criar uma nova oferta.</p>          | Quantidade de recebimento do BOGO. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, e *Tipo da oferta* = `COMPRE_1_E_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>Tipo de item de recebimento BOGO da oferta</em> (Texto)</p><p>Obrigatório - ao criar uma nova oferta.</p>          | <p>Tipo de item de recebimento do BOGO. Obrigatório se <em>ID da oferta</em> não for fornecido, <em>Nome da oferta</em> for, e <em>Tipo da oferta</em> = <code>COMPRE\_1\_E\_LEVE\_1</code>.</p><p>Valores permitidos:</p><p><code>PRODUCT</code>, <code>CATEGORIA</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Nome de recebimento BOGO da oferta</em> (Texto)</p><p>Obrigatório - ao criar uma nova oferta.</p>                  | Nome do produto ou categoria recebida. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, e *Tipo da oferta* = `COMPRE_1_E_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>Tipo de desconto do item recebido no BOGO da oferta</em> (Texto)</p><p>Obrigatório - ao criar uma nova oferta.</p> | <p>Tipo de desconto da promoção BOGO. Obrigatório se <em>ID da oferta</em> não for fornecido, <em>Nome da oferta</em> for, e <em>Tipo da oferta</em> = <code>COMPRE\_1\_E\_LEVE\_1</code>.</p><p>Valores permitidos:</p><p><code>GRÁTIS</code>, <code>VALOR</code>, <code>PERCENTUAL</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>DealBogoGetDiscountAmount</em> (Decimal 10,2)</p><p>Obrigatório - ao criar uma nova oferta.</p>                    | Valor do desconto da promoção BOGO. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, *Tipo da oferta* = `COMPRE_1_E_LEVE_1`, e *Tipo de desconto do item recebido no BOGO da oferta* = `VALOR`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>DealBogoGetDiscountPercent</em> (Decimal 10,2)</p><p>Obrigatório - ao criar uma nova oferta.</p>                   | Percentual de desconto da promoção BOGO. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, *Tipo da oferta* = `COMPRE_1_E_LEVE_1`, e *Tipo de desconto do item recebido no BOGO da oferta* = `PERCENTUAL`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>ID da oferta</em> (Texto)</p><p>Obrigatório - Não.</p>                                                             | Identificador exclusivo da impact.com para a oferta à qual o ativo será vinculado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>DealDefaultDiscountCode</em> (Texto)</p><p>Obrigatório - Não.</p>                                                  | Código de desconto padrão da oferta.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealSyncAdsPromoCodes</em> (Booleano)</p><p>Obrigatório - Não.</p>                                                 | Mantenha os anúncios e códigos promocionais associados sincronizados com esta oferta. A sincronização se aplica a datas por tempo limitado, acesso restrito de parceiros e estado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

</details>
{% endstep %}

{% step %}
**Etapa 3: carregue os arquivos criativos do ativo**

Em seguida, você precisará deixar os arquivos criativos do ativo prontos para que possam ser carregados.

1. Na *Especifique imagens* página, selecione **Escolher arquivos** para fazer upload em massa dos arquivos criativos do ativo. Os nomes dos arquivos enviados devem corresponder exatamente aos nomes no campo criativo do seu arquivo de metadados (por exemplo, se o campo criativo contiver `Example.jpg`, o arquivo criativo do ativo que você enviar também deve se chamar `Example.jpg`).
   * Mantenha pressionado **Command ⌘** no macOS ou **CTRL** no PC para selecionar vários arquivos criativos do ativo para enviar de uma vez.
2. Selecione **Aceitar e criar anúncios**. Depois que todos os ativos tiverem sido enviados, eles aparecerão no [*Anúncios*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) .
   {% endstep %}
   {% endstepper %}


---

# 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/ads/manage-ads/bulk-upload-assets.md?ask=<question>&goal=<user_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.
