> 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

Se vuoi creare più codici promozionali, usa la **Caricamento massivo** funzionalità per caricare un file CSV, XLS o XLSX con i dati dei tuoi codici promozionali.

Fai riferimento alla *Riferimento per il caricamento massivo dei codici promozionali* tabelle qui sotto per aiutarti a strutturare questo file. Per garantire che il caricamento abbia successo, mantieni la dimensione del file sotto 1 MB per XLS/XLSX o 5 MB per CSV. La convalida si basa rigorosamente sulla dimensione del file, quindi non esiste un limite specifico al numero di righe.

{% hint style="warning" %}
**Avvertenza:** Assicurati che le intestazioni delle colonne nel tuo file CSV/XLS corrispondano esattamente ai nomi delle colonne qui sotto (maiuscole/minuscole e spazi inclusi), altrimenti il caricamento del file potrebbe essere rifiutato.
{% endhint %}

{% hint style="info" %}
**Esempio:** L'esempio qui sotto è per un codice promozionale di esempio `10PEROFF`.

```programlisting
Codice promozionale,ID campagna,ID media,Tipo,Regola di credito,Modalità di corrispondenza,Offerta
Nome10PEROFF,4321,1299679,TRACKING,ALWAYS,LI,
```

{% endhint %}

#### Caricamento massivo dei codici promozionali di tracking

1. Dal menu di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Interagisci]** → **Contenuto** → **Codici promozionali**.
2. Nella *Codici promozionali* schermata, seleziona **Caricamento massivo**.
3. Seleziona **Scegli file** e quindi individua e seleziona il file Excel/CSV con i codici promozionali che desideri caricare.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Nota:</strong> Assicurati che il tuo file utilizzi il formato delle colonne richiesto mostrato nella tabella qui sotto.</p></div>

   | Colonna                    | Tipo    | Obbligatorio | Descrizione                                                                                                                                                                    |
   | -------------------------- | ------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   | Codice promozionale        | Stringa | Sì           | Il codice promozionale univoco da assegnare.                                                                                                                                   |
   | ID programma               | Intero  | Sì           | L'ID programma univoco di impact.com a cui appartiene l'annuncio.                                                                                                              |
   | ID media                   | Intero  | Sì           | L'ID media di impact.com a cui verrà assegnato il codice promozionale. Può trattarsi di un ID partner o di un ID sorgente media.                                               |
   | Tipo                       | Stringa | Sì           | <p>Il tipo di codice promozionale. Valori consentiti:</p><p><code>TRACKING</code></p>                                                                                          |
   | Regola di attribuzione     | Stringa | Sì           | <p>La regola di credito del codice promozionale. Valori consentiti:</p><p><code>ALWAYS</code></p><p><code>INVOLVED</code></p><p><code>WINNER</code></p>                        |
   | Modalità di corrispondenza | Stringa | Sì           | <p>La modalità di corrispondenza del codice promozionale. Valori consentiti:</p><p><code>LI</code> (Esatto/letterale)</p><p><code>RE</code> (Regex/Espressione regolare)</p>   |
   | ID offerta                 | Intero  | No           | L'ID univoco dell'offerta a cui questo codice promozionale deve essere associato. L'offerta deve già esistere nel tuo programma.                                               |
   | Data di inizio attiva      | Data    | No           | Ti consente di pianificare questa restrizione. Si tratta di una [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) Data. Formato di esempio: `2013-06-30T00:00:00-07:00`        |
   | Data di fine attiva        | Data    | No           | Questa è una data ISO8601. Formato di esempio: `2013-06-30T00:00:00-07:00`                                                                                                     |
   | Fuso orario                | Stringa | No           | Il fuso orario viene derivato dalla data di inizio, ma se desideri sovrascriverlo con un fuso orario specifico, inserisci qui il nome completo, ad esempio `America/New_York`. |

   Ogni codice promozionale di tracking caricato può essere assegnato solo a 1 partner o sorgente media tramite il `ID media` campo. Se un altro partner promuove quel codice, impact.com contrassegna la conversione risultante come conversione non valida e la annulla.
4. Seleziona **Avanti**.
5. Rivedi l'elenco dei codici promozionali che verranno caricati. Se i dettagli sono corretti, seleziona **Accetta e crea codici promozionali**.
6. Se il caricamento ha successo, i nuovi *i codici promozionali di tracking* vengono creati ed elencati nella *Codici promozionali* schermata.

#### Campi per il caricamento massivo dei codici promozionali con restrizioni

{% hint style="info" %}
**Nota:** Nell'ambito dei continui miglioramenti della piattaforma, stiamo ritirando la funzionalità *Codici promo limitati* alla fine di febbraio. Ti preghiamo di rivedere le configurazioni attuali e pianificare di conseguenza.
{% endhint %}

Prima di iniziare, comprendi la differenza tra i due tipi di restrizione:

* **Lista bianca**
  * Scopo: definire un elenco di codici promozionali che devono essere utilizzati affinché un Partner riceva il credito per una vendita.
  * Si consiglia questa opzione se il tuo elenco di codici promozionali autorizzati è più piccolo del tuo elenco non autorizzato.
* **Lista nera**
  * Scopo: definire un elenco di codici promozionali che, se utilizzati, non attribuiranno il credito di una vendita a un Partner.
  * Si consiglia questa opzione se il tuo elenco di codici promozionali non autorizzati è più piccolo del tuo elenco autorizzato.

**Passaggio 1: scegli il tipo di restrizione**

1. Dal menu di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Interagisci]** → **Contenuto** → **Codici promozionali**.
2. Nella *Codici promozionali* schermata, seleziona **Crea codice promozionale** ![](/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8) **\[Menu a discesa]** → **Limitato**.
3. Nella *Restrizioni dei codici promozionali* pagina, seleziona ![](/files/0aafef99ec4e77d9b7b3e0531467b63590add75d) **Configura le restrizioni dei codici promozionali**.
4. Viene visualizzata la pagina Restrizioni codici promozionali, che mostra due colonne per la configurazione:
   * Facoltativamente, seleziona ![](/files/0aafef99ec4e77d9b7b3e0531467b63590add75d) **Configura lista bianca**, per caricare i codici promozionali inseriti nella lista bianca.
   * Facoltativamente, seleziona ![](/files/0aafef99ec4e77d9b7b3e0531467b63590add75d) **Configura lista nera**, per caricare i codici promozionali inseriti nella lista nera.

**Passaggio 2: carica il tuo file**

1. Seleziona **Scegli file**, quindi individua e seleziona il file Excel/CSV con i codici promozionali con restrizioni che desideri caricare.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Nota:</strong> Assicurati che il tuo file utilizzi il formato delle colonne richiesto mostrato nella tabella qui sotto.</p></div>

   | Colonna                    | Tipo    | Obbligatorio | Descrizione                                                                                                                                                                    |
   | -------------------------- | ------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   | Codice promozionale        | Stringa | Sì           | Il codice promozionale univoco da assegnare.                                                                                                                                   |
   | ID programma               | Intero  | Sì           | L'ID programma univoco di impact.com a cui appartiene l'annuncio.                                                                                                              |
   | Tipo                       | Stringa | Sì           | <p>Il tipo di codice promozionale. Valore consentito:</p><p><code>RESTRICTED</code></p>                                                                                        |
   | Modalità di corrispondenza | Stringa | Sì           | <p>Il codice di corrispondenza del codice promozionale. Valori consentiti:</p><p><code>LI</code> (Esatto/letterale)</p><p><code>RE</code> (Regex/Espressione regolare)</p>     |
   | Data di inizio attiva      | Data    | No           | Ti consente di pianificare questa restrizione. Si tratta di una data ISO8601. Formato di esempio: `2013-06-30T00:00:00-07:00`.                                                 |
   | Data di fine attiva        | Data    | No           | Questa è una data ISO8601. Formato di esempio: `2013-06-30T00:00:00-07:00`                                                                                                     |
   | Fuso orario                | Stringa | No           | Il fuso orario viene derivato dalla data di inizio, ma se desideri sovrascriverlo con un fuso orario specifico, inserisci qui il nome completo, ad esempio `America/New_York`. |
2. Seleziona **Avanti**.
3. Rivedi l'elenco dei codici con restrizioni visualizzati nella *Caricamento massivo dei codici promozionali* pagina.
   * Facoltativamente, per visualizzare solo le voci che contengono errori, seleziona **Mostra solo errori**.
4. Se i dettagli sono corretti, seleziona **Accetta e crea codici promozionali**.

**Passaggio 3: aggiungi eccezioni per i partner media**

1. Nella *Controlli del partner media* pagina, scegli come verranno applicate le regole di restrizione:
   1. Facoltativamente, seleziona **Applica a tutti i partner**, se desideri che questa regola si applichi a tutti.
   2. Facoltativamente, seleziona **Consenti a determinati partner di bypassare questa regola e ricevere il credito per i codici promozionali con restrizioni**.

      Se scegli di consentire il bypass, seleziona **Cerca** e quindi seleziona e **Aggiungi** i partner specifici dall'elenco.
2. Seleziona **Salva e attiva**.
3. La nuova regola del codice promozionale con restrizioni viene attivata e i codici caricati vengono applicati al *Lista bianca* o *Lista nera*.


---

# 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/promo-codes/bulk-upload-promo-codes.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.
