> 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

La *promozione dei prodotti* funzione ti consente di condividere offerte speciali e promozioni con i partner. Queste offerte vengono visualizzate nei feed dei prodotti dei partner, nelle API dei prodotti e nel marketplace dei prodotti di impact.com, dove viene mostrato un tag *Offerta speciale* direttamente sul riquadro del prodotto nei risultati di ricerca.

{% hint style="warning" %}
**Importante:** Prima di iniziare, devi disporre di un catalogo prodotti attivo. Per assistenza nella creazione del tuo primo caricamento di prodotti, consulta [Aggiungere cataloghi prodotti](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).
{% endhint %}

#### Caricare un file di promozioni

Usa il [modello del file di promozioni](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) per creare il file. Lo stesso formato è compatibile con entrambi i metodi di caricamento.

{% 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 →** [**Promozione dei prodotti**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-product-promotion-flow.ihtml).
2. Nell'angolo in alto a destra, seleziona **Carica file di promozioni**.
3. Inserisci **Nome file di promozioni**.
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** come metodo.
5. Seleziona il **formato del file**.
   * impact.com supporta solo *Google Merchant Center (formato TXT)* ovvero `.txt` e *Google Merchant Center (formato CSV)* ovvero `.csv` file.
   * Per ulteriori informazioni su questi campi, consulta il *riferimento dei campi del feed delle promozioni dei prodotti* qui sotto.
6. Seleziona **Scegli file**.
   * Individua sul tuo computer il file che vuoi caricare.
7. Seleziona la **lingua** e **Salva**.
   {% endtab %}

{% tab title="Recupera da URL" %}
Questa opzione consente di recuperare un file da un server FTP/SFTP o da un URL HTTP/HTTPS, per garantire che i dati delle promozioni siano 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 →** [**Promozione dei prodotti**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-product-promotion-flow.ihtml).
2. Nell'angolo in alto a destra, seleziona **Carica file di promozioni**.
3. Inserisci **Nome file di promozioni**.
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** come metodo di caricamento.
5. Seleziona il **formato del file**.
   * impact.com supporta solo *Google Merchant Center (formato TXT)* ovvero `.txt` e *Google Merchant Center (formato CSV)* ovvero `.csv` file.
   * Per ulteriori informazioni su questi campi, consulta il *riferimento dei campi del feed delle promozioni dei prodotti* qui sotto.
6. Inserisci il **nome** del file in *Nome file di caricamento*.
7. Inserisci il **URL di recupero** che punta alla directory in cui si trova il file con i dati delle promozioni.
   * Questo URL può essere FTP o HTTPS. Ad esempio, `ftp://ftp.acme.com` oppure `https://acme.com/anvil_promotions/anvil.txt`
8. Seleziona la **Frequenza di recupero** con cui impact.com recupererà il file:
   * Ogni giorno
   * Ogni 8 ore
   * Ogni 4 ore
   * Ogni 2 ore
9. Seleziona l' **Ora di recupero** in cui impact.com recupererà il file.
   * Le opzioni visualizzate sono espresse in GMT -05:00, ora della costa orientale.
10. Seleziona il tuo **Fuso orario**.
11. Seleziona la **lingua** e **Salva**.
    {% endtab %}
    {% endtabs %}

<details>

<summary>Riferimento ai campi del feed delle promozioni dei prodotti</summary>

| Campi previsti                                    | Obbligatorio? | Descrizione                                                                                               | Formato                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------------------- | ------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID `[promotion_id]`                               | Sì            | L'ID univoco di ogni promozione.                                                                          | L'ID distingue tra maiuscole e minuscole, può contenere fino a 50 caratteri e non può includere spazi o simboli. Ad esempio, `103330482`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Applicabilità `[product_applicability]`           | Sì            | Questo attributo specifica se la promozione si applica a tutti i prodotti o solo a prodotti specifici.    | <p>Valori supportati:</p><p>• <code>all\_products</code></p><p>•<code>specific\_products</code></p><p>impact.com può associare le promozioni nel tuo <a href="https://support.google.com/merchants/answer/2906014?hl=en">file del feed delle promozioni di Google</a> a prodotti specifici nel tuo <a href="https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md">catalogo prodotti</a> solo se il catalogo prodotti include <code>promotion\_id</code>. Non puoi usare il <code>specific\_products</code> a meno che il catalogo prodotti non includa gli ID delle promozioni. Vedi <a href="#link-promotions-to-specific-products">Collegare le promozioni a prodotti specifici</a>.</p> |
| Descrizione `[long_title]`                        | Sì            | Il titolo completo di ogni promozione.                                                                    | La lunghezza massima del titolo è di 60 caratteri. Ad es., `Free mug with purchase`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Periodo di validità `[promotion_effective_dates]` | Sì            | Il periodo di validità della promozione.                                                                  | <p>• La data di <strong>inizio</strong> e la data di <strong>fine</strong> sono separate da una barra (/).</p><p>• Il formato della data è (AAAA-MM-GG), seguito dalla lettera «T», dall'ora di inizio o fine della promozione e dall'indicazione del fuso orario.</p><p>• Esempio: <code>2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Visualizzazione `[promotion_display_dates]`       | No            | Questo attributo specifica la data e l'intervallo di tempo durante i quali la promozione sarà attiva.     | La data di **inizio** e quella di **fine** sono separate da una barra (/), ad es., `2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Canale `[redemption_channel]`                     | Sì            | Questo attributo indica se la promozione è valida online o in negozio.                                    | <p>Valori supportati:</p><p>• <code>online</code></p><p>• <code>in\_store</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Tipo di codice dell'offerta `[offer_type]`        | Sì            | Questo attributo indica se è necessario un codice coupon affinché i clienti possano riscattare l'offerta. | <p>Valori supportati:</p><p>• <code>no\_code</code></p><p>• <code>generic\_code</code></p><p><strong>Importante:</strong> Se il valore di questo attributo è <code>generic\_code</code>, allora è obbligatorio <code>generic\_redemption\_code</code> .</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Codice dell'offerta `[generic_redemption_code]`   | No            | Questo attributo specifica il codice utilizzabile 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.                                                 | <p>Valori supportati:</p><p>• <code>Shopping\_ads</code></p><p>•<code>Buy\_on\_Google\_listings</code></p><p>• <code>Free\_listings</code></p><p>Per inviare la promozione a una o più destinazioni, inserisci ogni valore di destinazione in una colonna separata.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

</details>

#### Collegare le promozioni a prodotti specifici

Se una promozione si applica solo ad alcuni dei tuoi prodotti, imposta `product_applicability` su `specific_products` nel file delle promozioni. Poi aggiungi l'ID della promozione a ogni prodotto idoneo nel catalogo prodotti, in modo che impact.com possa abbinarli. Se la promozione si applica a tutti i tuoi prodotti, usa `all_products` e salta questi passaggi.

1. Nel file delle promozioni, assegna alla promozione un valore `promotion_id`univoco, ad es., `103330482`.
2. Nel catalogo prodotti di Google Merchant Center, aggiungi un campo `promotion_id` .
   * Consulta [Formati di file per i cataloghi prodotti](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/file-formats-for-product-catalogs.md) per conoscere i tipi di file di Google Merchant Center supportati da impact.com.
3. Per ogni prodotto a cui si applica la promozione, inserisci lo stesso valore `promotion_id` .
   * I valori devono corrispondere esattamente, comprese le lettere maiuscole e minuscole.
4. Carica il catalogo prodotti aggiornato e il file delle promozioni.
   * Per assistenza, consulta [Aggiungere cataloghi prodotti](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md) e [Caricare un file delle promozioni](#upload-a-promotion-file).
   * La promozione si applica solo ai prodotti il cui valore `promotion_id` corrisponde a quello presente nel catalogo prodotti.

{% hint style="info" %}
**Esempio:** La promozione *Tazza in omaggio con l'acquisto* si applica ai chicchi di caffè e alla pressa francese, ma non al bollitore. Per maggiore chiarezza, sono state omesse altre colonne obbligatorie.
{% endhint %}

File delle promozioni:

| promotion\_id | product\_applicability | long\_title                     |
| ------------- | ---------------------- | ------------------------------- |
| 103330482     | specific\_products     | Tazza in omaggio con l'acquisto |

Catalogo prodotti:

| id       | title                   | promotion\_id |
| -------- | ----------------------- | ------------- |
| SKU-1001 | Chicchi di caffè, 1 kg  | 103330482     |
| SKU-1002 | Caffettiera a stantuffo | 103330482     |
| SKU-1003 | Bollitore per tè        |               |

#### Risoluzione dei messaggi di errore e avviso

<details>

<summary>Visualizzare errori e avvisi</summary>

Nella schermata *Promozioni dei prodotti* , nella colonna *Stato* , seleziona *errori* o *avvisi* per visualizzare ulteriori informazioni sull'errore, ad esempio il tipo o il messaggio di errore. Consulta [Gestire i file delle promozioni dei prodotti](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-promotions/manage-your-product-promotion-files.md) per ulteriori informazioni sullo *Stato* del file della promozione.

</details>

<details>

<summary>Cercare e filtrare gli errori</summary>

Puoi fare clic su *errori* e *avvisi* del file e utilizzare il campo di ricerca e i filtri per esaminare tutti gli errori del file della promozione caricato.

*Tipo di errore* I filtri includono:

* Tutti
* Avviso
* Errore
* Duplica

</details>

<details>

<summary>Messaggi di errore e avviso</summary>

| Messaggio di errore                                     | Spiegazione                                                                     |
| ------------------------------------------------------- | ------------------------------------------------------------------------------- |
| Campo/i obbligatorio/i mancante/i:{Required field}      | Nel file caricato mancano uno o più campi obbligatori.                          |
| Record ignorati a causa di una data di validità scaduta | La data di fine validità della promozione è passata e il record viene ignorato. |

</details>


---

# 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=<question>&goal=<user_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.
