> 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 uploads em massa para enviar vários recursos de uma só vez usando um arquivo CSV, em vez de fazer o upload dos recursos individualmente. Os campos de informação são semelhantes aos do [objeto Ads](https://integrations.impact.com/brand-api-reference/reference/ads) para ajudar você a coordenar onde cada informação deve ficar.

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

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

{% stepper %}
{% step %}
**Etapa 1: preparar o arquivo de metadados dos recursos**

Há campos obrigatórios e valores aceitos para o arquivo CSV que você vai enviar. Seus recursos serão exibidos exatamente como aparecem no arquivo, inclusive espaços, pontuação e caracteres especiais, caso sejam usados. Para começar, copie o modelo CSV exibido abaixo e cole-o em um aplicativo de planilhas, 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 os detalhes de *Formato do arquivo* disponíveis na tela de [*Upload em massa*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) para conferir suas entradas antes de fazer o upload!
{% endhint %}

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

* Atualizações parciais são aceitas. Se você deixar uma célula vazia, 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,,Banner Example,This is an example of a new banner ad you would upload.,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,Text Link Example,This is an example of updating a text link ad.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Click here for more!,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,

```

* A linha `CREATE` mostra um novo recurso de banner.
* A linha `UPDATE` demonstra uma atualização parcial — somente os campos preenchidos serão atualizados.
* Se você quisesse limpar um valor (por exemplo, remover `Labels`), usaria `$CLEAR$` nessa coluna.

Exemplo de limpeza de campos (CSV):

```csv
UPDATE,123456,Text Link Example,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
```

{% endstep %}

{% step %}
**Etapa 2: fazer upload do arquivo de metadados dos recursos**

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) **\[Engajamento]** → **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 lote**.
3. Selecione  **Escolher arquivo**, faça upload do 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, os valores aceitos e se são obrigatórias nas referências de *Colunas do cabeçalho do anúncio* e *Colunas do cabeçalho do deal* abaixo.

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

4. Selecione **Avançar**.

<details>

<summary>Colunas do cabeçalho do anúncio</summary>

| Nome da coluna                                                                                                                       | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>Operação</em> (String)</p><p>Obrigatório — sempre.</p>                                                                        | <p>Operação a ser executada nos detalhes do recurso fornecido.</p><p>Valores permitidos:</p><p><code>CREATE</code>, <code>UPDATE</code>, <code>DELETE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>ProgramId</em> (Integer)</p><p>Obrigatório — sempre.</p>                                                                      | O ID exclusivo do programa da impact.com ao qual o recurso pertence. Esse valor não pode ser atualizado e deve corresponder ao programa em que o upload em massa está sendo realizado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>AdID</em> (String)</p><p>Obrigatório — ao executar uma operação em um recurso existente.</p>                                  | Identificador exclusivo da impact.com para o recurso. Deixe em branco ao criar um novo recurso. Obrigatório se *Operação* = `UPDATE`, `DELETE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>Estado</em> (String)</p><p>Obrigatório — não.</p>                                                                             | <p>O estado do recurso.</p><p>Valores permitidos:</p><p><code>ACTIVE</code>, <code>PENDING</code>, <code>EXPIRED</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Nome</em> (String)</p><p>Obrigatório — ao criar um recurso.</p>                                                               | *Nome do recurso*. Obrigatório se *Operação* = `CREATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>AdType</em> (String)</p><p>Obrigatório — ao criar um recurso.</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>IMAGE</code>, <code>TEXT\_LINK</code>, <code>COUPON</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>HostedBy</em> (String)</p><p>Obrigatório — ao criar um recurso de imagem.</p>                                                 | <p>Onde o criativo do recurso está hospedado. Obrigatório se</p><p><em>Operação</em> = <code>CREATE</code> e <em>Tipo de anúncio</em> = <code>IMAGE</code>.</p><p>Valores permitidos:</p><p><code>IR</code>, <code>URL</code>, <code>HTML</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Criativo</em> (String)</p><p>Obrigatório — ao criar um recurso de imagem.</p>                                                 | <p>Nome do arquivo do criativo a ser enviado. Obrigatório se</p><p><em>Operação</em> = <code>CREATE</code> e <em>Tipo de anúncio</em> = <code>IMAGE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>Unidade de anúncio IAB</em> (String)</p><p>Obrigatório — ao criar um recurso de imagem.</p>                                   | <p>Tamanho padrão de recurso IAB. Obrigatório se <em>Operação</em> =</p><p><code>CREATE</code> e <em>Tipo de anúncio</em> = <code>IMAGE</code> e <em>Hospedado por</em> != <code>IR</code>.</p><p>Valores permitidos: <code>UNKNOWN</code>, <code>MEDIUM\_RECTANGLE</code>, <code>SQUARE\_POP\_UP</code>, <code>VERTICAL\_RECTANGLE</code>, <code>LARGE\_RECTANGLE</code>, <code>RECTANGLE</code>, <code>RECTANGLE\_3\_1\_</code>, <code>POP\_UNDER, FULL\_BANNER</code>, <code>HALF\_BANNER, MICRO\_BANNER</code>, <code>BUTTON\_1</code>, <code>BUTTON\_2</code>, <code>VERTICAL\_BANNER</code>, <code>SQUARE\_BUTTON</code>, <code>LEADERBOARD</code>, <code>WIDE\_SKYSCRAPER</code>, <code>SKYSCRAPER</code>, <code>HALF\_PAGE\_AD</code>, <code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                         |
| <p><em>Altura do criativo de anúncio veiculável por terceiros</em> (Integer)</p><p>Obrigatório — ao criar um recurso de imagem.</p>  | <p>Altura, em pixels, da imagem de anúncio veiculável por terceiros.</p><p>Obrigatório se <em>Operação</em> = <code>CREATE</code> e <em>Unidade de anúncio IAB</em> =</p><p><code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Largura do criativo de anúncio veiculável por terceiros</em> (Integer)</p><p>Obrigatório — ao criar um recurso de imagem.</p> | <p>Largura da imagem disponibilizada 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>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>Idioma</em> (String)</p><p>Obrigatório — ao criar um recurso.</p>                                                             | <p>Valores permitidos:</p><p><code>AFRIKAANS</code>, <code>ARABIC</code>, <code>BULGARIAN</code>, <code>CHINESE</code>, <code>CHINESE\_TRADITIONAL</code>, <code>CZECH</code>, <code>DANISH</code>, <code>DUTCH</code>, <code>ENGLISH</code>, <code>ENGLISH\_GB</code>, <code>ENGLISH\_AU</code>, <code>ENGLISH\_CA</code>, <code>ENGLISH\_NZ</code>, <code>ENGLISH\_ZA</code>, <code>ESTONIAN</code>, <code>FILIPINO</code>, <code>FINISH</code>, <code>FRENCH</code>, <code>FRENCH\_CA</code>, <code>GERMAN</code>, <code>HEBREW</code>, <code>HINDI</code>, <code>INDONESIAN</code>, <code>ITALIAN</code>, <code>JAPANESE</code>, <code>KOREAN</code>, <code>LATVIAN</code>, <code>LITHUANIAN</code>, <code>MALAY</code>, <code>MALTESE</code>, <code>NORWEGIAN</code>, <code>PORTUGUESE</code>, <code>PORTUGUESE\_BR</code>, <code>POLISH</code>, <code>RUSSIAN</code>, <code>SLOVENIAN</code>, <code>SPANISH</code>, <code>SPANISH\_MX</code>, <code>SWEDISH</code>, <code>THAI</code>, <code>TURKISH</code>, <code>VIETNAMESE</code>.</p> |
| <p><em>LimitedTimeEndDate</em> (Date)</p><p>Obrigatório — se LimitedTimeStartDate for informado</p>                                  | Esta é uma data ISO 8601. Formato de exemplo: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>Texto do link</em> (String)</p><p>Obrigatório ao criar um link de texto ou um recurso de cupom.</p>                           | Texto exibido no link. Obrigatório se *Operação* = `CREATE` e *Tipo de anúncio* = `TEXT_LINK` ou `COUPON`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>Descrição</em></p><p>Obrigatório — não.</p>                                                                                   | Descrição do recurso.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Rótulos</em> (string CSV)</p><p>Obrigatório — não.</p>                                                                        | Rótulos do recurso.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Permitir links profundos</em> (Boolean)</p><p>Obrigatório — não.</p>                                                          | <p>Determina se será permitido criar links para páginas mais internas do site do anunciante.</p><p>O padrão é <code>true</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Permitir código promocional personalizado</em> (Boolean)</p><p>Obrigatório — não.</p>                                         | <p>Permitir que o parceiro solicite seu próprio código promocional exclusivo para esta promoção.</p><p>O padrão é <code>false</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 recurso.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Texto alternativo da imagem</em> (String)</p><p>Obrigatório — não.</p>                                                        | Texto alternativo a ser usado no código do recurso de imagem.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>Página de destino</em> (String)</p><p>Obrigatório — não.</p>                                                                  | <p>URL da página de destino. Deve incluir o protocolo da URL.</p><p>Ao criar um recurso, se não for informado, o padrão será a página de destino padrão do programa.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>ID do app de fallback para iOS</em> (String)</p><p>Obrigatório — não.</p>                                                     | Especifique se o tráfego móvel deve ser direcionado à página de destino do seu app para iOS caso nenhum app seja detectado. O ID do app deve corresponder ao ID do app no sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>ID do app de fallback para Android</em> (String)</p><p>Obrigatório — não.</p>                                                 | Especifique se o tráfego móvel deve ser direcionado à página de destino do seu app para Android caso nenhum app seja detectado. O ID do app deve corresponder ao ID do app no sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Data de início do período limitado</em> (String)</p><p>Obrigatório — não.</p>                                                 | Esta é uma data ISO 8601. Formato de exemplo: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>Anúncio de fallback</em> (String)</p><p>Obrigatório — não.</p>                                                                | Especifique um ID de recurso de fallback. Aplicável somente a recursos do tipo `IMAGE`  .                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>Tipo de código HTML</em> (String)</p><p>Obrigatório — não.</p>                                                                | Valores permitidos: `IFRAME_ONLY`, `HTML_AND_IFRAME`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Estação</em> (String)</p><p>Obrigatório — não.</p>                                                                            | <p>Valores permitidos:</p><p><code>WINTER</code>, <code>SPRING</code>, <code>SUMMER</code>, <code>FALL</code>, <code>NEW\_YEAR</code>, <code>PRESIDENTS\_DAY</code>, <code>VALENTINES\_DAY</code>, <code>ST\_PATRICKS\_DAY</code>, <code>EASTER</code>, <code>MOTHERS\_DAY</code>, <code>MEMORIAL\_DAY</code>, <code>FATHERS\_DAY</code>, <code>INDEPENDANCE\_DAY</code>, <code>BACK\_TO\_SCHOOL</code>, <code>LABOR\_DAY</code>, <code>HALLOWEEN</code>, <code>THANKSGIVING</code>, <code>BLACK\_FRIDAY</code>, <code>CYBER\_MONDAY</code>, <code>HANUKKAH</code>, <code>CHRISTMAS</code>, <code>FAMILY\_DAY</code>, <code>GOOD\_FRIDAY</code>, <code>VICTORIA\_DAY</code>, <code>CANADA\_DAY</code>, <code>AUGUST\_CIVIC\_HOLIDAY</code>, <code>REMEMBRANCE\_DAY</code>, <code>BOXING\_DAY</code>, <code>AUSTRALIA\_DAY</code>, <code>ANZAC\_DAY</code>, <code>QUEENS\_BIRTHDAY</code>, <code>END\_OF\_FINANCIAL\_YEAR</code>, <code>WAITANGI\_DAY</code>, <code>OTHER</code>.</p>                                                            |
| <p><em>Mais vendido</em> (Boolean)</p><p>Obrigatório — não.</p>                                                                      | Mais vendido. O padrão é `false`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>Pixel de impressão de terceiros</em> (String)</p><p>Obrigatório — não.</p>                                                    | HTML do pixel de impressão de terceiros a ser usado com este recurso.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Restrito a parceiros</em> (String CSV)</p><p>Obrigatório — não.</p>                                                           | IDs dos parceiros separados por vírgulas que devem ter acesso a este recurso.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>Restrito a grupos</em> (string CSV)</p><p>Obrigatório — não.</p>                                                              | IDs dos grupos de parceiros separados por vírgula que devem ter acesso a este recurso.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Metadados</em> (string CSV)</p><p>Obrigatório — não.</p>                                                                      | Parâmetros da string de consulta separados por vírgula que serão adicionados ao URL de rastreamento.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

</details>

<details>

<summary>Colunas do cabeçalho da oferta</summary>

| Nome da coluna                                                                                        | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>DealName</em> (String)</p><p>Obrigatório ao criar uma nova oferta.</p>                         | Nome da oferta a ser criada e vinculada ao recurso. Obrigatório se *DealId* não for informado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>DealType</em> (String)</p><p>Obrigatório ao criar uma nova oferta.</p>                         | <p>Tipo de oferta a ser criada. Obrigatório se <em>DealId</em> não for informado e DealName for.</p><p>Valores permitidos:</p><p><code>GENERAL\_SALE</code>,<code>FREE\_SHIPPING</code>, <code>GIFT\_WITH\_PURCHASE</code>, <code>REBATE</code>, <code>BOGO</code>, <code>PRODUCT\_LAUNCH</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealScope</em> (String)</p><p>Obrigatório ao criar uma nova oferta.</p>                        | <p>Obrigatório se <em>DealId</em> não for informado, <em>DealName</em> for informado e <em>DealType</em> != BOGO.</p><p>Valores permitidos:</p><p><code>ENTIRE\_STORE</code>, <code>CATEGORY</code>, <code>PRODUCT</code>, <code>PRODUCTS</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealProducts</em> (string CSV)</p><p>Obrigatório ao criar uma nova oferta.</p>                 | <p>Produtos da oferta. Obrigatório se <em>DealId</em> não for informado, <em>DealName</em> for informado e <em>DealScope</em> = <code>PRODUCT</code>.</p><p>Valores permitidos:</p><p>Opção 1: lista de nomes de produtos, por exemplo: <code>"Product1, Product2"</code>.</p><p>Opção 2: lista de pares de valores de produtos, por exemplo: <code>"name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;"</code> em que os vários produtos são separados por vírgula, e os diferentes campos dos produtos são separados por ponto e vírgula.</p><p>Campos válidos: <code>name</code> - nome do produto, <code>image</code> - nome do arquivo de imagem do produto que você pretende enviar na segunda etapa do envio em massa, <code>limit</code> - quantidade permitida, <code>regularPrice</code> - preço antes do desconto, <code>dealPrice</code> - preço após o desconto.</p> |
| <p><em>DealCategories</em> (string CSV)</p><p>Obrigatório ao criar uma nova oferta.</p>               | Categorias da oferta. Obrigatório se *DealId* não for informado, *DealName* for informado e *DealScope* = `CATEGORY`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealLandingPage (String)</em><br>Obrigatório - Não</p>                                         | 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 deixados em branco, nenhum parâmetro adicional será adicionado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>DealAllowDeepLinking (Boolean)</em><br>Obrigatório - Não</p>                                   | Determina se o deep linking é permitido para a página de destino da oferta. Se deixado em branco, o valor padrão será FALSE.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>DealDiscountType</em> (string CSV)</p><p>Obrigatório ao criar uma nova oferta.</p>             | <p>Obrigatório se <em>DealId</em> não for informado, <em>DealName</em> for informado e <em>DealType</em> = GENERAL\_SALE.</p><p>Valores permitidos:</p><p><code>FIXED</code>, <code>PERCENT</code>, <code>PERCENT\_RANGE</code>, <code>PERCENT\_MAXIMUM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>DealDiscountAmount</em> (Decimal 10.2)</p><p>Obrigatório ao criar uma nova oferta.</p>         | Valor do desconto da oferta. Obrigatório se *DealId* não for informado, *DealName* for informado, *DealType* = `GENERAL_SALE` e *DealDiscountType* = `FIXED`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>DealDiscountPercent</em> (Decimal 10.2)</p><p>Obrigatório ao criar uma nova oferta.</p>        | Percentual de desconto da oferta. Obrigatório se *DealId* não for informado, *DealName* for, *DealType* = `GENERAL_SALE` e *DealDiscountType* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealDiscountStartPercent</em> (Decimal 10.2)</p><p>Obrigatório ao criar uma nova oferta.</p>   | Percentual inicial do intervalo de desconto da oferta. Obrigatório se *DealId* não for informado, *DealName* for, *DealType* = `GENERAL_SALE` e *DealDiscountType* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealDiscountEndPercent</em> (Decimal 10.2)</p><p>Obrigatório ao criar uma nova oferta.</p>     | Percentual inicial do intervalo de desconto da oferta. Obrigatório se *DealId* não for informado, *DealName* for, *DealType* = `GENERAL_SALE` e *DealDiscountType* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealDiscountMaximumPercent</em> (Decimal 10.2)</p><p>Obrigatório ao criar uma nova oferta.</p> | Percentual máximo de desconto da oferta. Obrigatório se *DealId* não for informado, *DealName* for, *DealType* = `GENERAL_SALE` e *DealDiscountType* = `PERCENT_MAXIMUM`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>DealGift</em> (String)</p><p>Obrigatório ao criar uma nova oferta.</p>                         | Detalhes do brinde. Obrigatório se *DealId* não for informado, *DealName* for, e *DealType* = `GIFT_WITH_PURCHASE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>DealRebate</em> (Decimal 10.2)</p><p>Obrigatório ao criar uma nova oferta.</p>                 | Valor do desconto. Obrigatório se *DealId* não for informado, *DealName* for informado, e *DealType* = `REBATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>DealMinimumPurchaseAmount</em> (Decimal 10.2)</p><p>Obrigatório ao criar uma nova oferta.</p>  | Valor mínimo de compra da oferta. Obrigatório se *DealId* não for informado, *DealName* for informado, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>DealMaximumSavingsAmount</em> (Decimal 10.2)</p><p>Obrigatório ao criar uma nova oferta.</p>   | Valor máximo de economia da oferta. Obrigatório se *DealId* não for informado, *DealName* for informado, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>DealBogoPurchaseLimit</em> (Integer)</p><p>Obrigatório ao criar uma nova oferta.</p>           | Quantidade máxima de itens permitidos por esse preço. Obrigatório se *DealId* não for informado, *DealName* for informado, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>DealBogoBuyQty</em> (Integer)</p><p>Obrigatório ao criar uma nova oferta.</p>                  | Quantidade de itens a comprar na oferta BOGO. Obrigatório se *DealId* não for informado, *DealName* for informado, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>DealBogoBuyType</em> (String)</p><p>Obrigatório ao criar uma nova oferta.</p>                  | <p>Tipo de item a comprar na oferta BOGO. Obrigatório se <em>DealId</em> não for fornecido, <em>DealName</em> for, e <em>DealType</em> = <code>BOGO</code>.</p><p>Valores permitidos:</p><p><code>PRODUCT</code>, <code>CATEGORY</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>DealBogoBuyName</em> (String)</p><p>Obrigatório ao criar uma nova oferta.</p>                  | Nome do produto ou da categoria a ser comprado. Obrigatório se *DealId* não for fornecido, *DealName* for, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>DealBogoGetQty</em> (Integer)</p><p>Obrigatório ao criar uma nova oferta.</p>                  | Quantidade de itens recebidos na promoção BOGO. Obrigatório se *DealId* não for fornecido, *DealName* for, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>DealBogoGetType</em> (String)</p><p>Obrigatório ao criar uma nova oferta.</p>                  | <p>Tipo de item recebido na promoção BOGO. Obrigatório se <em>DealId</em> não for fornecido, <em>DealName</em> for, e <em>DealType</em> = <code>BOGO</code>.</p><p>Valores permitidos:</p><p><code>PRODUCT</code>, <code>CATEGORY</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>DealBogoGetName</em> (String)</p><p>Obrigatório ao criar uma nova oferta.</p>                  | Nome do produto ou da categoria recebida. Obrigatório se *DealId* não for fornecido, *DealName* for, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>DealBogoGetDiscountType</em> (String)</p><p>Obrigatório ao criar uma nova oferta.</p>          | <p>Tipo de desconto da promoção BOGO. Obrigatório se <em>DealId</em> não for fornecido, <em>DealName</em> for, e <em>TipoDeOferta</em> = <code>BOGO</code>.</p><p>Valores permitidos:</p><p><code>FREE</code>, <code>AMOUNT</code>, <code>PERCENT</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>DealBogoGetDiscountAmount</em> (Decimal 10.2)</p><p>Obrigatório ao criar uma nova oferta.</p>  | Valor do desconto da oferta BOGO. Obrigatório se *DealId* não for informado, *DealName* for, *DealType* = `BOGO`, e *DealBogoGetDiscountType* = `AMOUNT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>DealBogoGetDiscountPercent</em> (Decimal 10.2)</p><p>Obrigatório ao criar uma nova oferta.</p> | Percentual de desconto da oferta BOGO. Obrigatório se *DealId* não for informado, *DealName* for, *DealType* = `BOGO`, e *DealBogoGetDiscountType* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>DealId</em> (String)</p><p>Obrigatório — não.</p>                                              | Identificador exclusivo da impact.com para a oferta à qual o recurso será vinculado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>DealDefaultDiscountCode</em> (String)</p><p>Obrigatório — não.</p>                             | Código de desconto padrão da oferta.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>DealSyncAdsPromoCodes</em> (Boolean)</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 período limitado, ao acesso restrito de parceiros e ao estado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

</details>
{% endstep %}

{% step %}
**Etapa 3: enviar os arquivos criativos do recurso**

Em seguida, deixe os arquivos criativos do recurso prontos para envio.

1. Na página *Especificar imagens* , selecione **Escolher arquivos** para enviar em lote os arquivos criativos do recurso. Os nomes dos arquivos enviados devem corresponder exatamente aos nomes no campo creative do arquivo de metadados (por exemplo, se o campo creative contiver `Example.jpg`, o arquivo criativo do recurso enviado também deverá ter o nome `Example.jpg`).
   * Mantenha pressionada a tecla **Command ⌘** no macOS ou **CTRL** no PC para selecionar vários arquivos de criativos para enviar de uma só vez.
2. Selecionar **Aceitar e criar anúncios**. Depois que todos os recursos forem enviados, eles aparecerão na página [*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.
