> 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/promo-codes/bulk-upload-promo-codes.md).
# Carica in blocco i codici promozionali
Puoi creare più codici promozionali di tracciamento contemporaneamente da un file CSV, XLS o XLSX. Dopo aver caricato il file, impact.com convalida ogni riga così puoi esaminare e correggere eventuali errori prima di creare i codici promozionali.
I file possono avere fino a 5 MB per CSV o 1 MB per XLS e XLSX. La convalida si basa solo sulla dimensione del file, quindi non c'è alcun limite al numero di righe.
## Carica i tuoi codici promozionali
1. Dal menu di navigazione a sinistra, seleziona  **\[Engage]** → **Contenuti** → [**Codici promozionali**](https://app.impact.com/secure/advertiser/engage/ads/view-adv-promo-codes-flow.ihtml).
2. Nella *Codici promozionali* schermata, seleziona **Caricamento in blocco**.
3. Facoltativamente, seleziona **Scarica** per ottenere un file modello di esempio, oppure seleziona **Visualizza i dettagli del formato** per visualizzare le colonne richieste.
4. Seleziona **Scegli file**, quindi individua e seleziona il tuo file. Puoi anche trascinare e rilasciare il file sulla pagina.
5. Seleziona **Continua**.
6. Esamina la tabella *Anteprima dati* . La colonna *Convalida* mostra *Approvato* per le righe pronte, oppure un messaggio di errore per le righe che richiedono modifiche.
* Facoltativamente, per ordinare le righe, seleziona un'intestazione di colonna oppure seleziona **Ordine di ordinamento**.
* Per visualizzare tutti gli errori di una riga, seleziona  **\[Espandi]** accanto al codice promozionale. L' *Anteprima errori* elenca ogni colonna, il relativo valore e il problema.
* Per correggere gli errori, aggiorna il file, seleziona **Annulla** accanto al nome del file, quindi carica il file corretto.
7. Seleziona **Accetta e crea codici promozionali**. Il messaggio accanto al pulsante mostra il numero di codici promozionali approvati che impact.com crea. Se nessuna riga è approvata, il pulsante è disabilitato.
impact.com crea i codici promozionali approvati e ti riporta alla *Codici promozionali* schermata. Vengono create solo le righe approvate. Se si verifica un errore durante la creazione dei codici promozionali da parte di impact.com, viene visualizzato un messaggio di errore con un codice di errore. Contatta l'assistenza e includi questo codice.
Per annullare un caricamento in blocco, seleziona  **\[Chiudi]** nell'angolo in alto a destra della schermata, quindi seleziona **Conferma**.
{% hint style="success" %}
**Nota:** I codici promozionali con una data di inizio futura hanno uno stato *In sospeso* . La schermata mostra *Codici promozionali* per impostazione predefinita i *Codici promozionali attivi* , quindi modifica il filtro [*Pianificazione del codice* filtro](/brand/it/what-would-you-like-to-learn-about/platform-features/promo-codes/manage-your-promo-codes.md) per trovarli.
{% endhint %}
## Formatta il file del tuo codice promozionale
Il file deve usare esattamente i nomi delle colonne riportati di seguito, inclusi maiuscole/minuscole e punti finali, altrimenti il caricamento viene rifiutato.
| Colonna | Tipo | Obbligatorio | Descrizione |
| ---------------------- | ----------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Operazione` | Stringa | Sì | L'operazione di caricamento in blocco. Valore consentito: `CREATE`. |
| `media.id` | Intero | Sì | L'ID media di impact.com a cui è assegnato il codice promozionale. Può essere l'ID di un account partner o l'ID di una fonte media.
Ogni codice promozionale di tracciamento può essere assegnato solo a 1 partner o fonte media. Se un altro partner promuove quel codice, impact.com contrassegna la conversione risultante come non valida e la annulla.
|
| `codice` | Stringa | Sì | Il codice promozionale univoco. Non può contenere parentesi angolari (`<`, `>`) o virgolette doppie. |
| `creditRule` | Stringa | Sì | La regola di credito del codice promozionale. Valori consentiti:
ALWAYS (Sempre accredita)
INVOLVED (Accredita se coinvolto)
WINNER (Accredita se vincitore)
|
| `matchMode` | Stringa | Sì | La modalità di corrispondenza del codice promozionale. Valori consentiti:
LI (Esatto/Letterale)
RE (Regex/Espressione regolare)
|
| `deal.id` | Intero | No | L'ID del [deal](/brand/it/what-would-you-like-to-learn-about/platform-features/deals.md) da associare al codice promozionale. Il deal deve già esistere nel tuo programma. |
| `scheduling.startDate` | Data | Sì | Quando il codice promozionale diventa disponibile. Inserisci una data e un'ora locali senza offset del fuso orario, nel formato `YYYY-MM-DDTHH:mm:ss` (ad esempio, `2026-10-01T00:00:00`). |
| `scheduling.endDate` | Data | Sì | Quando il codice promozionale scade. Usa lo stesso formato di `scheduling.startDate` (ad esempio, `2026-12-31T23:59:59`). |
| `scheduling.timezone` | Stringa | Sì | Il fuso orario IANA (Internet Assigned Numbers Authority) per le date pianificate (ad esempio, `America/New_York`). |
| `emailAddresses` | Stringa CSV | No | Un elenco di indirizzi email separati da virgole da notificare riguardo a questo codice promozionale. |
| `commenti` | Stringa | No | Commenti in testo libero per questa riga. |
Esempio: questa riga crea il codice promozionale `10PEROFF` per 1 partner, disponibile dal 1° ottobre al 31 dicembre 2026, nel fuso orario di New York.
```csv
Operazione,media.id,codice,creditRule,matchMode,deal.id,scheduling.startDate,scheduling.endDate,scheduling.timezone,emailAddresses,commenti
CREATE,1299679,10PEROFF,ALWAYS,LI,,2026-10-01T00:00:00,2026-12-31T23:59:59,America/New_York,carrie.oakey@acmecorporation.io,Promo festivo
```
Riferimento all'errore di convalida
| Messaggio di convalida | Come risolverlo |
| -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| *Valore non riconosciuto* | Il valore non è uno dei valori consentiti, oppure una data usa il formato sbagliato. Controlla la tabella sopra. |
| *Il valore non può contenere parentesi angolari (<, >) o virgolette doppie.* | Rimuovi questi caratteri dal codice promozionale. |
| *Il codice promozionale esiste già per questo programma.* | Usa un codice promozionale che non sia già presente nel tuo programma. |
| *Il partner media \[ID] non è associato alla campagna \[ID]* | Usa l'ID media di un partner o di una fonte media che sia associato al tuo programma. |
| *Deal non trovato* | Usa l'ID di un deal esistente oppure lascia `deal.id` vuoto. |
| *Per le procedure pianificate dei codici promozionali è supportato solo CREATE.* | Imposta `Operazione` a `CREATE`. |
---
# 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/promo-codes/bulk-upload-promo-codes.md?ask=&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.