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

# Upload em massa de ativos

Use a ferramenta de uploads em massa para enviar vários ativos de uma vez usando um arquivo CSV, em vez de enviar os ativos individualmente. Os campos de informação são semelhantes aos do [objeto de anúncios](https://integrations.impact.com/brand-api-reference/reference/ads) para ajudar você a organizar quais informações vão em cada lugar.

**Você precisará de dois arquivos para fazer um upload 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 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)[faça o download 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 de arquivo* detalhes disponíveis na [*Carregamento em massa*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) tela para verificar seus dados 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 seu valor existente permanecerá inalterado.
* Para limpar ou apagar um valor, digite 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
CRIAR,,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,,,,,,,,,,,,,,,,,,,,,,,
ATUALIZAR,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 mais!,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,

```

* O `CRIAR` a linha mostra um novo ativo de banner.
* O `ATUALIZAR` 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$` nessa coluna.

Exemplo de limpeza de campos (CSV):

```csv
ATUALIZAR,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 **Carregamento 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 nos *cabeçalhos de colunas de anúncio* e *cabeçalhos de colunas de oferta* referências abaixo.

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

4. Selecione **Próximo**.

<details>

<summary>cabeçalhos de colunas 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>CRIAR</code>, <code>ATUALIZAR</code>, <code>EXCLUIR</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>ProgramId</em> (Inteiro)</p><p>Obrigatório - Sempre.</p>                                                                    | O ID exclusivo do programa impact.com ao qual o ativo pertence. Esse valor não pode ser atualizado e deve corresponder ao programa no qual o upload em massa está sendo executado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>AdID</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* = `ATUALIZAR`, `EXCLUIR`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Status</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* = `CRIAR`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Tipo de anúncio</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>CRIAR</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>CRIAR</code> e <em>Tipo de anúncio</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>CRIAR</code> e <em>Tipo de anúncio</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 do ativo IAB. Obrigatório se <em>Operação</em> =</p><p><code>CRIAR</code> e <em>Tipo de anúncio</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>LEADERBOARD</code>, <code>SKYSCRAPER\_LARGO</code>, <code>SKYSCRAPER</code>, <code>ANÚNCIO\_DE\_MEIA\_PÁGINA</code>, <code>PERSONALIZADO</code>.</p>                                                                                                                                                                                                                                                                  |
| <p><em>Altura do criativo de 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>CRIAR</code> e <em>Unidade de anúncio IAB</em> =</p><p><code>PERSONALIZADO</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Largura do criativo de 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>CRIAR</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ÂNER</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>LETONO</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 fornecido</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* = `CRIAR` e *Tipo de anúncio* = `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 links profundos</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>Taxa de personalização</em> (Decimal 10.2)</p><p>Obrigatório - Não.</p>                                                     | Valor da taxa 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>Usa a página de destino padrão do programa ao criar um ativo, se não for informada.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>iOSMobileFallbackAppId</em> (Texto)</p><p>Obrigatório - Não.</p>                                                            | Especifique se o tráfego móvel deve ser direcionado para a página de destino do seu app iOS caso nenhum app seja detectado. O ID do app deve corresponder ao ID do app no sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>AndroidMobileFallbackAppId</em> (Texto)</p><p>Obrigatório - Não.</p>                                                        | Especifique se o tráfego móvel deve ser direcionado para a página de destino do seu app Android caso nenhum app seja detectado. O ID do app deve corresponder ao ID do app no 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 reserva</em> (Texto)</p><p>Obrigatório - Não.</p>                                                                   | Especifique um ID de ativo reserva, aplicável apenas a `IMAGEM` ativos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Tipo de código HTML</em> (Texto)</p><p>Obrigatório - Não.</p>                                                               | Valores permitidos: `APENAS_IFRAME`, `HTML_E_IFRAME`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Estação</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\_AS\_AULAS</code>, <code>DIA\_DO\_TRABALHO</code>, <code>HALLOWEEN</code>, <code>AÇÃO\_DE\_GRAÇAS</code>, <code>BLACK\_FRIDAY</code>, <code>CYBER\_MONDAY</code>, <code>HANUKKAH</code>, <code>NATAL</code>, <code>DIA\_DA\_FAMÍLIA</code>, <code>SEXTA-FEIRA\_SANTA</code>, <code>DIA\_VITÓRIA</code>, <code>DIA\_DO\_CANADÁ</code>, <code>FERIADO\_CÍVICO\_DE\_AGOSTO</code>, <code>DIA\_DO\_REMEMBRAMENTO</code>, <code>DIA\_DA\_CAIXA</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írgulas 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írgulas que devem ter acesso a este ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>Metadados</em> (string CSV)</p><p>Obrigatório - Não.</p>                                                                    | Parâmetros de query string separados por vírgulas que serão anexados à URL de rastreamento.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

</details>

<details>

<summary>cabeçalhos de colunas 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 de 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\_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 de oferta</em> != COMPRE\_1\_LEVE\_1.</p><p>Valores permitidos:</p><p><code>LOJA\_INTEIRA</code>, <code>CATEGORIA</code>, <code>PRODUTO</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>PRODUTO</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 de produto, por exemplo <code>"name=Produto1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Produto2;"</code> onde 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 segunda etapa do upload em massa, <code>limite</code> - quantidade permitida, <code>regularPrice</code> - preço antes do desconto, <code>dealPrice</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>DealLandingPage (String)</em><br>Obrigatório - Não</p>                                                                  | A URL da página de destino desta oferta. Se deixada em branco ao criar uma nova oferta, será usada a página de destino padrão do programa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealMetadata (string CSV)</em><br>Obrigatório - Não</p>                                                                 | Parâmetros de query string separados por vírgulas para o link de rastreamento da oferta. Se deixado em branco, nenhum parâmetro extra será adicionado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>DealAllowDeepLinking (Booleano)</em><br>Obrigatório - Não</p>                                                           | Determina se o deeplinking é permitido para a página de destino da oferta. Se deixado em branco, isso terá como padrão 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 de 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 de 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 de oferta* = `VENDA_GERAL`, e *Tipo de desconto da oferta* = `PERCENTUAL`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Percentual inicial da faixa de 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 de 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 de 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>           | Desconto percentual máximo da oferta. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, *Tipo de 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 de 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 de 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 de oferta* = `COMPRE_1_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 de oferta* = `COMPRE_1_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Limite de compra do 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 de oferta* = `COMPRE_1_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Quantidade de compra do 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 de oferta* = `COMPRE_1_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Tipo de compra do 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 de oferta</em> = <code>COMPRE\_1\_LEVE\_1</code>.</p><p>Valores permitidos:</p><p><code>PRODUTO</code>, <code>CATEGORIA</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Nome da compra do 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 de oferta* = `COMPRE_1_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Quantidade de recebimento do 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 de oferta* = `COMPRE_1_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>Tipo de recebimento do BOGO da oferta</em> (Texto)</p><p>Obrigatório - Ao criar uma nova oferta.</p>                    | <p>Tipo de item recebido no BOGO. Obrigatório se <em>ID da oferta</em> não for fornecido, <em>Nome da oferta</em> for, e <em>Tipo de oferta</em> = <code>COMPRE\_1\_LEVE\_1</code>.</p><p>Valores permitidos:</p><p><code>PRODUTO</code>, <code>CATEGORIA</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealBogoGetName</em> (Texto)</p><p>Obrigatório - Ao criar uma nova oferta.</p>                                          | Nome do produto ou categoria de obtenção. Obrigatório se *ID da oferta* não for fornecido, *Nome da oferta* for, e *Tipo de oferta* = `COMPRE_1_LEVE_1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>DealBogoGetDiscountType</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 de oferta</em> = <code>COMPRE\_1\_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 de oferta* = `COMPRE_1_LEVE_1`, e *DealBogoGetDiscountType* = `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 de oferta* = `COMPRE_1_LEVE_1`, e *DealBogoGetDiscountType* = `PERCENTUAL`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>ID da oferta</em> (Texto)</p><p>Obrigatório - Não.</p>                                                                  | Identificador exclusivo do 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 às datas de tempo limitado, ao acesso restrito de parceiros e ao estado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

</details>
{% endstep %}

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

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

1. Na *Especifique imagens* página, selecione **Escolher arquivos** para fazer o envio 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 e enviá-los de uma vez.
2. Selecione **Aceitar e criar anúncios**. Depois que todos os ativos forem enviados, eles aparecerão no [*Anúncios*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) página.
   {% 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/bulk-upload-assets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
