> 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/it/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/bulk-upload-assets.md).

# Carica asset in blocco

Usa lo strumento di caricamento in blocco per caricare più asset contemporaneamente usando un file CSV, invece di caricare gli asset singolarmente. I campi informativi sono simili a quelli dell' [oggetto Ads](https://integrations.impact.com/brand-api-reference/reference/ads) per aiutarti a coordinare quali informazioni vanno dove.

**Ti serviranno due file per eseguire un caricamento in blocco degli annunci:**

* Un file di metadati dell'asset (CSV)
* File creativi (ad es. immagini o video)

{% stepper %}
{% step %}
**Passaggio 1: prepara il file di metadati dell'asset**

Esistono campi obbligatori e valori accettati per il file CSV che carichi. I tuoi asset appariranno esattamente come nel file, quindi eventuali spazi, segni di punteggiatura o caratteri speciali saranno presenti se vengono utilizzati. Per iniziare, copia il modello CSV mostrato sotto e incollalo in un'applicazione per fogli di calcolo oppure![](/files/468bf1148bc28c3984bbc2af1aac6965ef2c32c4)[scaricalo qui](https://res.cloudinary.com/product-enablement/raw/upload/v1765961581/CSVs/Assets/Bulk_upload_ads_template_-_Sheet1.csv) e importalo direttamente.

```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" %}
**Suggerimento:** Consigliamo di usare *Formato file* dettagli disponibili nella [*Caricamento massivo*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) schermata per controllare i dati inseriti prima di caricarli!
{% endhint %}

Prima di creare o aggiornare gli asset usando un file di metadati, prendi nota dei seguenti punti importanti sugli aggiornamenti parziali:

* Gli aggiornamenti parziali sono supportati. Se lasci una cella vuota, quel campo verrà ignorato e il suo valore esistente rimarrà invariato.
* Per cancellare o eliminare un valore, inserisci esplicitamente `$CLEAR$` in quella cella. In questo modo viene rimosso qualsiasi valore precedentemente memorizzato per quel 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,,Esempio banner,Questo è un esempio di un nuovo annuncio banner che caricheresti.,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,Esempio di link testuale,Questo è un esempio di aggiornamento di un annuncio link testuale.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Clicca qui per saperne di più!,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,

```

* Il `CREATE` la riga mostra un nuovo asset banner.
* Il `UPDATE` la riga mostra un aggiornamento parziale — verranno aggiornati solo i campi compilati.
* Se volessi cancellare un valore (ad es. rimuovere `Etichette`), useresti `$CLEAR$` in quella colonna.

Esempio di cancellazione dei campi (CSV):

```csv
UPDATE,123456,Esempio di link testuale,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
```

{% endstep %}

{% step %}
**Passaggio 2: carica il file di metadati dell'asset**

1. Dalla barra di navigazione a sinistra, seleziona ![\[Engage\] v2](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-aa671735ec2b65af79961eaf59ab60af.svg) **\[Interagisci]** → **Contenuto** → [**Annunci**](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml)**.**
2. Nell'angolo in alto a destra, seleziona **Caricamento massivo**.
3. Seleziona  **Scegli file**, carica il tuo file in blocco e seleziona **Aperte**.
   * Seleziona  **Mostra/nascondi dettagli del formato file** per visualizzare informazioni sulle colonne obbligatorie, le loro descrizioni, i valori accettati e se sono obbligatorie nelle *colonne di intestazione dell'annuncio* e *colonne di intestazione dell'offerta* riferimenti riportati sotto.

{% hint style="success" icon="memo" %}
**Nota:** impact.com ti avviserà se ci sono errori nel file.
{% endhint %}

4. Seleziona **Avanti**.

<details>

<summary>colonne di intestazione dell'annuncio</summary>

| Nome colonna                                                                                                        | Descrizione                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>Operazione</em> (String)</p><p>Obbligatorio - sempre.</p>                                                    | <p>Operazione da eseguire sui dettagli dell'asset forniti.</p><p>Valori consentiti:</p><p><code>CREATE</code>, <code>UPDATE</code>, <code>DELETE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>ID programma</em> (Integer)</p><p>Obbligatorio - sempre.</p>                                                 | L'identificatore univoco del programma impact.com a cui appartiene l'asset. Questo valore non può essere aggiornato e deve corrispondere al programma in cui viene eseguito il caricamento in blocco.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>ID annuncio</em> (String)</p><p>Obbligatorio - quando si esegue un'operazione su un asset esistente.</p>     | Identificatore univoco di impact.com per l'asset. Lascia vuoto quando crei un nuovo asset. Obbligatorio se *Operazione* = `UPDATE`, `DELETE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>Stato</em> (String)</p><p>Obbligatorio - No.</p>                                                             | <p>Lo stato dell'asset.</p><p>Valori consentiti:</p><p><code>ACTIVE</code>, <code>PENDING</code>, <code>EXPIRED</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Nome</em> (String)</p><p>Obbligatorio - quando si crea un asset.</p>                                         | *Nome dell'asset*. Obbligatorio se *Operazione* = `CREATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Tipo annuncio</em> (String)</p><p>Obbligatorio - quando si crea un asset.</p>                                | <p>Quando si aggiorna un annuncio esistente, il tipo di annuncio non può cambiare.</p><p>Obbligatorio se <em>Operazione</em> = <code>CREATE</code>.</p><p>Valori consentiti:</p><p><code>IMAGE</code>, <code>TEXT\_LINK</code>, <code>COUPON</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>Ospitato da</em> (String)</p><p>Obbligatorio - quando si crea un asset.</p>                                  | <p>Dove è ospitato il creativo dell'asset. Obbligatorio se</p><p><em>Operazione</em> = <code>CREATE</code> e <em>Tipo annuncio</em> = <code>IMAGE</code>.</p><p>Valori consentiti:</p><p><code>IR</code>, <code>URL</code>, <code>HTML</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Creativo</em> (String)</p><p>Obbligatorio - quando si crea un asset immagine.</p>                            | <p>Nome del file creativo da caricare. Obbligatorio se</p><p><em>Operazione</em> = <code>CREATE</code> e <em>Tipo annuncio</em> = <code>IMAGE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>Unità annuncio IAB</em> (String)</p><p>Obbligatorio - quando si crea un asset immagine.</p>                  | <p>Dimensione standard dell'asset IAB. Obbligatorio se <em>Operazione</em> =</p><p><code>CREATE</code> e <em>Tipo annuncio</em> = <code>IMAGE</code> e <em>Ospitato da</em> != <code>IR</code>.</p><p>Valori consentiti: <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>Obbligatorio - quando si crea un asset immagine.</p> | <p>Altezza dell'immagine servibile di terze parti, in pixel.</p><p>Obbligatorio se <em>Operazione</em> = <code>CREATE</code> e <em>Unità annuncio IAB</em> =</p><p><code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>ThirdPartyServableAdCreativeWidth</em> (Integer)</p><p>Obbligatorio - quando si crea un asset immagine.</p>  | <p>Larghezza dell'immagine servibile di terze parti, in pixel.</p><p>Obbligatorio se <em>Operazione</em> = <code>CREATE</code> e <em>Unità annuncio IAB</em> =</p><p><code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>Lingua</em> (String)</p><p>Obbligatorio - quando si crea un asset.</p>                                       | <p>Valori consentiti:</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>Obbligatorio - se è specificato LimitedTimeStartDate</p>                | Questa è una data ISO8601. Formato di esempio: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Testo del link</em> (String)</p><p>Obbligatorio - quando si crea un asset di link testuale o coupon.</p>     | Testo effettivo visualizzato per il link. Obbligatorio se *Operazione* = `CREATE` e *Tipo annuncio* = `TEXT_LINK` o `COUPON`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>Descrizione</em></p><p>Obbligatorio - No.</p>                                                                | Descrizione dell'asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>Etichette</em> (CSV string)</p><p>Obbligatorio - No.</p>                                                     | Etichette dell'asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>AllowDeepLinking</em> (Boolean)</p><p>Obbligatorio - No.</p>                                                 | <p>Determina se sarà consentito il collegamento a una pagina più interna del sito dell'inserzionista.</p><p>Impostazione predefinita su <code>true</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>AllowCustomPromoCode</em> (Boolean)</p><p>Obbligatorio - No.</p>                                             | <p>Consente al partner di richiedere un proprio codice promozionale univoco per questa promozione.</p><p>Impostazione predefinita su <code>false</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>Costo di personalizzazione</em> (Decimal 10.2)</p><p>Obbligatorio - No.</p>                                  | Importo della tariffa di personalizzazione dell'asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>Tag alternativo immagine</em> (String)</p><p>Obbligatorio - No.</p>                                          | Tag alternativo da usare nel codice dell'asset immagine.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>Pagina di destinazione</em> (String)</p><p>Obbligatorio - No.</p>                                            | <p>L'URL della pagina di destinazione. Deve contenere il protocollo URL.</p><p>Per impostazione predefinita usa la pagina di destinazione predefinita del programma quando si crea un asset e non viene specificata.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>iOSMobileFallbackAppId</em> (String)</p><p>Obbligatorio - No.</p>                                            | Specifica se il traffico mobile deve reindirizzare alla pagina di destinazione della tua app iOS se non viene rilevata alcuna app. L'ID dell'app deve corrispondere all'ID dell'app di sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>AndroidMobileFallbackAppId</em> (String)</p><p>Obbligatorio - No.</p>                                        | Specifica se il traffico mobile deve reindirizzare alla pagina di destinazione della tua app Android se non viene rilevata alcuna app. L'ID dell'app deve corrispondere all'ID dell'app di sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Data di inizio per tempo limitato</em> (String)</p><p>Obbligatorio - No.</p>                                 | Questa è una data ISO8601. Formato di esempio: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Annuncio di fallback</em> (String)</p><p>Obbligatorio - No.</p>                                              | Specifica un ID asset di fallback, applicabile solo agli `IMAGE` asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>GetHtmlCodeType</em> (String)</p><p>Obbligatorio - No.</p>                                                   | Valori consentiti: `IFRAME_ONLY`, `HTML_AND_IFRAME`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Stagione</em> (String)</p><p>Obbligatorio - No.</p>                                                          | <p>Valori consentiti:</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>ALTRO</code>.</p>                                                            |
| <p><em>Miglior venduto</em> (Boolean)</p><p>Obbligatorio - No.</p>                                                  | Miglior venduto. Per impostazione predefinita `false`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>Pixel di impressione di terze parti</em> (String)</p><p>Obbligatorio - No.</p>                               | HTML del pixel di impressione di terze parti da usare con questo asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>Limitato ai partner</em> (CSV string)</p><p>Obbligatorio - No.</p>                                           | ID partner separati da virgole che devono avere accesso a questo asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>Limitato ai gruppi</em> (CSV string)</p><p>Obbligatorio - No.</p>                                            | ID dei gruppi partner separati da virgole che devono avere accesso a questo asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Metadati</em> (CSV string)</p><p>Obbligatorio - No.</p>                                                      | Parametri della query string separati da virgole che verranno aggiunti all'URL di tracciamento.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

</details>

<details>

<summary>colonne di intestazione dell'offerta</summary>

| Nome colonna                                                                                                              | Descrizione                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>Nome offerta</em> (String)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                              | Nome dell'offerta da creare e collegare all'asset. Obbligatorio se *ID offerta* non viene fornito.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>Tipo offerta</em> (String)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                              | <p>Tipo di offerta da creare. Obbligatorio se <em>ID offerta</em> non viene fornito e DealName lo è.</p><p>Valori consentiti:</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>Ambito dell'offerta</em> (String)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                       | <p>Obbligatorio se <em>ID offerta</em> non viene fornito, <em>Nome offerta</em> è, e <em>Tipo offerta</em> != BOGO.</p><p>Valori consentiti:</p><p><code>ENTIRE\_STORE</code>, <code>CATEGORY</code>, <code>PRODUCT</code>, <code>PRODUCTS</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>Prodotti offerta</em> (CSV string)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                      | <p>Prodotti dell'offerta. Obbligatorio se <em>ID offerta</em> non viene fornito, <em>Nome offerta</em> è, e <em>Ambito dell'offerta</em> = <code>PRODUCT</code>.</p><p>Valori consentiti:</p><p>Opzione 1: elenco di nomi prodotto, ad es. <code>"Product1, Product2"</code>.</p><p>Opzione 2: elenco di coppie nome/valore prodotto, ad es. <code>"name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;"</code> dove i prodotti multipli sono separati da virgole e i vari campi prodotto sono separati da punto e virgola.</p><p>Campi validi: <code>nome</code> - nome prodotto, <code>immagine</code> - nome file dell'immagine del prodotto del file che intendi caricare nel secondo passaggio del caricamento in blocco, <code>limite</code> - quantità consentita, <code>regularPrice</code> - prezzo prima dello sconto, <code>dealPrice</code> - prezzo dopo lo sconto.</p> |
| <p><em>Categorie dell'offerta</em> (CSV string)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                | Categorie dell'offerta. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, e *Ambito dell'offerta* = `CATEGORY`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>Pagina di destinazione dell'offerta (String)</em><br>Obbligatorio - No</p>                                         | L'URL della pagina di destinazione per questa offerta. Se lasciato vuoto quando si crea una nuova offerta, verrà usata la pagina di destinazione predefinita del programma.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>Metadati dell'offerta (stringa CSV)</em><br>Obbligatorio - No</p>                                                  | Parametri della query string separati da virgole per il link di tracciamento dell'offerta. Se lasciato vuoto, non verranno aggiunti parametri extra.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Consenti deep linking dell'offerta (Boolean)</em><br>Obbligatorio - No</p>                                         | Determina se il deeplinking è consentito per la pagina di destinazione dell'offerta. Se lasciato vuoto, il valore predefinito sarà FALSE.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>Tipo di sconto dell'offerta</em> (CSV string)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>           | <p>Obbligatorio se <em>ID offerta</em> non viene fornito, <em>Nome offerta</em> è, e <em>Tipo offerta</em> = GENERAL\_SALE.</p><p>Valori consentiti:</p><p><code>FIXED</code>, <code>PERCENT</code>, <code>PERCENT\_RANGE</code>, <code>PERCENT\_MAXIMUM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Importo sconto offerta</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>              | Importo dello sconto sulla vendita. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, *Tipo offerta* = `GENERAL_SALE`, e *Tipo di sconto dell'offerta* = `FIXED`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>Percentuale sconto offerta</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>          | Percentuale di sconto sulla vendita. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, *Tipo offerta* = `GENERAL_SALE`, e *Tipo di sconto dell'offerta* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Percentuale iniziale sconto offerta</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea una nuova offerta.</p> | Percentuale iniziale dell'intervallo di sconto dell'offerta. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, *Tipo offerta* = `GENERAL_SALE`, e *Tipo di sconto dell'offerta* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>Percentuale finale sconto offerta</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>   | Percentuale iniziale dell'intervallo di sconto dell'offerta. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, *Tipo offerta* = `GENERAL_SALE`, e *Tipo di sconto dell'offerta* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>Percentuale massima sconto offerta</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>  | Percentuale massima di sconto dell'offerta. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, *Tipo offerta* = `GENERAL_SALE`, e *Tipo di sconto dell'offerta* = `PERCENT_MAXIMUM`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>Regalo offerta</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                      | Dettagli del regalo. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, e *Tipo offerta* = `GIFT_WITH_PURCHASE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>Rimborso offerta</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                    | Importo del rimborso. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, e *Tipo offerta* = `REBATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Importo minimo acquisto offerta</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>     | Importo minimo di acquisto dell'offerta. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, e *Tipo offerta* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Importo massimo risparmio offerta</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>   | Importo massimo di risparmio dell'offerta. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, e *Tipo offerta* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Limite acquisto BOGO</em> (Integer)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                     | Quantità massima di articoli consentiti a questo prezzo. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, e *Tipo offerta* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Quantità acquisto BOGO</em> (Integer)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                   | Quantità di acquisto BOGO. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, e *Tipo offerta* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Tipo acquisto BOGO</em> (String)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                        | <p>Tipo di articolo acquistato BOGO. Obbligatorio se <em>ID offerta</em> non viene fornito, <em>Nome offerta</em> è, e <em>Tipo offerta</em> = <code>BOGO</code>.</p><p>Valori consentiti:</p><p><code>PRODUCT</code>, <code>CATEGORY</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>Nome acquisto BOGO</em> (String)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                        | Nome del prodotto o della categoria acquistata. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, e *Tipo offerta* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>Quantità ottenuta BOGO</em> (Integer)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                   | Quantità ottenuta BOGO. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, e *Tipo offerta* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Tipo ottenimento BOGO</em> (String)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                     | <p>Tipo di articolo ottenuto BOGO. Obbligatorio se <em>ID offerta</em> non viene fornito, <em>Nome offerta</em> è, e <em>Tipo offerta</em> = <code>BOGO</code>.</p><p>Valori consentiti:</p><p><code>PRODUCT</code>, <code>CATEGORY</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>Nome ottenimento BOGO</em> (String)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                     | Nome del prodotto o della categoria ottenuta. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, e *Tipo offerta* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>DealBogoGetDiscountType</em> (String)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>                   | <p>Tipo di sconto dell'offerta BOGO. Obbligatorio se <em>ID offerta</em> non viene fornito, <em>Nome offerta</em> è, e <em>Tipo offerta</em> = <code>BOGO</code>.</p><p>Valori consentiti:</p><p><code>GRATIS</code>, <code>IMPORTO</code>, <code>PERCENT</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>DealBogoGetDiscountAmount</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>           | Importo dello sconto dell'offerta BOGO. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, *Tipo offerta* = `BOGO`, e *DealBogoGetDiscountType* = `IMPORTO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>DealBogoGetDiscountPercent</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea una nuova offerta.</p>          | Percentuale di sconto dell'offerta BOGO. Obbligatorio se *ID offerta* non viene fornito, *Nome offerta* è, *Tipo offerta* = `BOGO`, e *DealBogoGetDiscountType* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>ID offerta</em> (String)</p><p>Obbligatorio - No.</p>                                                              | Identificatore univoco di impact.com per l'offerta a cui la risorsa verrà collegata.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>DealDefaultDiscountCode</em> (String)</p><p>Obbligatorio - No.</p>                                                 | Codice sconto predefinito dell'offerta.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealSyncAdsPromoCodes</em> (Boolean)</p><p>Obbligatorio - No.</p>                                                  | Mantieni sincronizzati gli annunci associati e i codici promozionali con questa offerta. La sincronizzazione si applica alle date a tempo limitato, all'accesso partner con restrizioni e allo stato.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

</details>
{% endstep %}

{% step %}
**Passaggio 3: carica i file creativi della risorsa**

Per prima cosa, dovrai avere pronti i file creativi della risorsa in modo che possano essere caricati.

1. Nella *Specifica immagini* pagina, seleziona **Scegli file** per caricare in blocco i file creativi della risorsa. I nomi dei file caricati devono corrispondere esattamente ai nomi nel campo creativo del file di metadati (ad esempio, se il campo creativo contiene `Example.jpg`, il file creativo della risorsa che carichi dovrebbe essere anch'esso chiamato `Example.jpg`).
   * Tieni premuto **Comando ⌘** su macOS o **CTRL** su PC per selezionare più file creativi della risorsa da caricare contemporaneamente.
2. Seleziona **Accetta e crea annunci**. Una volta caricati tutti gli asset, appariranno nel [*Annunci*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) pagina.
   {% 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/it/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.
