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

# Envie ativos em massa

Use a ferramenta de uploads em massa para enviar vários assets de uma vez usando um arquivo CSV, em vez de enviar os assets 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 que informação vai em cada lugar.

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

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

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

Há campos obrigatórios e valores aceitos para o arquivo CSV que você enviar. Seus assets aparecerão exatamente como o seu arquivo, então qualquer espaço, sinal de pontuação ou caractere especial estará presente se for usado. Para começar, copie o modelo CSV exibido abaixo e cole-o em um aplicativo de planilha ou![](/files/aba5f32934b31e047c124f21c4a6d5bd0ac5f37d)[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 do 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 verificar suas entradas antes de fazer o upload!
{% endhint %}

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

* Atualizações parciais são compatíveis. 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
CREATE,,Exemplo de banner,Este é um exemplo de um novo anúncio de banner que você enviaria.,12345,BANNER,IR,Banner_Creative1,,,,"Banner, NewBanner",TRUE,,,,,,,ENGLISH,2020-07-01T00:00:00-08:00,2038-09-19T03:14:00-08:00,FRAME_ONLY,,,,,"1234567, 8901234",,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,,,,,
UPDATE,123456,Exemplo de link de texto,Este é um exemplo de atualização de um anúncio de link de texto.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Clique aqui para saber mais!,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,

```

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

Exemplo de limpeza de campos (CSV):

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

{% endstep %}

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

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 **Upload 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 nas *colunas de cabeçalho do anúncio* e *colunas de cabeçalho da oferta* referências abaixo.

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

4. Selecione **Próximo**.

<details>

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

| Nome da coluna                                                                                                | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>Operation</em> (String)</p><p>Obrigatório - Sempre.</p>                                                | <p>Operação a ser executada sobre os detalhes do asset fornecidos.</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 Program na impact.com ao qual o asset 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> (String)</p><p>Obrigatório - Ao executar a operação em um asset existente.</p>               | Identificador exclusivo do asset na impact.com. Deixe em branco ao criar um novo asset. Obrigatório se *Operation* = `UPDATE`, `DELETE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>State</em> (String)</p><p>Obrigatório - Não.</p>                                                       | <p>O estado do asset.</p><p>Valores permitidos:</p><p><code>ACTIVE</code>, <code>PENDING</code>, <code>EXPIRED</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>Name</em> (String)</p><p>Obrigatório - Ao criar um asset.</p>                                          | *Nome do asset*. Obrigatório se *Operation* = `CREATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>AdType</em> (String)</p><p>Obrigatório - Ao criar um asset.</p>                                        | <p>Ao atualizar um anúncio existente, o tipo de anúncio não pode mudar.</p><p>Obrigatório se <em>Operation</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 asset.</p>                                      | <p>Onde o criativo do asset está hospedado. Obrigatório se</p><p><em>Operation</em> = <code>CREATE</code> e <em>AdType</em> = <code>IMAGE</code>.</p><p>Valores permitidos:</p><p><code>IR</code>, <code>URL</code>, <code>HTML</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Creative</em> (String)</p><p>Obrigatório - Ao criar um asset de imagem.</p>                            | <p>Nome do arquivo criativo a ser enviado. Obrigatório se</p><p><em>Operation</em> = <code>CREATE</code> e <em>AdType</em> = <code>IMAGE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>IabAdUnit</em> (String)</p><p>Obrigatório - Ao criar um asset de imagem.</p>                           | <p>Tamanho padrão de asset do IAB. Obrigatório se <em>Operation</em> =</p><p><code>CREATE</code> e <em>AdType</em> = <code>IMAGE</code> e <em>HostedBy</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>ThirdPartyServableAdCreativeHeight</em> (Integer)</p><p>Obrigatório - Ao criar um asset de imagem.</p> | <p>Altura da imagem exibível por terceiros, em pixels.</p><p>Obrigatório se <em>Operation</em> = <code>CREATE</code> e <em>IabAdUnit</em> =</p><p><code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>ThirdPartyServableAdCreativeWidth</em> (Integer)</p><p>Obrigatório - Ao criar um asset de imagem.</p>  | <p>Largura da imagem exibível por terceiros, em pixels.</p><p>Obrigatório se <em>Operation</em> = <code>CREATE</code> e <em>IabAdUnit</em> =</p><p><code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Language</em> (String)</p><p>Obrigatório - Ao criar um asset.</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 fornecida</p>           | Esta é uma data ISO8601. Exemplo de formato: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>LinkText</em> (String)</p><p>Obrigatório - Ao criar um asset de link de texto ou cupom.</p>            | Texto real exibido para o link. Obrigatório se *Operation* = `CREATE` e *AdType* = `TEXT_LINK` ou `COUPON`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Descrição</em></p><p>Obrigatório - Não.</p>                                                            | Descrição do asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Labels</em> (string CSV)</p><p>Obrigatório - Não.</p>                                                  | Etiquetas do asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>AllowDeepLinking</em> (Boolean)</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>O padrão é <code>true</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>AllowCustomPromoCode</em> (Boolean)</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>O padrão é <code>false</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>CustomisationCharge</em> (Decimal 10.2)</p><p>Obrigatório - Não.</p>                                   | Valor da taxa de personalização do asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>ImageAlternativeTag</em> (String)</p><p>Obrigatório - Não.</p>                                         | Tag alternativa a ser usada no código do asset de imagem.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>LandingPage</em> (String)</p><p>Obrigatório - Não.</p>                                                 | <p>A URL da página de destino. Ela deve conter o protocolo da URL.</p><p>O padrão é a página de destino padrão do programa ao criar um asset e quando não for fornecida.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>iOSMobileFallbackAppId</em> (String)</p><p>Obrigatório - Não.</p>                                      | Especifique se o tráfego móvel deve usar como fallback a página de destino do seu app iOS se nenhum app for detectado. O ID do app deve corresponder ao ID do app do sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>AndroidMobileFallbackAppId</em> (String)</p><p>Obrigatório - Não.</p>                                  | Especifique se o tráfego móvel deve usar como fallback a página de destino do seu app Android se nenhum app for detectado. O ID do app deve corresponder ao ID do app do sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>LimitedTimeStartDate</em> (String)</p><p>Obrigatório - Não.</p>                                        | Esta é uma data ISO8601. Exemplo de formato: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>FallbackAd</em> (String)</p><p>Obrigatório - Não.</p>                                                  | Especifique um ID de asset de fallback, aplicável apenas a `IMAGE` assets.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>GetHtmlCodeType</em> (String)</p><p>Obrigatório - Não.</p>                                             | Valores permitidos: `IFRAME_ONLY`, `HTML_AND_IFRAME`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Season</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>TopSeller</em> (Boolean)</p><p>Obrigatório - Não.</p>                                                  | Mais vendido. O padrão é `false`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>ThirdPartyImpressionPixel</em> (String)</p><p>Obrigatório - Não.</p>                                   | HTML de pixel de impressão de terceiros a ser usado com este asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>RestrictedToPartners</em> (string CSV)</p><p>Obrigatório - Não.</p>                                    | IDs de parceiros separados por vírgula que devem ter acesso a este asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>RestrictedToGroups</em> (string CSV)</p><p>Obrigatório - Não.</p>                                      | IDs de grupos de parceiros separados por vírgula que devem ter acesso a este asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Metadata</em> (string CSV)</p><p>Obrigatório - Não.</p>                                                | Parâmetros de string de consulta separados por vírgula que serão anexados à URL de rastreamento.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

</details>

<details>

<summary>colunas de 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 asset. Obrigatório se *DealId* não for fornecido.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <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 fornecido 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 fornecido, <em>DealName</em> for, 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 fornecido, <em>DealName</em> for, 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 valor do produto, 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 diversos campos do produto 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 do arquivo que você pretende enviar na segunda etapa do upload 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 fornecido, *DealName* for, e *DealScope* = `CATEGORY`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <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 (CSV String)</em><br>Obrigatório - Não</p>                                                                    | Parâmetros de string de consulta separados por vírgula para o link de rastreamento da oferta. Se deixados em branco, nenhum parâmetro extra será adicionado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>DealAllowDeepLinking (Boolean)</em><br>Obrigatório - Não</p>                                                               | Determina se o deeplinking é permitido para a página de destino da oferta. Se deixado em branco, o 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 fornecido, <em>DealName</em> for, 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>Valor do desconto da oferta</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar uma nova oferta.</p>                          | Valor do desconto da venda. Obrigatório se *DealId* não for fornecido, *DealName* é, *DealType* = `GENERAL_SALE`, e *DealDiscountType* = `FIXED`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <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 venda. Obrigatório se *DealId* não for fornecido, *DealName* é, *DealType* = `GENERAL_SALE`, e *DealDiscountType* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>Percentual inicial do desconto da oferta</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar uma nova oferta.</p>             | Percentual inicial da faixa de desconto da oferta. Obrigatório se *DealId* não for fornecido, *DealName* é, *DealType* = `GENERAL_SALE`, e *DealDiscountType* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <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 *DealId* não for fornecido, *DealName* é, *DealType* = `GENERAL_SALE`, e *DealDiscountType* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>Percentual máximo de desconto da oferta</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar uma nova oferta.</p>              | Percentual máximo de desconto da oferta. Obrigatório se *DealId* não for fornecido, *DealName* é, *DealType* = `GENERAL_SALE`, e *DealDiscountType* = `PERCENT_MAXIMUM`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>Presente da oferta</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar uma nova oferta.</p>                                   | Detalhes do presente. Obrigatório se *DealId* não for fornecido, *DealName* for, e *DealType* = `GIFT_WITH_PURCHASE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <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 *DealId* não for fornecido, *DealName* for, e *DealType* = `REBATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <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 *DealId* não for fornecido, *DealName* for, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <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 *DealId* não for fornecido, *DealName* for, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Limite de compra BOGO da oferta</em> (Integer)</p><p>Obrigatório - Ao criar uma nova oferta.</p>                           | Quantidade máxima de itens permitidos por este preço. Obrigatório se *DealId* não for fornecido, *DealName* for, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>Quantidade de compra BOGO da oferta</em> (Integer)</p><p>Obrigatório - Ao criar uma nova oferta.</p>                       | Quantidade de compra BOGO. Obrigatório se *DealId* não for fornecido, *DealName* for, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Tipo de compra BOGO da oferta</em> (String)</p><p>Obrigatório - Ao criar uma nova oferta.</p>                              | <p>Tipo de item de compra 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>Nome de compra BOGO da oferta</em> (String)</p><p>Obrigatório - Ao criar uma nova oferta.</p>                              | Nome do produto ou categoria de compra. Obrigatório se *DealId* não for fornecido, *DealName* for, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>Quantidade de recebimento BOGO da oferta</em> (Integer)</p><p>Obrigatório - Ao criar uma nova oferta.</p>                  | Quantidade de recebimento BOGO. Obrigatório se *DealId* não for fornecido, *DealName* for, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>Tipo de recebimento BOGO da oferta</em> (String)</p><p>Obrigatório - Ao criar uma nova oferta.</p>                         | <p>Tipo de item de recebimento 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>Nome de recebimento BOGO da oferta</em> (String)</p><p>Obrigatório - Ao criar uma nova oferta.</p>                         | Nome do produto ou categoria de recebimento. Obrigatório se *DealId* não for fornecido, *DealName* for, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Tipo de desconto de recebimento da oferta BOGO</em> (String)</p><p>Obrigatório - Ao criar uma nova oferta.</p>             | <p>Tipo de desconto da 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>GRÁTIS</code>, <code>VALOR</code>, <code>PERCENT</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>Valor do desconto de recebimento da oferta BOGO</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 fornecido, *DealName* é, *DealType* = `BOGO`, e *Tipo de desconto de recebimento da oferta BOGO* = `VALOR`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Percentual de desconto de recebimento da oferta BOGO</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 fornecido, *DealName* é, *DealType* = `BOGO`, e *Tipo de desconto de recebimento da oferta BOGO* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>DealId</em> (String)</p><p>Obrigatório - Não.</p>                                                                          | Identificador exclusivo da impact.com para a oferta à qual o ativo será vinculado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>Código de desconto padrão da oferta</em> (String)</p><p>Obrigatório - Não.</p>                                             | Código de desconto padrão da oferta.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Sincronizar promoções de anúncios da oferta</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 a datas de tempo limitado, acesso restrito de parceiros e estado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

</details>
{% endstep %}

{% step %}
**Etapa 3: Faça o upload dos arquivos criativos do ativo**

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

1. Na *Especificar imagens* página, selecione **Escolher arquivos** para fazer upload em massa dos arquivos criativos do ativo. Os nomes dos arquivos enviados devem corresponder exatamente aos nomes no campo de criação do seu arquivo de metadados (por exemplo, se o campo de criação contiver `Example.jpg`, o arquivo criativo do ativo que você enviar também deve ser nomeado `Example.jpg`).
   * Mantenha pressionado **Command ⌘** no macOS ou **CTRL** no PC para selecionar vários arquivos criativos do ativo para upload de uma vez.
2. Selecione **Aceitar e criar anúncios**. Depois que todos os ativos tiverem sido enviados, eles aparecerão na [*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.
