> 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/beta-product-boost/product-boost-campaign-management/bulk-upload-product-boost-campaigns.md).
# Carica in blocco le campagne Product Boost
Puoi usare lo strumento di caricamento in blocco per creare più campagne Product Boost contemporaneamente invece di crearle singolarmente. Utilizzerai un file CSV o Excel per fornire i dettagli dei campi che altrimenti compileresti durante la configurazione.
{% stepper %}
{% step %}
## Prepara il tuo file
1. Copia o scarica questo file modello sul tuo dispositivo:
{% code overflow="wrap" %}
```
Nome campagna,ID venditore,ID campagna interno,Finanziamento,Tipo di idoneità,ID partner,ID gruppo partner,Budget,Budget vincolato,Bozza,Data di inizio,Data di fine,ID tipo evento,Tipo di payout,Valore del payout,Precedenza,Regole
Promo stivali invernali,,EXAMPLE-001,,JOINED_PARTNERS,,,1000.00,no,yes,2026-08-01T00:00:00-07:00,2026-08-31T23:59:59-07:00,17897,FIXED,5.00,10,ITEM_SKU IS BOOT123
```
{% endcode %}
2. Sostituisci la riga di esempio con i dettagli della tua campagna e compila una riga per ogni campagna che desideri creare.
* Controlla i tuoi valori rispetto al [riferimento del formato file](#file-format-reference) qui sotto per assicurarti di inserire dati corretti e nei formati richiesti.
* Per aggiungere più regole di gruppo di payout a una singola campagna, consulta la [sezione dei gruppi di payout](#add-multiple-payout-groups) qui sotto.
3. Salva le modifiche al tuo file con un nome appropriato, ad es., `Product_Boost_Bulk_Upload`. Assicurati che il file venga salvato nel formato `.csv` o `.xlsx` .
{% endstep %}
{% step %}
## Carica le tue campagne
1. Dalla barra di navigazione a sinistra, seleziona  **\[Engage]** → **Gestione campagne** → [**Product Boost**](https://app.impact.com/secure/advertiser/engage/campaigns/manage-rate-boost-campaigns-flow.ihtml?execution=e3s1#sortBy=dateOfEntry\&sortOrder=ASC).
2. Nell'angolo in alto a destra dello schermo, seleziona **Caricamento in blocco**.
3. Seleziona **Scegli file** oppure trascina e rilascia il file che hai preparato per il caricamento.
4. Seleziona **Avanti**.
{% endstep %}
{% step %}
## Esamina eventuali errori di convalida
1. Controlla i dati caricati per individuare eventuali errori.
* Gli errori di convalida saranno evidenziati in rosso, con gli errori elencati nella prima colonna, così che tu possa correggerli.
* Ogni riga rappresenta una singola campagna. Per filtrare le righe con convalida riuscita, seleziona  **\[Casella di controllo] Mostra solo errori**.
2. Se nel tuo file sono presenti errori, seleziona **Indietro** per tornare al passaggio di caricamento. Fai riferimento alla [riferimento degli errori di convalida](#validation-error-reference) qui sotto per indicazioni su come risolvere gli errori.
* Quando tutte le righe sono prive di errori e mostrano *OK* nella prima colonna, le tue campagne sono pronte per essere create.
{% endstep %}
{% step %}
## Approva la creazione della campagna
1. Seleziona **Accetta e crea le campagne**.
* Le nuove campagne caricate appariranno nell'elenco delle tue campagne.
2. Successivamente, scopri cosa significa ogni stato della campagna Product Boost e come [gestirle](/brand/it/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/manage-product-boost-campaigns.md).
{% endstep %}
{% endstepper %}
## Riferimenti
Riferimento del formato file
Usa questo riferimento come guida quando aggiorni i dati segnaposto nel tuo file con i dettagli della tua campagna.
| Nome colonna | Tipo | Obbligatorio | Descrizione |
| ------------------- | ------------ | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nome campagna | Stringa | Sì | Il nome della campagna |
| ID venditore | Intero | No | L'ID del venditore, se applicabile. Può essere ottenuto dalla tua [*I miei venditori*](/brand/it/what-would-you-like-to-learn-about/beta-product-boost/beta-product-boost-for-retailers/get-started-with-retail-media-as-a-retailer.md#step-2-view-your-listed-vendors) pagina |
| ID campagna interno | Stringa | No | Il tuo identificatore opzionale per questa campagna |
| Finanziamento | Stringa | No | I dettagli di finanziamento della campagna |
| Tipo di idoneità | Stringa | Sì | Identifica i partner idonei che verranno automaticamente ingaggiati. Per gruppi o partner specifici, aggiungi gli ID separandoli con una virgola. Valori consentiti: `JOINED_PARTNERS`, `PARTNER_GROUPS`, `INDIVIDUAL_PARTNERS` |
| ID partner | stringa CSV | No | ID partner separati da virgole. Obbligatorio quando il Tipo di idoneità è `INDIVIDUAL_PARTNERS`. |
| ID gruppo partner | stringa CSV | No | ID gruppo partner separati da virgole. Obbligatorio quando il Tipo di idoneità è `PARTNER_GROUPS`. |
| Budget | Decimal(8,2) | Sì | Budget totale per la campagna |
| Budget vincolato | Booleano | No | Lascia vuoto se non vuoi applicarlo. Valori accettati: `sì`, `true` (termina automaticamente la campagna quando il budget è esaurito) oppure `no`, `false` (non applicare). |
| Bozza | Booleano | Sì | Se salvare la campagna come bozza. Valori accettati: `sì`, `true` (salva come bozza) oppure `no`, `false` (attiva immediatamente). |
| Data di inizio | Data | Sì | Data ISO8601. Esempio: `2013-06-30T00:00:00-07:00` |
| Data di fine | Data | Sì | Data ISO8601. Esempio: `2013-06-30T00:00:00-07:00` |
| ID tipo di evento | Intero | Sì | L'ID numerico del tipo di evento per il tracker principale del payout di questa campagna. |
| Tipo di payout | Stringa | Sì | Il tipo di payout per questo evento (ad es. `PERCENTAGE` o `FIXED`). |
| Valore del payout | Decimal(8,2) | Sì | L'importo del payout per questo tipo di evento. Deve essere maggiore di zero. |
| Precedenza | Intero | Sì | Priorità della campagna da 1 (più alta) a 10 (più bassa). |
| Regole | Stringa | Sì | Una condizione di idoneità nel formato `[VARIABLE] [OPERATOR] [VALUE]` ad es., `ITEM_SKU IS HYD-2000`. Scopri di più su come [impostare le regole del gruppo di payout](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md). |
Riferimento errori di convalida
Se i dati caricati contengono errori di convalida, trova di seguito il messaggio di errore per vedere quale potrebbe esserne la causa e come correggerlo.
| Messaggio di errore | Come correggere |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| La data di inizio del periodo limitato non è valida | Controlla che la tua `Data di inizio` abbia un valore, sia precedente a `Data di fine`, ed è nel formato ISO8601 (ad es. `2026-08-01T00:00:00-07:00`). |
| La data di fine del periodo limitato non è valida | Controlla che la tua `Data di fine` abbia un valore, sia successiva a `Data di inizio`, ed è nel formato ISO8601 (ad es., `2026-08-30T00:00:00-07:00`). |
| La bozza è obbligatoria | Invio `sì`/`true` o `no`/`false` nel `Bozza` colonna per indicare se la campagna deve essere salvata come bozza o attivata immediatamente. |
| Il tipo di idoneità è obbligatorio | Inserisci uno dei tre valori accettati nella `Tipo di idoneità` colonna: `JOINED_PARTNERS`, `PARTNER_GROUPS`, oppure `INDIVIDUAL_PARTNERS`. |
| La precedenza è obbligatoria | Inserisci un numero intero da 1 (priorità più alta) a 10 (priorità più bassa) nella `Precedenza` colonna. |
| La data di inizio non può essere nel passato | Aggiorna `Data di inizio` a una data futura, formattata in ISO8601 (ad es., `2026-08-01T00:00:00-07:00`). |
| L'ID del tipo di evento non appartiene a questo programma | Il `ID tipo di evento` che hai inserito non corrisponde ad alcun tipo di evento effettivamente collegato al tuo programma. Scopri come [trovare l'ID del tuo tipo di evento](/brand/it/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md). |
| La colonna Regole contiene un'espressione di regola non valida. Usa il formato \[Variabile Operatore Valore] e collega più regole con AND. |
Usa una condizione per riga, nel formato VARIABLE OPERATOR VALUE ad es., ITEM\_SKU IS HYD-2000.
Non usare parentesi quadre o AND. Verifica inoltre che il Valore esista nel tuo catalogo prodotti. Vedi Aggiungi più regole di gruppo di payout di seguito per ulteriori informazioni.
|
## Aggiungi più regole di gruppo di payout
Puoi aggiungere più [regole di gruppo di payout](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/set-payout-rules-using-payout-groups.md) a una singola campagna aggiungendo una *riga di continuazione* al tuo file dopo la riga della campagna. Nella riga di continuazione, lascia *Nome campagna* vuoto. Ecco come apparirebbe il caricamento del tuo file durante la convalida:
Ripetere lo stesso `ID tipo di evento` della riga primaria consente al sistema di leggere la tua riga di continuazione come una regola di payout aggiuntiva per lo stesso tipo di evento. Per sapere quali colonne compilare per le righe di continuazione, vedi il riferimento qui sotto.
Linee guida per le righe delle regole di payout
Quando aggiungi più regole di gruppo di payout a una campagna, applica queste linee guida a tutte le righe di continuazione.
| Nome colonna | Tipo | Obbligatorio | Descrizione |
| ----------------- | ------------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nome campagna | Stringa | No | Lascia vuoto per contrassegnarla come riga di continuazione associata alla campagna definita immediatamente sopra. |
| ID tipo di evento | Intero | Sì | ID del tipo di evento per questo gruppo di payout. |
| Tipo di payout | Stringa | Sì | Tipo di payout per questo tipo di evento aggiuntivo (ad es. `PERCENTAGE` o `FIXED`). |
| Valore del payout | Decimal(8,2) | Sì | Importo del payout per questo tipo di evento aggiuntivo. Deve essere maggiore di zero. |
| Regole | Stringa | Sì | Una condizione di idoneità nel formato `VARIABLE OPERATOR VALUE` — ad esempio, `ITEM_SKU IS HYD-2000`. Vedi il [riferimento degli errori di convalida](#validation-error-reference) se non viene convalidato. |
{% hint style="success" %}
**Nota:** Una singola campagna può anche tracciare più di un tipo di evento. Nella riga di continuazione, inserisci un `ID tipo di evento` diverso da quello della riga primaria invece di ripeterlo. Per sapere quali colonne compilare per le righe di continuazione, vedi il riferimento sopra.
{% endhint %}
### File di esempio con una riga di continuazione
{% code overflow="wrap" %}
```
Nome campagna,ID venditore,ID campagna interno,Finanziamento,Tipo di idoneità,ID partner,ID gruppo partner,Budget,Budget vincolato,Bozza,Data di inizio,Data di fine,ID tipo evento,Tipo di payout,Valore del payout,Precedenza,Regole
Promo stivali invernali,,EXAMPLE-001,,JOINED_PARTNERS,,,1000.00,no,yes,2026-08-01T00:00:00-07:00,2026-08-31T23:59:59-07:00,17897,FIXED,5.00,10,ITEM_SKU IS BOOT123
,,,,,,,,,,,,17897,FIXED,3.00,,ITEM_SKU IS BOOT456
```
{% endcode %}
---
# 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/beta-product-boost/product-boost-campaign-management/bulk-upload-product-boost-campaigns.md?ask=&goal=
```
`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.
