> 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 di promozione prodotto Il *Promozioni prodotto* la funzionalità ti consente di condividere offerte speciali e promozioni con i partner. Queste offerte compaiono nei feed prodotto dei partner, nelle API prodotto e nel marketplace dei prodotti di impact.com, dove una *Offerta speciale* etichetta visualizzata direttamente sulla scheda prodotto nei risultati di ricerca. {% hint style="warning" %} **Importante:** Dovrai avere un catalogo prodotti attivo prima di iniziare. Per assistenza nella creazione del tuo primo caricamento prodotto, consulta [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 ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Contenuti → Prodotti → Promozioni prodotto**. 2. Nell'angolo in alto a destra, seleziona **Carica file promozione**. 3. Inserisci i tuoi **Nome file promozione**. 4. Seleziona il ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Pulsante di opzione]** **Caricamento diretto** metodo. 5. Seleziona il file **Formato**. * impact.com supporta solo *Google Merchant Center (formato TXT)* vale a dire `.txt` e *Google Merchant Center (formato CSV)* vale a dire `.csv` file. * Consulta il [*Riferimento ai campi del feed promozioni prodotto*](#para-idm73509110741608) qui sotto per ulteriori informazioni su questi campi. 6. Seleziona **Scegli file**. * Individua il file che desideri 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 ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Contenuti → Prodotti → Promozioni prodotto**. 2. Nell'angolo in alto a destra, seleziona **Carica file promozione**. 3. Inserisci i tuoi **Nome file promozione**. 4. Seleziona il ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Pulsante di opzione]** **Recupera da URL** metodo di caricamento. 5. Seleziona il file **Formato**. * impact.com supporta solo *Google Merchant Center (formato TXT)* vale a dire `.txt` e *Google Merchant Center (formato CSV)* vale a dire `.csv` file. * Consulta il [*Riferimento ai campi del feed promozioni prodotto*](#para-idm73509110741608) qui sotto per ulteriori informazioni su questi campi. 6. Inserisci il **nome** del tuo file sotto *Nome file caricato*. * [Visualizza questo modello](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) come guida durante il caricamento delle tue promozioni. 7. Inserisci il **URL di recupero** 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** per determinare con quale frequenza impact.com recupererà il file: * Ogni giorno * 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 ai campi del feed promozioni prodotto | Campi previsti | Obbligatorio? | Descrizione | Formato | | ------------------------------------------- | ------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ID `[promotion_id]` | Sì | L'ID univoco di ogni 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 oppure solo a prodotti specifici. |

Valori supportati:

• all\_products

• specific\_products

Nota: impact.com può associare solo le promozioni nel tuo file del feed promozioni 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 ogni promozione. | La lunghezza massima del titolo è di 60 caratteri. Ad es., `Tazza gratuita con acquisto`. | | Effettivo `[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’, l'ora del giorno in cui la vendita inizia o termina e 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 è richiesto o meno un codice coupon affinché i clienti riscattino 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 ogni 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 avviso
Visualizza errori e avvisi Nella *Promozioni prodotto* schermata, sotto la *Stato* colonna, seleziona *errori* o *avvisi* per visualizzare ulteriori informazioni sull'errore, come il tipo di errore o il messaggio di errore. Consulta [Gestisci i tuoi file di promozioni prodotto](/brand/it/what-would-you-like-to-learn-about/platform-features/product-promotions/manage-your-product-promotion-files.md) per maggiori informazioni su *Stato* del tuo file delle promozioni.
Cerca e filtra gli errori Puoi fare clic sul file *errori* e *avvisi* e usare il campo di ricerca e i filtri per ordinare tutti gli errori del file di promozione caricato. *Tipo di errore* i filtri includono: * Tutti * Avviso * Errore * Duplica
Messaggi di errore e avviso | Messaggio di errore | Spiegazione | | ------------------------------------------------------- | ------------------------------------------------------------------------------------- | | Campo/i obbligatorio/i mancanti:{Required field} | Uno o più dei campi obbligatori mancano nel file caricato. | | Record ignorati a causa di una data di validità scaduta | La data di fine validità della promozione è nel passato e quel record viene ignorato. |
--- # 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/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 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.