> 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/gestione-delle-campagne-product-boost/carica-in-blocco-le-campagne-product-boost.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. Userai 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 applicato,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 al formato del file](#file-format-reference) qui sotto per assicurarti di inserire i dati corretti e nei formati richiesti. * Per aggiungere più regole di gruppo di payout a una singola campagna, consulta la [sezione gruppi di payout](#add-multiple-payout-groups) qui sotto. 3. Salva le modifiche al tuo file con un nome appropriato, ad esempio, `Product_Boost_Bulk_Upload`. Assicurati che il file venga salvato in `.csv` o `.xlsx` formato. {% endstep %} {% step %} ## Carica le tue campagne 1. Dalla barra di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage]** → **Campaign Manager** → [**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. Esamina i dati caricati per individuare errori. * I fallimenti della convalida verranno evidenziati in rosso, con gli errori elencati nella prima colonna affinché tu possa correggerli. * Ogni riga rappresenta una singola campagna. Per filtrare le righe con convalida riuscita, seleziona ![](/files/cec8fb6b06bdba97a0f302d45d30862de79a5365) **\[Checkbox] Mostra solo errori**. 2. Se ci sono errori nel tuo file, seleziona **Indietro** per tornare al passaggio di caricamento. Consulta il [riferimento agli errori di convalida](#validation-error-reference) qui sotto per indicazioni su come risolvere gli errori. * Quando tutte le righe sono corrette e mostrano *OK* nella prima colonna, le tue campagne sono pronte per essere create.
{% endstep %} {% step %} ## Approva la creazione delle campagne 1. Seleziona **Accetta e crea le campagne**. * Le nuove campagne che hai caricato appariranno nell'elenco delle tue campagne. 2. Successivamente, scopri cosa significa lo stato di ciascuna campagna Product Boost e come [gestirle](/brand/it/what-would-you-like-to-learn-about/beta-product-boost/gestione-delle-campagne-product-boost/manage-product-boost-campaigns.md). {% endstep %} {% endstepper %} ## Riferimenti
Riferimento al formato del 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. Puoi trovarlo nella 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ì | Individua i partner idonei che verranno ingaggiati automaticamente. Per gruppi o partner specifici, aggiungi gli ID e separali 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 applicato | Booleano | No | Lascia vuoto se non vuoi applicare l'enforcement. Valori accettati: `yes`, `true` (termina automaticamente la campagna quando il budget è completamente speso) oppure `no`, `false` (non applicare). | | Bozza | Booleano | Sì | Indica se salvare la campagna come bozza. Valori accettati: `yes`, `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 evento | Intero | Sì | L'ID numerico del tipo di evento per il tracker di payout principale 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 `[VARIABILE] [OPERATORE] [VALORE]` 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 agli errori di convalida Se i dati caricati contengono errori di convalida, trova il messaggio di errore qui sotto per vedere quale potrebbe esserne la causa e come correggerlo. | Messaggio di errore | Come correggere | | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | La data di inizio del periodo limitato non è valida | Verifica che il tuo `Data di inizio` abbia un valore, venga prima di `Data di fine`, e sia nel formato ISO8601 (ad es. `2026-08-01T00:00:00-07:00`). | | La data di fine del periodo limitato non è valida | Verifica che il tuo `Data di fine` abbia un valore, venga dopo il `Data di inizio`, e sia nel formato ISO8601 (ad es., `2026-08-30T00:00:00-07:00`). | | La bozza è obbligatoria | Inserisci `yes`/`true` o `no`/`false` nella `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 | L' `ID tipo evento` che hai inserito non corrisponde ad alcun tipo di evento effettivamente collegato al tuo programma. Scopri come [trovare il tuo ID del 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 \[Variable Operator Value], concatenando più regole con AND. |

Usa una condizione per riga, nel formato VARIABLE OPERATOR VALUE ad es., ITEM\_SKU IS HYD-2000.

Non usare parentesi o AND. Verifica anche che il Valore esista nel tuo catalogo prodotti. Consulta Aggiungi più regole di gruppo di payout qui sotto 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:
Ripetendo lo stesso `ID tipo evento` della riga principale, il sistema può leggere la riga di continuazione come una regola di payout aggiuntiva per lo stesso tipo di evento. Per scoprire quali colonne compilare per le righe di continuazione, consulta 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 evento | Intero | Sì | ID 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` — per esempio, `ITEM_SKU IS HYD-2000`. Consulta il [riferimento agli 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 evento` diverso da quello della riga principale invece di ripeterlo. Per scoprire quali colonne compilare per le righe di continuazione, consulta 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 applicato,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/gestione-delle-campagne-product-boost/carica-in-blocco-le-campagne-product-boost.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.