> 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/advocate-program/advocate-rewards/set-up-a-fuel-tank-reward.md).

# Configura una ricompensa Fuel Tank

La funzionalità Fuel Tank semplifica la distribuzione dei premi tramite codici coupon univoci. I partecipanti al programma possono riscattare questi codici per ottenere sconti, crediti e altri tipi di premi. Per ulteriori informazioni, consulta [Panoramica dei premi Fuel Tank](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/fuel-tank-rewards-explained.md).

#### Creare un premio Fuel Tank

I premi Fuel Tank possono essere configurati come premi specifici per un programma oppure come premi riutilizzabili in più programmi. Ti consigliamo di configurare un premio riutilizzabile nel catalogo dei premi.

1. Nel 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] → Rewards →** **Catalogo**.
2. Seleziona **Crea premio**.
3. Assegna un nome al premio.
4. Seleziona il tipo di premio **Fuel Tank** .
5. Usa l'elenco a discesa **Tipo Fuel Tank** per scegliere un premio sotto forma di sconto o credito.
6. ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Attiva]** l'opzione **Durata di attesa del premio** se vuoi impostare un intervallo di tempo per eventuali revoche.
   * Ad esempio, puoi impostare una data di fine del periodo per i resi, in modo da distribuire i premi solo al termine di tale periodo.
7. Attiva **Collega a Shopify** per sincronizzare i codici in Shopify quando li carichi su impact.com.
   * Consulta la sezione [Codici sincronizzati per Shopify](#synced-codes-for-shopify) per configurare e gestire i codici.
8. ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Attiva]** l'opzione **Scadenza del premio** se vuoi impostare una durata specifica per il premio. Al termine del periodo, il premio scadrà e non sarà più valido.
9. Imposta una percentuale di sconto oppure un importo di credito e la relativa unità di misura.
10. Scegli se il premio Fuel Tank deve prevedere **accesso previa verifica** oppure **accesso immediato**.

    <div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-85446df8f41a7f78bd5183faed6e4ef5afe02ab5%2F82b48c8d0771a2f0faa025ef67a468e9293da17d377e8f02ef512d46317c7bae.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
11. Seleziona **Crea premio**.

#### Aggiungere codici coupon

{% hint style="success" %}
**Nota:** È possibile scaricare qui un file .CSV di esempio per importare i codici coupon dei premi Fuel Tank: [scarica il file di esempio](https://assets.contentful.com/s68ib1kj8k5n/4JaVWQPdI48Ey600sGOQUQ/a8cb4afbaddfc4bb0f7e7827bbe26889/example_fueltank_import.csv).
{% endhint %}

Per funzionare, i premi Fuel Tank richiedono codici coupon univoci. Se sincronizzi i codici con il tuo account Shopify, riceverai una notifica che indica che il codice verrà aggiunto a Shopify.

1. Nel 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] → Rewards →** **Gestione codici**.
2. Nella schermata *Gestione codici* passa il puntatore sul premio Fuel Tank per cui vuoi caricare i codici coupon e seleziona **Carica codici**.
3. Seleziona **Scegli file** e carica dal tuo dispositivo un file contenente i tuoi codici coupon univoci.
   * impact.com consiglia di modificare una copia di questo [file .CSV di esempio scaricabile](https://assets.contentful.com/s68ib1kj8k5n/4JaVWQPdI48Ey600sGOQUQ/a8cb4afbaddfc4bb0f7e7827bbe26889/example_fueltank_import.csv) come punto di partenza, ma puoi anche caricare un tuo file `.xlsx`, `.ods`, `.tsv`, oppure `.txt` (solo con righe separate da interruzioni di riga).
4. Il file deve rispettare le seguenti linee guida:
   * Tutti i codici che vuoi importare devono trovarsi nella stessa colonna e devono essere gli unici contenuti di quella colonna.
   * Ogni codice può contenere fino a 64 caratteri. È consentita qualsiasi combinazione dei seguenti caratteri:
     * Lettere maiuscole e minuscole da A a Z
     * Numeri da 0 a 9
     * Trattino ( - )
     * Trattino basso ( \_ )

       <div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ea3a0fafbf37d947e1011d69340dcacc76c95e9f%2F763daeafd0065f6d4645ad50bb6fafccca698b07cab2925f5c422752804718cc.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
5. Se il file contiene più colonne, puoi **Selezionare una colonna di dati** nel pannello a destra per indicare quale colonna contiene i codici coupon.
   * Visualizza l'anteprima per vedere quali codici coupon, se presenti, il sistema considera non validi.
6. Nel pannello a sinistra, seleziona se vuoi che i codici coupon nel file **Sostituiscano** eventuali codici esistenti oppure se preferisci **Aggiungerli** a eventuali codici esistenti.
7. Seleziona **Carica**.
   * Facoltativamente, seleziona **Visualizza codici** per gestire i codici coupon.

#### Gestisci i codici coupon caricati

1. Dopo aver caricato i codici coupon, seleziona **Visualizza codici** nella finestra modale a comparsa.
   * Verrai indirizzato alla schermata [*Visualizza codici*](https://app.impact.com/secure/advertiser/engage/advocate/p/651d9f42ffdad26e631d75c1/t/live/fueltank/manage/r%2FCoupon-20) .
2. Sotto il titolo della pagina, puoi **Cercare** un codice coupon specifico per nome oppure usare i menu a discesa per filtrare i codici in base al programma o al loro stato (ovvero, se sono già stati utilizzati o meno).
3. Per eliminare i codici che non desideri, seleziona la ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casella non selezionata]** nelle righe pertinenti, quindi seleziona **Elimina**.

   <div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FYmqcBKMJqxeNUMtufOhl%2FScreenshot%202026-05-25%20at%2018.45.20.png?alt=media&amp;token=c0fda7ef-fab2-403b-86fe-6450bbe14d65" alt="" width="563"><figcaption></figcaption></figure></div>

#### Codici sincronizzati per Shopify

Mantenere i codici sincronizzati con Shopify consente ai clienti segnalati di riscattare i premi senza ritardi, contribuendo a creare fiducia e a offrire un'esperienza di referral fluida. Grazie all'integrazione di Advocate con Shopify, puoi automatizzare la creazione e la sincronizzazione dei codici sconto, risparmiando tempo e riducendo il rischio di errori.

**Configura la sincronizzazione dei codici Shopify**

1. Nel 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] → Premi** → **Catalogo** → **Crea premio**.
2. Seleziona **Serbatoio carburante** come tipo di premio.
3. Nella sezione *Collega a Shopify* , seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[Casella di controllo]** **Sincronizza i codici sconto con Shopify quando vengono assegnati i premi**.
   * Se non vedi la schermata qui sopra, il tooltip ti inviterà a consultare la nostra documentazione sull’ [integrazione con Shopify](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-plugin-integration/integrate-with-shopify-for-advocate) per configurare la sincronizzazione dei codici Shopify.
4. Nella sezione *Crea automaticamente codici sconto* , seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[Casella di controllo]** **Genera codici che iniziano con un prefisso** se vuoi generare automaticamente i codici e personalizzarli.

   * Inserisci nel campo apposito il prefisso che vuoi aggiungere ai codici generati automaticamente. Il prefisso sarà lo stesso per tutti i codici, ad es., `CODE0835A`, `CODE04359B`.

   <div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FdrSJd4RilqVCsRCt6YKK%2FScreenshot%202026-05-25%20at%2018.46.59.png?alt=media&amp;token=20897baa-0919-4d3c-b18a-8ac416a780e3" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
**Nota:** Quando viene assegnato un premio, Advocate genera automaticamente un codice univoco e lo sincronizza con Shopify. Ti consigliamo di controllare periodicamente che non si siano verificati errori.
{% endhint %}

Se preferisci usare codici personalizzati, puoi [caricarli tramite Code Manager](#manage-uploaded-coupon-codes)e tenere traccia dei codici emessi, dei destinatari e dell’esito della sincronizzazione. In questo modo, garantirai un’esperienza senza intoppi sia al tuo team sia ai tuoi clienti.

**Gestire i codici Shopify**

La schermata *Code Manager* e la relativa schermata secondaria *Visualizza codici* e il *Feed dei premi* ti aiutano a gestire e monitorare i codici sconto usati come premi nel tuo programma Advocate. Se usi Shopify, questi strumenti ti consentono di sincronizzare i codici automaticamente, senza doverli caricare manualmente.

{% tabs %}
{% tab title="Code Manager" %}
In questa schermata trovi un elenco dei codici promozionali e le relative informazioni.

1. Nel 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] → Rewards →** **Gestione codici**.
2. Individua il codice pertinente e consulta i dati nella colonna all’estrema sinistra, *Codici disponibili* per verificare se è sincronizzato con il tuo negozio Shopify. Se il codice è sincronizzato con Shopify, vedrai una nota.
   * Consulta la *tabella di riferimento di Code Manager* qui sotto per ulteriori informazioni.

<details>

<summary>Riferimento di Code Manager</summary>

| Colonna            | Descrizione                                                                                             |
| ------------------ | ------------------------------------------------------------------------------------------------------- |
| Nome               | Mostra il nome del codice premio, ovvero quello che hai scelto al momento della creazione.              |
| Tipo               | Mostra il tipo di codice premio offerto, ad es., `PCT_DISCOUNT` (codice sconto percentuale).            |
| Valore             | Questo campo mostra il valore totale del codice, sotto forma di sconto percentuale o importo in valuta. |
| Codici disponibili | Questo campo indica il numero di codici caricati.                                                       |

</details>
{% endtab %}

{% tab title="Schermata Visualizza codici" %}
In questa schermata puoi visualizzare i codici coupon segnalati disponibili, ordinarli in base al programma a cui sono associati, verificare se sono stati utilizzati oppure cercare codici specifici per nome.

1. Nel 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] → Rewards →** **Gestione codici**.
2. Passa il cursore sul codice premio che vuoi visualizzare e seleziona **Gestisci**.
3. Verrai portato alla schermata [*Visualizza codici*](https://app.impact.com/secure/advertiser/engage/advocate/p/651d9f42ffdad26e631d75c1/t/live/fueltank/manage/r%2FCoupon-20) , che elenca tutti i codici coupon generati con quel nome di codice premio.
   * Consulta la *tabella di riferimento Visualizza codici* per ulteriori informazioni.

<details>

<summary>Riferimento Visualizza codici</summary>

| Colonna                      | Descrizione                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Codice                       | Questo campo mostra il codice coupon utilizzato, ad esempio `DISCOUNT123`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Data di assegnazione         | Questa è la data in cui il codice è stato assegnato all'utente/cliente.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Data di caricamento          | Questa è la data in cui il codice è stato generato e caricato nel sistema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Assegnato a                  | Questo campo indica chi ha ricevuto il codice e a quale indirizzo email è stato inviato.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Valore                       | Questo campo indica il valore del codice, sotto forma di sconto percentuale o importo in valuta.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Stato della sincronizzazione | <p>Questo campo indica se il codice è stato sincronizzato con Shopify. Indica se la sincronizzazione con Shopify è <em>Sincronizzato</em>, <em>Non riuscito</em>oppure è <em>In sospeso</em>.</p><p>• Per attivare <strong>Collega a Shopify</strong>, consulta il <em>passaggio 8</em> della sezione <a href="#section-idm4614345065470433852294536291">Crea un premio Fuel Tank</a> qui sopra.</p><div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Nota</strong>: la colonna <em>Stato della sincronizzazione</em> non viene visualizzata se la sincronizzazione non è mai stata attivata. Viene visualizzata se la sincronizzazione è stata attivata, anche se poi è stata disattivata.</p></div> |

</details>
{% endtab %}

{% tab title="Feed dei premi" %}
Il feed dei premi mostra lo stato dei codici sincronizzati e può aiutarti a capire se si sono verificati errori durante la sincronizzazione. Sono previsti 3 stati diversi per la sincronizzazione dei codici:

* **In sospeso:** Mentre il nostro sistema esegue un nuovo tentativo automatico, lo stato risulta In sospeso.
* **Errore di sincronizzazione dei codici Shopify:** Se il nuovo tentativo non riesce a causa di un errore di integrazione o di configurazione.
* **Disponibile:** Quando i codici vengono sincronizzati con Shopify.

Consulta l’ [articolo «Spiegazione del feed dei premi»](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/reward-feed-explained.md) per saperne di più.
{% endtab %}
{% endtabs %}

**Eliminare i codici premio**

Puoi eliminare i codici premio che hai generato, compresi quelli sincronizzati con Shopify.

{% hint style="success" %}
**Nota**: per eliminare i codici sincronizzati con Shopify, dovrai eliminarli anche dal tuo account advocate di impact.com [e dal tuo account Shopify](https://help.shopify.com/en/manual/discounts/managing-discount-codes#delete-discounts).
{% endhint %}

1. Nel 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] → Premi → Gestione codici**.
2. Nell’angolo in alto a destra, seleziona **Visualizza codici**.
3. Passa il cursore sul codice premio che vuoi visualizzare e seleziona **Gestisci**.
4. Seleziona la ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[Casella selezionata]** accanto ai codici che vuoi eliminare.
5. Dopo aver selezionato tutti i codici che vuoi eliminare, seleziona il pulsante **Elimina** .

   <div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FpCxueTpMDFNxVnX4XmAr%2FScreenshot%202026-05-25%20at%2018.45.20.png?alt=media&amp;token=5655425b-bcc0-4fea-a876-cfb189df1289" alt="" width="563"><figcaption></figcaption></figure></div>


---

# 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/advocate-program/advocate-rewards/set-up-a-fuel-tank-reward.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.
