> 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 in blocco le risorse

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.

**Avrai bisogno di due file per eseguire un caricamento di annunci in blocco:**

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

{% stepper %}
{% step %}
**Passo 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 il tuo file, quindi eventuali spazi, segni di punteggiatura o caratteri speciali saranno presenti se vengono utilizzati. Per iniziare, copia il modello CSV mostrato di seguito e incollalo in un'applicazione di foglio di calcolo oppure![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1c990ed7d1179d6bc54ec8a2f98688d63ffdf977%2F1ca7fd10d94ed494c076e86be8f0d3f371693b11c47f1b26ec0435a27e0e48c5.svg?alt=media)[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:** Ti consigliamo di usare la *Formato del file* dettagli disponibili nella [*Caricamento in blocco*](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, tieni presente i 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. Questo rimuove 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 di banner,Questo è un esempio di un nuovo annuncio banner che caricheresti.,12345,BANNER,IR,Banner_Creative1,,,,"Banner, NuovoBanner",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 con link testuale.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Fai clic qui per maggiori informazioni!,,,,,,,,,,,,,,"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 — solo i campi compilati verranno aggiornati.
* 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 %}
**Passo 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) **\[Engage]** → **Contenuto** → [**Annunci**](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml)**.**
2. Nell'angolo in alto a destra, seleziona **Caricamento in blocco**.
3. Seleziona  **Scegli file**, carica il tuo file in blocco e seleziona **Apri**.
   * Seleziona  **Mostra/nascondi i dettagli del formato del file** per visualizzare informazioni sulle colonne obbligatorie, le loro descrizioni, i valori accettati e se sono obbligatorie nel *colonne di intestazione degli annunci* e *colonne di intestazione dei deal* riferimenti qui 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 degli annunci</summary>

| Nome colonna                                                                                                        | Descrizione                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>Operation</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>ProgramId</em> (Integer)</p><p>Obbligatorio - sempre.</p>                                                    | L'ID Program di impact.com univoco 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>AdID</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 *Operation* = `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>IN SOSPESO</code>, <code>EXPIRED</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>Nome</em> (String)</p><p>Obbligatorio - quando si crea un asset.</p>                                         | *Nome dell'asset*. Obbligatorio se *Operation* = `CREATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>AdType</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>Operation</em> = <code>CREATE</code>.</p><p>Valori consentiti:</p><p><code>IMAGE</code>, <code>TEXT\_LINK</code>, <code>COUPON</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>HostedBy</em> (String)</p><p>Obbligatorio - quando si crea un asset immagine.</p>                            | <p>Dove è ospitato il creativo dell'asset. Obbligatorio se</p><p><em>Operation</em> = <code>CREATE</code> e <em>AdType</em> = <code>IMAGE</code>.</p><p>Valori consentiti:</p><p><code>IR</code>, <code>URL</code>, <code>HTML</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Creative</em> (String)</p><p>Obbligatorio - quando si crea un asset immagine.</p>                            | <p>Nome del file creativo da caricare. Obbligatorio se</p><p><em>Operation</em> = <code>CREATE</code> e <em>AdType</em> = <code>IMAGE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>IabAdUnit</em> (String)</p><p>Obbligatorio - quando si crea un asset immagine.</p>                           | <p>Dimensione standard dell'asset IAB. Obbligatorio se <em>Operation</em> =</p><p><code>CREATE</code> e <em>AdType</em> = <code>IMAGE</code> e <em>HostedBy</em> != <code>IR</code>.</p><p>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 da terze parti, in pixel.</p><p>Obbligatorio se <em>Operation</em> = <code>CREATE</code> e <em>IabAdUnit</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 da terze parti, in pixel.</p><p>Obbligatorio se <em>Operation</em> = <code>CREATE</code> e <em>IabAdUnit</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 viene fornita LimitedTimeStartDate</p>                | Questa è una data ISO8601. Formato di esempio: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>LinkText</em> (String)</p><p>Obbligatorio - quando si crea un asset di tipo link testuale o coupon.</p>      | Testo effettivamente visualizzato per il link. Obbligatorio se *Operation* = `CREATE` e *AdType* = `TEXT_LINK` o `COUPON`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>Descrizione</em></p><p>Obbligatorio - No.</p>                                                                | Descrizione dell'asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>Etichette</em> (stringa CSV)</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ù profonda all'interno del sito dell'inserzionista.</p><p>Impostazione predefinita: <code>vero</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>AllowCustomPromoCode</em> (Boolean)</p><p>Obbligatorio - No.</p>                                             | <p>Consente al Partner di richiedere il proprio codice promo univoco per questa promozione.</p><p>Impostazione predefinita: <code>falso</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>CustomisationCharge</em> (Decimal 10.2)</p><p>Obbligatorio - No.</p>                                         | Importo della tariffa di personalizzazione dell'asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>ImageAlternativeTag</em> (String)</p><p>Obbligatorio - No.</p>                                               | Tag alternativo da usare nel codice dell'asset immagine.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>LandingPage</em> (String)</p><p>Obbligatorio - No.</p>                                                       | <p>L'URL della landing page. Deve contenere il protocollo dell'URL.</p><p>Per impostazione predefinita, viene usata la landing page predefinita del programma se l'asset viene creato e non viene fornita.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>iOSMobileFallbackAppId</em> (String)</p><p>Obbligatorio - No.</p>                                            | Specifica se il traffico mobile deve reindirizzare alla landing page della tua app iOS se non viene rilevata alcuna app. L'ID app deve corrispondere all'ID app di sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>AndroidMobileFallbackAppId</em> (String)</p><p>Obbligatorio - No.</p>                                        | Specifica se il traffico mobile deve reindirizzare alla landing page della tua app Android se non viene rilevata alcuna app. L'ID app deve corrispondere all'ID app di sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>LimitedTimeStartDate</em> (String)</p><p>Obbligatorio - No.</p>                                              | Questa è una data ISO8601. Formato di esempio: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>FallbackAd</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>Season</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>TopSeller</em> (Boolean)</p><p>Obbligatorio - No.</p>                                                        | Top Seller. Impostazione predefinita: `falso`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>ThirdPartyImpressionPixel</em> (String)</p><p>Obbligatorio - No.</p>                                         | HTML del pixel di impressione di terze parti da usare con questo asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>RestrictedToPartners</em> (stringa CSV)</p><p>Obbligatorio - No.</p>                                         | ID Partner separati da virgole che devono avere accesso a questo asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>RestrictedToGroups</em> (stringa CSV)</p><p>Obbligatorio - No.</p>                                           | ID dei gruppi partner separati da virgole che devono avere accesso a questo asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>Metadati</em> (stringa CSV)</p><p>Obbligatorio - No.</p>                                                     | Parametri della stringa di query separati da virgole che verranno aggiunti all'URL di tracciamento.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

</details>

<details>

<summary>colonne di intestazione dei deal</summary>

| Nome colonna                                                                                                 | Descrizione                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>DealName</em> (String)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                         | Nome del deal da creare e collegare all'asset. Obbligatorio se *DealId* non viene fornito.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealType</em> (String)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                         | <p>Tipo di deal da creare. Obbligatorio se <em>DealId</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>DealScope</em> (String)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                        | <p>Obbligatorio se <em>DealId</em> non viene fornito, <em>DealName</em> viene fornito, e <em>DealType</em> != BOGO.</p><p>Valori consentiti:</p><p><code>ENTIRE\_STORE</code>, <code>CATEGORY</code>, <code>PRODUCT</code>, <code>PRODUCTS</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>DealProducts</em> (stringa CSV)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                | <p>Prodotti del deal. Obbligatorio se <em>DealId</em> non viene fornito, <em>DealName</em> viene fornito, e <em>DealScope</em> = <code>PRODUCT</code>.</p><p>Valori consentiti:</p><p>Opzione 1: elenco di nomi di prodotti, ad es. <code>"Prodotto1, Prodotto2"</code>.</p><p>Opzione 2: elenco di coppie valore prodotto, ad es. <code>"name=Prodotto1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Prodotto2;"</code> dove i più prodotti sono separati da virgola e i vari campi del prodotto sono separati da punto e virgola.</p><p>Campi validi: <code>nome</code> - nome prodotto, <code>image</code> - nome file dell'immagine del prodotto del file che intendi caricare nel secondo passaggio del caricamento in blocco, <code>limit</code> - quantità consentita, <code>regularPrice</code> - prezzo prima dello sconto, <code>dealPrice</code> - prezzo dopo lo sconto.</p> |
| <p><em>DealCategories</em> (stringa CSV)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>              | Categorie del deal. Obbligatorio se *DealId* non viene fornito, *DealName* viene fornito, e *DealScope* = `CATEGORY`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>DealLandingPage (String)</em><br>Obbligatorio - No</p>                                                | L'URL della landing page per questo deal. Se lasciato vuoto quando si crea un nuovo deal, verrà usata la landing page predefinita del programma.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>DealMetadata (CSV String)</em><br>Obbligatorio - No</p>                                               | Parametri della stringa di query separati da virgole per il link di tracciamento del deal. Se lasciato vuoto, non verranno aggiunti parametri extra.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>DealAllowDeepLinking (Boolean)</em><br>Obbligatorio - No</p>                                          | Determina se il deeplinking è consentito per la landing page del deal. Se lasciato vuoto, il valore predefinito sarà FALSE.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>DealDiscountType</em> (stringa CSV)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>            | <p>Obbligatorio se <em>DealId</em> non viene fornito, <em>DealName</em> viene fornito, e <em>DealType</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>DealDiscountAmount</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>         | Importo dello sconto della vendita. Obbligatorio se *DealId* non viene fornito, *DealName* è, *DealType* = `GENERAL_SALE`, e *DealDiscountType* = `FIXED`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealDiscountPercent</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>        | Percentuale di sconto della vendita. Obbligatorio se *DealId* non viene fornito, *DealName* è, *DealType* = `GENERAL_SALE`, e *DealDiscountType* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>DealDiscountStartPercent</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>   | Percentuale di inizio dell'intervallo di sconto del deal. Obbligatorio se *DealId* non viene fornito, *DealName* è, *DealType* = `GENERAL_SALE`, e *DealDiscountType* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>DealDiscountEndPercent</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>     | Percentuale di inizio dell'intervallo di sconto del deal. Obbligatorio se *DealId* non viene fornito, *DealName* è, *DealType* = `GENERAL_SALE`, e *DealDiscountType* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>DealDiscountMaximumPercent</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea un nuovo deal.</p> | Sconto percentuale massimo del deal. Obbligatorio se *DealId* non viene fornito, *DealName* è, *DealType* = `GENERAL_SALE`, e *DealDiscountType* = `PERCENT_MAXIMUM`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>DealGift</em> (String)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                         | Dettagli del regalo. Obbligatorio se *DealId* non viene fornito, *DealName* viene fornito, e *DealType* = `GIFT_WITH_PURCHASE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealRebate</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                 | Importo del rimborso. Obbligatorio se *DealId* non viene fornito, *DealName* viene fornito, e *DealType* = `REBATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>DealMinimumPurchaseAmount</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>  | Importo minimo di acquisto del deal. Obbligatorio se *DealId* non viene fornito, *DealName* viene fornito, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>DealMaximumSavingsAmount</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>   | Importo massimo di risparmio del deal. Obbligatorio se *DealId* non viene fornito, *DealName* viene fornito, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>DealBogoPurchaseLimit</em> (Integer)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>           | Quantità massima di articoli consentiti a questo prezzo. Obbligatorio se *DealId* non viene fornito, *DealName* viene fornito, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>DealBogoBuyQty</em> (Integer)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                  | Quantità acquistata BOGO. Obbligatorio se *DealId* non viene fornito, *DealName* viene fornito, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>DealBogoBuyType</em> (String)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                  | <p>Tipo di articolo acquistato BOGO. Obbligatorio se <em>DealId</em> non viene fornito, <em>DealName</em> viene fornito, e <em>DealType</em> = <code>BOGO</code>.</p><p>Valori consentiti:</p><p><code>PRODUCT</code>, <code>CATEGORY</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>DealBogoBuyName</em> (String)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                  | Nome del prodotto o della categoria acquistata. Obbligatorio se *DealId* non viene fornito, *DealName* viene fornito, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>DealBogoGetQty</em> (Integer)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                  | Quantità ottenuta BOGO. Obbligatorio se *DealId* non viene fornito, *DealName* viene fornito, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>DealBogoGetType</em> (String)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                  | <p>Tipo di articolo ottenuto BOGO. Obbligatorio se <em>DealId</em> non viene fornito, <em>DealName</em> viene fornito, e <em>DealType</em> = <code>BOGO</code>.</p><p>Valori consentiti:</p><p><code>PRODUCT</code>, <code>CATEGORY</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealBogoGetName</em> (String)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>                  | Nome del prodotto o della categoria ottenuta. Obbligatorio se *DealId* non viene fornito, *DealName* viene fornito, e *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealBogoGetDiscountType</em> (String)</p><p>Obbligatorio - quando si crea un nuovo deal.</p>          | <p>Tipo di sconto dell'offerta BOGO. Obbligatorio se <em>DealId</em> non viene fornito, <em>DealName</em> viene fornito, e <em>DealType</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 un nuovo deal.</p>  | Importo dello sconto dell'offerta BOGO. Obbligatorio se *DealId* non viene fornito, *DealName* è, *DealType* = `BOGO`, e *DealBogoGetDiscountType* = `IMPORTO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealBogoGetDiscountPercent</em> (Decimal 10.2)</p><p>Obbligatorio - quando si crea un nuovo deal.</p> | Percentuale di sconto dell'offerta BOGO. Obbligatorio se *DealId* non viene fornito, *DealName* è, *DealType* = `BOGO`, e *DealBogoGetDiscountType* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>DealId</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 e i codici promozionali associati con questa offerta. La sincronizzazione si applica alle date a tempo limitato, all'accesso limitato dei partner e allo stato.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

</details>
{% endstep %}

{% step %}
**Passaggio 3: carica i file creativi degli asset**

Successivamente, dovrai avere pronti i file creativi dei tuoi asset in modo che possano essere caricati.

1. Nella *Specifica le immagini* pagina, seleziona **Scegli file** per caricare in blocco i file creativi degli asset. I nomi dei file caricati devono corrispondere esattamente ai nomi nel campo creative del tuo file di metadati (ad es., se il campo creative contiene `Example.jpg`, il file creativo dell'asset che carichi dovrebbe anche chiamarsi `Example.jpg`).
   * Tieni premuto **Comando ⌘** su macOS o **CTRL** su PC per selezionare più file creativi degli asset da caricare contemporaneamente.
2. Seleziona **Accetta e crea annunci**. Una volta che tutti gli asset sono stati caricati, appariranno in [*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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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

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