> 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/product-promotions/upload-product-promotion-files.md). # Carica i file delle promozioni prodotti Il *Promozioni dei prodotti* La funzionalità ti consente di condividere offerte speciali e promozioni con i partner. Queste offerte compaiono nei feed dei prodotti dei partner, nelle API dei prodotti e nel marketplace dei prodotti di impact.com, dove un *Offerta speciale* etichetta visualizzata direttamente sul riquadro del prodotto nei risultati di ricerca. {% hint style="warning" %} **Importante:** Dovrai disporre di un catalogo prodotti attivo prima di poter iniziare. Per assistenza nella creazione del tuo primo caricamento di prodotti, vedi [Aggiungi cataloghi prodotti](/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md). {% endhint %} #### Carica un file delle promozioni {% tabs %} {% tab title="Caricamento diretto" %} 1. Dal menu di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage] → Contenuti → Prodotti → Promozioni dei prodotti**. 2. Nell'angolo in alto a destra, seleziona **Carica file promozioni**. 3. Inserisci i tuoi **Nome file promozione**. 4. Seleziona il ![](/files/36e8ef1ee012e92c7edd9d1bed8bf7fb6f8def89) **\[Pulsante di opzione]** **Caricamento diretto** metodo. 5. Seleziona il file **Formato**. * impact.com supporta solo *Google Merchant Center (formato TXT)* cioè `.txt` e *Google Merchant Center (formato CSV)* cioè `.csv` file. * Fai riferimento alla [*Riferimento dei campi del feed promozionale dei prodotti*](#para-idm73509110741608) di seguito per ulteriori informazioni su questi campi. 6. Seleziona **Scegli file**. * Individua il file che vuoi caricare dal tuo computer. 7. Seleziona il tuo **Lingua** e **Salva**. {% endtab %} {% tab title="Recupera da URL" %} Questa opzione supporta il recupero di un file da un server FTP/SFTP o da un URL HTTP/HTTPS per garantire dati promozionali aggiornati. 1. Dal menu di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage] → Contenuti → Prodotti → Promozioni dei prodotti**. 2. Nell'angolo in alto a destra, seleziona **Carica file promozioni**. 3. Inserisci i tuoi **Nome file promozione**. 4. Seleziona il ![](/files/36e8ef1ee012e92c7edd9d1bed8bf7fb6f8def89) **\[Pulsante di opzione]** **Recupera da URL** metodo di caricamento. 5. Seleziona il file **Formato**. * impact.com supporta solo *Google Merchant Center (formato TXT)* cioè `.txt` e *Google Merchant Center (formato CSV)* cioè `.csv` file. * Fai riferimento alla [*Riferimento dei campi del feed promozionale dei prodotti*](#para-idm73509110741608) di seguito per ulteriori informazioni su questi campi. 6. Inserisci il **nome** del tuo file sotto *Nome file di caricamento*. * [Visualizza questo modello](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) per indicazioni sul caricamento delle tue promozioni. 7. Inserisci il **URL da cui recuperare** che punta alla directory in cui si trova il file dei dati promozionali. * Questo URL può essere un URL FTP o HTTPS. Ad es., `ftp://ftp.acme.com` o `https://acme.com/anvil_promotions/anvil.txt` 8. Seleziona il **Frequenza di recupero** con quale frequenza impact.com recupererà il file: * Giornaliero * Ogni 8 ore * Ogni 4 ore * Ogni 2 ore 9. Seleziona il **Ora di recupero** in cui impact.com recupererà il file. * Le opzioni visualizzate sono in GMT -05:00, ora della costa orientale. 10. Seleziona il tuo **Fuso orario**. 11. Seleziona il tuo **Lingua** e **Salva**. {% endtab %} {% endtabs %}
Riferimento dei campi del feed promozionale dei prodotti | Campi previsti | Obbligatorio? | Descrizione | Formato | | ------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ID `[promotion_id]` | Sì | L'ID univoco di ciascuna promozione. | Questo ID è in formato numerico e non deve contenere spazi o simboli, ad es., `103330482`. | | Applicabilità `[product_applicability]` | Sì | Questo attributo specifica se la promozione si applica a tutti i prodotti o solo a prodotti specifici. |

Valori supportati:

• all\_products

• specific\_products

Nota: impact.com può mappare solo le promozioni nel tuo file del feed promozioni di Google con prodotti specifici nel tuo catalogo prodotti se il tuo feed prodotti include promotion\_id. In altre parole, non puoi avere il specific\_products valore se il tuo feed prodotti non include ID promozione.

| | Descrizione `[long_title]` | Sì | Il titolo completo di ciascuna promozione. | La lunghezza massima del titolo è di 60 caratteri. Ad es., `Tazza in omaggio con acquisto`. | | Effettiva `[promotion_effective_dates]` | Sì | Il periodo della promozione. |

• La inizio e fine le date sono separate da una barra obliqua (/).

• Il formato della data è (YYYY-MM-DD), seguito dalla lettera ‘T’, dall'ora del giorno in cui la vendita inizia o termina e da un'espressione del fuso orario della vendita.

• Esempio: 2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00

| | Visualizzazione `[promotion_display_dates]` | No | Questo attributo specifica la data e l'intervallo di tempo in cui la promozione sarà attiva. | Il **inizio** e **fine** le date sono separate da una barra obliqua (/), ad es., `2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00`. | | Canale `[redemption_channel]` | Sì | Questo attributo indica che la promozione è valida online o in negozio. |

Valori supportati:

• online

• in\_store

| | Tipo di codice offerta `[offer_type]` | Sì | Questo attributo indica se per i clienti è richiesto o meno un codice coupon per riscattare l'offerta. |

Valori supportati:

• no\_code

• generic\_code

Importante: Se il valore di questo attributo è generic\_code, quindi generic\_redemption\_code è richiesto.

| | Codice offerta `[generic_redemption_code]` | No | Questo attributo specifica il codice che può essere utilizzato online per riscattare la promozione. | La lunghezza massima è di 20 caratteri, ad es., `EXTRA20`. | | Destinazione `[promotion_destination]` | No | Questo attributo specifica il formato di ciascuna promozione. |

Valori supportati:

• Shopping\_ads

• Buy\_on\_Google\_listings

• Free\_listings

Per inviare la tua promozione a una o più destinazioni, invia ogni valore di destinazione come colonna separata.

|
#### Risolvi i messaggi di errore e di avviso
Visualizza errori e avvisi Nella *Promozioni dei prodotti* schermata, sotto la *Salute* colonna, seleziona *errori* o *avvisi* per vedere maggiori informazioni sull'errore, come il tipo di errore o il messaggio di errore. Vedi [Gestisci i file delle promozioni dei tuoi prodotti](/brand/it/what-would-you-like-to-learn-about/platform-features/product-promotions/manage-your-product-promotion-files.md) per maggiori informazioni su *Salute* del tuo file delle promozioni.
Cerca e filtra gli errori Puoi fare clic sul file *errori* e *avvisi* e utilizzare il campo di ricerca e i filtri per scorrere tutti gli errori del file di promozione caricato. *Tipo di errore* i filtri includono: * Tutti * Avviso * Errore * Duplicato
Messaggi di errore e di avviso | Messaggio di errore | Spiegazione | | ------------------------------------------------------ | ------------------------------------------------------------------------------------ | | Campo/i obbligatorio/i mancanti:{Required field} | Uno o più dei campi obbligatori mancano nel file caricato. | | Record saltati a causa di una data di validità scaduta | La data di fine validità della promozione è nel passato e quel record viene saltato. |
--- # 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/product-promotions/upload-product-promotion-files.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.