> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/bulk-upload-assets.md).

# Upload em massa de ativos

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

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

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

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

Há campos obrigatórios e valores aceitos para o arquivo CSV que você enviar. Seus ativos aparecerão exatamente como no seu arquivo, então qualquer espaço, pontuação ou caractere especial estará presente se forem usados. Para começar, copie o modelo de 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 [*Upload em Massa*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) para verificar suas entradas antes de enviar!
{% endhint %}

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

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

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

```

* O `CREATE` a linha mostra um novo ativo de banner.
* O `UPDATE` a linha demonstra uma atualização parcial — somente os campos preenchidos serão atualizados.
* Se você quisesse limpar um valor (por exemplo, remover `Etiquetas`), 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 ativo**

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

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

4. Selecione **Próximo**.

<details>

<summary>cabeçalhos de Ad</summary>

| Nome da coluna                                                                                                       | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>Operação</em> (String)</p><p>Obrigatório - Sempre.</p>                                                        | <p>Operação a executar sobre os detalhes do ativo fornecidos.</p><p>Valores permitidos:</p><p><code>CREATE</code>, <code>UPDATE</code>, <code>DELETE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>ID do programa</em> (Integer)</p><p>Obrigatório - Sempre.</p>                                                 | O ID exclusivo do programa na impact.com ao qual o ativo pertence. Esse valor não pode ser atualizado e deve corresponder ao programa no qual o upload em massa está sendo executado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>ID do anúncio</em> (String)</p><p>Obrigatório - Ao executar a operação sobre um ativo existente.</p>          | Identificador exclusivo da impact.com para o ativo. Deixe em branco ao criar um novo ativo. Obrigatório se *Operação* = `UPDATE`, `DELETE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Estado</em> (String)</p><p>Obrigatório - Não.</p>                                                             | <p>O estado do ativo.</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 ativo.</p>                                                 | *Nome do ativo*. Obrigatório se *Operação* = `CREATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Tipo de anúncio</em> (String)</p><p>Obrigatório - Ao criar um ativo.</p>                                      | <p>Ao atualizar um anúncio existente, o tipo do anúncio não pode mudar.</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>Hospedado por</em> (String)</p><p>Obrigatório - Ao criar um ativo.</p>                                        | <p>Onde o criativo do ativo 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 ativo de imagem.</p>                                   | <p>Nome do arquivo criativo a ser enviado. Obrigatório se</p><p><em>Operação</em> = <code>CREATE</code> e <em>Tipo de anúncio</em> = <code>IMAGE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>IabAdUnit</em> (String)</p><p>Obrigatório - Ao criar um ativo de imagem.</p>                                  | <p>Tamanho padrão de ativo do 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>ThirdPartyServableAdCreativeHeight</em> (Integer)</p><p>Obrigatório - Ao criar um ativo de imagem.</p>        | <p>Altura da imagem servível por terceiros, em pixels.</p><p>Obrigatório se <em>Operação</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 ativo de imagem.</p>         | <p>Largura da imagem servível por terceiros, em pixels.</p><p>Obrigatório se <em>Operação</em> = <code>CREATE</code> e <em>IabAdUnit</em> =</p><p><code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>Idioma</em> (String)</p><p>Obrigatório - Ao criar um ativo.</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>Data de término do período limitado</em> (Date)</p><p>Obrigatório - Se LimitedTimeStartDate for fornecido</p> | Esta é uma data ISO8601. Exemplo de formato: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>Texto do link</em> (String)</p><p>Obrigatório - Ao criar um ativo de link de texto ou cupom.</p>              | Texto real exibido para o link. Obrigatório se *Operação* = `CREATE` e *Tipo de anúncio* = `TEXT_LINK` ou `COUPON`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Descrição</em></p><p>Obrigatório - Não.</p>                                                                   | Descrição do ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Etiquetas</em> (string CSV)</p><p>Obrigatório - Não.</p>                                                      | Rótulos do ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>AllowDeepLinking</em> (Boolean)</p><p>Obrigatório - Não.</p>                                                  | <p>Determina se será permitida a vinculação para uma página mais profunda dentro do site do anunciante.</p><p>Padrão para <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>Padrão para <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 ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>ImageAlternativeTag</em> (String)</p><p>Obrigatório - Não.</p>                                                | Tag alternativa a ser usada no código do ativo 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>Usa por padrão a página de destino padrão do programa quando um ativo é criado e isso não é fornecido.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>iOSMobileFallbackAppId</em> (String)</p><p>Obrigatório - Não.</p>                                             | Especifique se o tráfego móvel deve fazer fallback para a página de destino do seu app iOS se nenhum app for detectado. O ID do app deve corresponder ao ID do app do sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>AndroidMobileFallbackAppId</em> (String)</p><p>Obrigatório - Não.</p>                                         | Especifique se o tráfego móvel deve fazer fallback para a página de destino do seu app Android se nenhum app for detectado. O ID do app deve corresponder ao ID do app do sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>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 ativo de fallback, aplicável somente a `IMAGE` ativos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <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>OUTRO</code>.</p>                                                            |
| <p><em>TopSeller</em> (Boolean)</p><p>Obrigatório - Não.</p>                                                         | Mais vendido. Padrão para `false`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>ThirdPartyImpressionPixel</em> (String)</p><p>Obrigatório - Não.</p>                                          | HTML do pixel de impressão de terceiros a ser usado com este ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <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 ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <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 ativo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Metadados</em> (string CSV)</p><p>Obrigatório - Não.</p>                                                      | Parâmetros de query string separados por vírgula que serão anexados à URL de rastreamento.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

</details>

<details>

<summary>cabeçalhos de Deal</summary>

| Nome da coluna                                                                                         | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>Nome do acordo</em> (String)</p><p>Obrigatório - Ao criar um novo acordo.</p>                   | Nome do acordo a ser criado e vinculado ao ativo. Obrigatório se *DealId* não for fornecido.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Tipo de acordo</em> (String)</p><p>Obrigatório - Ao criar um novo acordo.</p>                   | <p>Tipo de acordo a criar. 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>Compre um, leve outro grátis (BOGO)</code>, <code>PRODUCT\_LAUNCH</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Escopo do acordo</em> (String)</p><p>Obrigatório - Ao criar um novo acordo.</p>                 | <p>Obrigatório se <em>DealId</em> não for fornecido, <em>Nome do acordo</em> for, e <em>Tipo de acordo</em> != BOGO.</p><p>Valores permitidos:</p><p><code>ENTIRE\_STORE</code>, <code>CATEGORY</code>, <code>PRODUCT</code>, <code>PRODUCTS</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>Produtos do acordo</em> (string CSV)</p><p>Obrigatório - Ao criar um novo acordo.</p>           | <p>Produtos do acordo. Obrigatório se <em>DealId</em> não for fornecido, <em>Nome do acordo</em> for, e <em>Escopo do acordo</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 do produto, por exemplo <code>"name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;"</code> em que vários produtos são separados por vírgula e os vários campos do produto são separados por ponto e vírgula.</p><p>Campos válidos: <code>nome</code> - nome do produto, <code>imagem</code> - nome do arquivo de imagem do produto que você pretende enviar na segunda etapa do upload em massa, <code>limite</code> - quantidade permitida, <code>regularPrice</code> - preço antes do desconto, <code>dealPrice</code> - preço após o desconto.</p> |
| <p><em>Categorias do acordo</em> (string CSV)</p><p>Obrigatório - Ao criar um novo acordo.</p>         | Categorias do acordo. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, e *Escopo do acordo* = `CATEGORY`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>DealLandingPage (String)</em><br>Obrigatório - Não</p>                                          | A URL da página de destino para este acordo. Se deixada em branco ao criar um novo acordo, 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 query string separados por vírgula para o link de rastreamento do acordo. 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 do acordo. Se deixado em branco, o padrão será FALSE.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Tipo de desconto do acordo</em> (string CSV)</p><p>Obrigatório - Ao criar um novo acordo.</p>   | <p>Obrigatório se <em>DealId</em> não for fornecido, <em>Nome do acordo</em> for, e <em>Tipo de acordo</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 um novo acordo.</p>         | Valor do desconto da promoção. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, *Tipo de acordo* = `GENERAL_SALE`, e *Tipo de desconto do acordo* = `FIXED`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>DealDiscountPercent</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar um novo acordo.</p>        | Percentual de desconto da promoção. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, *Tipo de acordo* = `GENERAL_SALE`, e *Tipo de desconto do acordo* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>DealDiscountStartPercent</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar um novo acordo.</p>   | Percentual inicial da faixa de desconto do acordo. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, *Tipo de acordo* = `GENERAL_SALE`, e *Tipo de desconto do acordo* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>DealDiscountEndPercent</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar um novo acordo.</p>     | Percentual inicial da faixa de desconto do acordo. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, *Tipo de acordo* = `GENERAL_SALE`, e *Tipo de desconto do acordo* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>DealDiscountMaximumPercent</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar um novo acordo.</p> | Percentual máximo de desconto do acordo. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, *Tipo de acordo* = `GENERAL_SALE`, e *Tipo de desconto do acordo* = `PERCENT_MAXIMUM`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>DealGift</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar um novo acordo.</p>                   | Detalhes do brinde. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, e *Tipo de acordo* = `GIFT_WITH_PURCHASE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealRebate</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar um novo acordo.</p>                 | Valor do reembolso. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, e *Tipo de acordo* = `REBATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>DealMinimumPurchaseAmount</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar um novo acordo.</p>  | Valor mínimo de compra do acordo. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, e *Tipo de acordo* = `Compre um, leve outro grátis (BOGO)`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>DealMaximumSavingsAmount</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar um novo acordo.</p>   | Valor máximo de economia do acordo. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, e *Tipo de acordo* = `Compre um, leve outro grátis (BOGO)`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>DealBogoPurchaseLimit</em> (Integer)</p><p>Obrigatório - Ao criar um novo acordo.</p>           | Quantidade máxima de itens permitidos a este preço. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, e *Tipo de acordo* = `Compre um, leve outro grátis (BOGO)`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>DealBogoBuyQty</em> (Integer)</p><p>Obrigatório - Ao criar um novo acordo.</p>                  | Quantidade de compra do BOGO. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, e *Tipo de acordo* = `Compre um, leve outro grátis (BOGO)`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>DealBogoBuyType</em> (String)</p><p>Obrigatório - Ao criar um novo acordo.</p>                  | <p>Tipo de item de compra do BOGO. Obrigatório se <em>DealId</em> não for fornecido, <em>Nome do acordo</em> for, e <em>Tipo de acordo</em> = <code>Compre um, leve outro grátis (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 um novo acordo.</p>                  | Nome do produto ou categoria comprada. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, e *Tipo de acordo* = `Compre um, leve outro grátis (BOGO)`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>DealBogoGetQty</em> (Integer)</p><p>Obrigatório - Ao criar um novo acordo.</p>                  | Quantidade recebida no BOGO. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, e *Tipo de acordo* = `Compre um, leve outro grátis (BOGO)`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>DealBogoGetType</em> (String)</p><p>Obrigatório - Ao criar um novo acordo.</p>                  | <p>Tipo de item recebido no BOGO. Obrigatório se <em>DealId</em> não for fornecido, <em>Nome do acordo</em> for, e <em>Tipo de acordo</em> = <code>Compre um, leve outro grátis (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 um novo acordo.</p>                  | Nome do produto ou categoria obtido. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, e *Tipo de acordo* = `Compre um, leve outro grátis (BOGO)`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>DealBogoGetDiscountType</em> (String)</p><p>Obrigatório - Ao criar um novo acordo.</p>          | <p>Tipo de desconto da oferta BOGO. Obrigatório se <em>DealId</em> não for fornecido, <em>Nome do acordo</em> for, e <em>Tipo de acordo</em> = <code>Compre um, leve outro grátis (BOGO)</code>.</p><p>Valores permitidos:</p><p><code>GRÁTIS</code>, <code>VALOR</code>, <code>PERCENT</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>DealBogoGetDiscountAmount</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar um novo acordo.</p>  | Valor do desconto da oferta BOGO. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, *Tipo de acordo* = `Compre um, leve outro grátis (BOGO)`, e *DealBogoGetDiscountType* = `VALOR`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>DealBogoGetDiscountPercent</em> (Decimal 10.2)</p><p>Obrigatório - Ao criar um novo acordo.</p> | Percentual de desconto da oferta BOGO. Obrigatório se *DealId* não for fornecido, *Nome do acordo* for, *Tipo de acordo* = `Compre um, leve outro grátis (BOGO)`, e *DealBogoGetDiscountType* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>DealId</em> (String)</p><p>Obrigatório - Não.</p>                                               | Identificador exclusivo do impact.com para o qual o ativo 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 anúncios e códigos promocionais associados sincronizados com esta oferta. A sincronização se aplica a datas de prazo limitado, acesso restrito de parceiros e estado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

</details>
{% endstep %}

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

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

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