> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🎯 Announcement Bar — Opzioni di Targeting Avanzate

> ℹ️ **Note:** Questo articolo è stato tradotto automaticamente utilizzando AI e può contenere imprecisioni. Se qualcosa sembra sbagliato, si prega di contattare il nostro team di supporto.

La scheda **Placement** è dove controlli esattamente chi vede la tua announcement bar, dove appare e quando viene pubblicata. Invece di mostrare lo stesso messaggio a ogni visitatore in ogni pagina, puoi creare regole di visibilità precise che si allineano ai tuoi obiettivi di campagna.

Che tu voglia dare il benvenuto a clienti VIP di ritorno, promuovere una vendita solo ai visitatori da Instagram o programmare un banner per le festività in modo che appaia automaticamente — il sistema di targeting ti offre un controllo granulare senza toccare alcun codice 🎯

---

# **⚠️ Prima di Iniziare**

Per configurare le impostazioni di Advanced Targeting:

→ Apri un'announcement bar esistente  
→ Oppure creane una nuova prima

Quindi clicca sulla scheda **Placement** all'interno dell'editor.

ℹ️ Alcune opzioni di targeting sono nascoste a seconda del tipo di posizionamento selezionato durante la creazione. Ad esempio, **Page Targeting** non viene mostrata per i posizionamenti Cart o Checkout, mentre **Customer Targeting** non è disponibile per i posizionamenti Checkout. Queste sezioni condizionali sono evidenziate qui sotto in modo che tu sappia esattamente quando aspettartele.

---

# **📐 Posizione di Visualizzazione**

Questa impostazione controlla la posizione fisica della barra nella pagina.

## **Posizioni Storefront**

Disponibili quando la barra viene creata per il posizionamento **Storefront Page**:

* **Top Push** — Spinge il resto del contenuto della pagina verso il basso. La barra si colloca nel normale flusso del documento.  
* **Top Push (Sticky)** — Rimane fissa nella parte superiore dell'area visibile mentre il cliente scorre. Il contenuto della pagina viene comunque spinto verso il basso.  
* **Top Overlap** — Fluttua nella parte superiore della pagina senza spingere il contenuto verso il basso.  
* **Top Overlap (Sticky)** — Fluttua nella parte superiore e rimane visibile durante lo scorrimento.  
* **Bottom Overlap (Sticky)** — Appare nella parte inferiore dell'area visibile e rimane lì durante lo scorrimento.  
* **Manual** — Controlli esattamente dove appare la barra utilizzando uno snippet di codice o un app block.

## **Posizioni Cart**

Disponibili quando la barra viene creata per il posizionamento **Cart Page** o **Cart Drawer**:

* **Top of Cart** — Inserisce la barra nella parte superiore dell'area del carrello.  
* **Bottom of Cart** — Inserisce la barra nella parte inferiore dell'area del carrello.  
* **Manual** — Posizionala tu stesso utilizzando uno snippet di codice personalizzato.

## **Posizione Checkout**

Disponibile quando la barra viene creata per il posizionamento **Checkout Page** *(solo Shopify Plus)*:

* La barra viene renderizzata come un blocco personalizzato all'interno del flusso di checkout. Il posizionamento viene gestito attraverso le impostazioni dell'estensione UI di checkout.

### **Comportamento del Posizionamento Manuale**

Quando è selezionata l'opzione **Manual**:

* Il menu a discesa **Page Targeting** viene automaticamente disabilitato e impostato su **Custom**.

Ti viene fornito uno snippet di codice da incollare nel tuo tema:  
\<div class="futureblink-announcement-block" id="{announcementId}"\>\</div\>

*   
* La barra verrà renderizzata solo dove è posizionato questo blocco.

---

# **🎯 Page Targeting**

La Page Targeting determina in quali pagine appare la barra. Questa sezione è **nascosta** per i posizionamenti Cart e Checkout poiché sono specifici per pagina per definizione.

## **Opzioni Disponibili**

* **Every page** — Mostra in tutte le pagine del tuo storefront.  
* **Home page only** — Mostra solo nella homepage.  
* **All product pages** — Mostra in ogni pagina prodotto.  
* **Products in specific collections** — Mostra solo nelle pagine prodotto che appartengono alle collezioni selezionate.  
  * Quando selezionato, appare un pulsante **Select collections** per scegliere quali collezioni sono idonee.  
* **Specific products** — Mostra solo nelle pagine prodotto scelte manualmente.  
  * Quando selezionato, appare un pulsante **Select products** per scegliere i singoli prodotti.  
* **All collection pages** — Mostra in ogni pagina di elenco delle collezioni.  
* **Specific collections** — Mostra solo nelle pagine delle collezioni selezionate.  
  * Quando selezionato, appare un pulsante **Select collections**.

### **Come Funziona sullo Storefront**

La barra verifica il tipo di pagina corrente e il percorso URL prima di essere renderizzata:

* Per **specific products**, la barra confronta l'ID del prodotto.  
* Per **products in specific collections**, la barra verifica se il prodotto corrente appartiene a una delle collezioni selezionate.  
* Per **specific collections**, la barra confronta l'handle della collezione nell'URL.

---

# **⏰ Scheduling**

Lo Scheduling ti consente di controllare **quando** la barra va in diretta e quando si interrompe automaticamente. Se non configurato, la barra appare immediatamente dopo la pubblicazione e rimane attiva finché non la ritiri manualmente.

## **Orario di Inizio**

* **Right now** — La barra appare immediatamente dopo la pubblicazione.  
* **Specific date** — La barra rimane nascosta fino alla data e all'ora scelte.  
  * Quando selezionato, appare un **Date Picker** insieme agli input per ora, minuti e AM/PM.

## **Orario di Fine**

* **Never** — La barra rimane attiva a tempo indeterminato.  
* **Specific date** — La barra smette automaticamente di mostrarsi dopo la data e l'ora scelte.  
  * Quando selezionato, appare un **Date Picker** insieme agli input per ora, minuti e AM/PM.

### **Comportamento Importante dello Scheduling**

* Se imposti sia un orario di inizio che uno di fine, la fine deve essere successiva all'inizio.  
* Se pubblichi un annuncio la cui data di fine è già trascorsa, lo schedule viene **automaticamente cancellato** e la barra va in diretta immediatamente.  
* Sullo storefront, una barra programmata viene creata nel DOM ma nascosta con `display: none` fino al raggiungimento dell'orario di inizio. Quando passa l'orario di fine, viene nascosta automaticamente di nuovo.

💡 *Lo Scheduling è perfetto per le vendite flash, le campagne per le festività o gli annunci a tempo limitato che vuoi preparare in anticipo.*

---

# **👥 Customer Targeting**

La Customer Targeting ti consente di mostrare o nascondere la barra in base a chi sta visualizzando il tuo store. Questa sezione è **nascosta** per i posizionamenti Checkout.

## **Visibilità per Stato di Accesso**

* **All customers** — Mostra a tutti, indipendentemente dall'accesso.  
* **Logged in customers only** — Nasconde la barra ai visitatori ospiti.

## **Mostra Barra A**

Controlla quale segmento di clienti dovrebbe vedere la barra:

* **All Customers** — Nessuna restrizione.  
* **Specific tag** — Solo i clienti con un tag specifico possono vedere la barra.  
  * Quando selezionato, appare un campo di testo: **Enter tags** (separati da virgola).  
  * Esempio: `VIP, wholesale, returning`  
* **Specific lifetime spent** — Solo i clienti che hanno speso una certa somma in tutti gli ordini possono vedere la barra.  
  * Quando selezionato, appare un campo numerico per la spesa minima totale.  
  * La barra verifica il valore `total_spent` del cliente da Shopify.

## **Nascondi Barra A**

Controlla quale segmento di clienti **non** dovrebbe vedere la barra. Le regole di nascondimento vengono valutate prima di quelle di visualizzazione.

* **No one** — Non nascondere a nessuno.  
* **Specific tag** — Nascondi ai clienti con un tag specifico.  
  * Quando selezionato, appare un campo di testo per i tag separati da virgola.  
* **Specific lifetime spent** — Nascondi ai clienti che hanno speso almeno una certa somma.  
  * Quando selezionato, appare un campo numerico per la spesa minima totale.

### **Come Funziona la Customer Targeting**

Sullo storefront, l'app verifica i dati del cliente corrente (iniettati tramite Liquid):

1. Se è selezionato **Logged in only** e il visitatore è un ospite → la barra è nascosta.  
2. Le regole di nascondimento vengono controllate per prime. Se il cliente corrisponde a una qualsiasi condizione di nascondimento → la barra è nascosta.  
3. Le regole di visualizzazione vengono controllate successivemente. Se il cliente corrisponde a una qualsiasi condizione di visualizzazione → la barra viene mostrata.  
4. Se nessuna condizione corrisponde, la barra viene nascosta per impostazione predefinita, per sicurezza.

⚠️ **Importante:** la Customer Targeting richiede che il cliente abbia effettuato l'accesso per le regole basate su tag e spesa. Gli ospiti non corrisponderanno alle condizioni di tag o spesa.

---

# **🌍 Geolocation Targeting**

La Geolocation Targeting controlla quali paesi o regioni possono vedere la barra.

* **All world** — Visibile a ogni visitatore indipendentemente dalla posizione.  
* **Specific countries** — Solo i visitatori dai paesi selezionati possono vedere la barra.  
  * Quando selezionato, un pulsante **Select countries** diventa attivo.  
  * Cliccandolo si apre una modal con un elenco ricercabile di 246 paesi.  
  * Seleziona i paesi che vuoi includere. I paesi selezionati appaiono come elenco riassuntivo sotto il pulsante.

### **Come Funziona la Geolocalizzazione**

Lo storefront rileva il paese del visitatore utilizzando l'endpoint `/browsing_context_suggestions.json` di Shopify. Il risultato viene memorizzato nella cache del browser in `sessionStorage` sotto `country_code` in modo che i caricamenti successivi della pagina non ripetano la richiesta.

💡 *Usa questa funzione per campagne specifiche per regione — ad esempio, una barra "Spedizione Gratuita negli Stati Uniti" che vedono solo i visitatori statunitensi.*

---

# **🔗 UTM Source Targeting**

La UTM Targeting ti consente di mostrare la barra solo ai visitatori che arrivano da fonti di traffico specifiche. È utile quando vuoi allineare il messaggio a una particolare campagna pubblicitaria o piattaforma social.

Questa sezione è **nascosta** per i posizionamenti Checkout.

## **Abilita Filtraggio UTM**

Seleziona la casella **"ONLY show to visitors who match UTM Source"** per abilitare il filtraggio.

⚠️ Quando abilitato, i visitatori che arrivano direttamente (senza un'origine UTM) **non** vedranno la barra.

## **Caselle di Spunta delle Piattaforme Disponibili**

Quando abilitato, appaiono le seguenti caselle di spunta:

* **TikTok**  
* **Facebook**  
* **Instagram**  
* **Google**  
* **Pinterest**  
* **Twitter**

ℹ️ *Facebook e Instagram sono collegati:* selezionarne uno include automaticamente l'altro nel controllo.

## **Codice UTM Personalizzato**

Se hai bisogno di un filtraggio più specifico:

* Seleziona **Custom UTM\_CODE** per rivelare un campo di input di testo.  
* Inserisci coppie `key=value` separate da virgola.  
  * Esempio: `utm_medium=sales,utm_campaign=newsletter`  
* Il controllo non fa distinzione tra maiuscole e minuscole.

### **Come Funziona la UTM Targeting**

Lo storefront legge il parametro `utm_source` dell'URL corrente:

* Se vengono utilizzate solo le caselle di spunta delle piattaforme, la barra viene mostrata se il `utm_source` del visitatore corrisponde a una qualsiasi piattaforma selezionata.  
* Se viene fornito anche un codice UTM personalizzato, la barra viene mostrata se **sia** la piattaforma corrisponde **oppure** tutte le coppie chiave-valore personalizzate corrispondono all'URL.

💡 *Crea una barra "Benvenuto Shoppers di Instagram" che appare solo quando `utm_source=instagram` è presente nell'URL.*

---

# **⏱️ Time-on-Site Targeting**

La Time-on-Site Targeting controlla per quanto tempo un visitatore deve rimanere sulla pagina prima che appaia la barra.

* **Always Show (Default)** — La barra appare immediatamente quando la pagina si carica.  
* **Show after a while** — Ritarda la comparsa della barra.  
  * Quando selezionato, appare un campo numerico **Delay (in seconds)**.  
  * Accetta valori da 1 a 300 secondi (5 minuti).

### **Come Funziona il Ritardo**

Sullo storefront, la barra viene creata immediatamente, ma inizia con `display: none`. Dopo il numero di secondi configurato, diventa visibile.

💡 *Un breve ritardo (5–10 secondi) può risultare meno invasivo di un popup immediato, specialmente per le announcement bars nella parte inferiore della pagina.*

---

# **📱 Device Visibility**

Anche se la visibilità per dispositivo è configurata nella scheda **Design**, influisce direttamente sul comportamento del targeting e vale la pena menzionarla qui per completezza.

* **Desktop and Mobile** — Visibile su tutti i dispositivi.  
* **Only Desktop** — Nascosto su schermi di 768px o inferiori.  
* **Only Mobile** — Nascosto su schermi più larghi di 768px.

Questo è utile quando vuoi barre diverse (o messaggi diversi) per gli acquirenti desktop rispetto a quelli mobile.

---

# **⚠️ Note Importanti**

* La **Manual position** disabilita la Page Targeting perché controlli il posizionamento tramite uno snippet di codice.  
* Il **Checkout placement** nasconde la Customer Targeting e la UTM Targeting perché Shopify Checkout non espone i tag dei clienti o i parametri UTM alle estensioni UI allo stesso modo.  
* Il **Cart placement** nasconde il menu a discesa Page Targeting perché la barra è limitata all'area del carrello per definizione.  
* La **Geolocation** utilizza il paese di navigazione rilevato del visitatore. VPN o servizi proxy possono causare risultati inaspettati.  
* I **tag dei clienti e la spesa** funzionano solo per i clienti loggati. Gli ospiti vengono trattati come non corrispondenti per le regole di tag/spesa.  
* Il **filtraggio UTM** nasconderà la barra al traffico diretto. Assicurati che sia intenzionale prima di abilitarlo.  
* Più condizioni di targeting lavorano insieme con logica **AND**. La barra deve superare **tutti** i controlli di targeting attivi per essere visualizzata.

---

# **💡 Esempi e Casi d'Uso**

## **Esempio 1 — Spedizione Gratuita Specifica per Regione**

* **Geolocation:** Specific countries → United States, Canada  
* **Page Targeting:** Every page  
* **Position:** Top Push (Sticky)

Risultato: Solo i visitatori statunitensi e canadesi vedono una barra di spedizione gratuita persistente.

## **Esempio 2 — Ricompensa per Clienti VIP**

* **Customer Show:** Specific tag → `VIP`  
* **Customer Hide:** No one  
* **Page Targeting:** Home page only

Risultato: Solo i clienti loggati taggati come VIP vedono la barra nella homepage.

## **Esempio 3 — Follow-Up Campagna Instagram**

* **UTM Source:** Instagram \+ Facebook  
* **Page Targeting:** All product pages  
* **Position:** Bottom Overlap (Sticky)

Risultato: I visitatori che arrivano da annunci Instagram o Facebook vedono una barra solo nelle pagine prodotto con messaggistica specifica della campagna.

## **Esempio 4 — Vendita Flash Programmata**

* **Scheduling:** Start → Venerdì 9:00 AM, End → Venerdì 11:59 PM  
* **Page Targeting:** Every page  
* **Position:** Top Push

Risultato: La barra appare automaticamente alle 9:00 di venerdì e scompare a mezzanotte — nessun ritiro manuale necessario.

## **Esempio 5 — Barra Inferiore Ritardata**

* **Time-on-Site:** Show after a while → 10 secondi  
* **Position:** Bottom Overlap (Sticky)  
* **Page Targeting:** All product pages

Risultato: Dopo che un visitatore ha navigato in una pagina prodotto per 10 secondi, appare una sottile barra inferiore con un'offerta correlata.

---

# **🚀 Risultato Finale**

Una volta configurati correttamente, le impostazioni di **Advanced Targeting** ti aiutano a mostrare il messaggio giusto alla persona giusta al momento giusto.

Con un targeting appropriato:

✅ Le barre appaiono solo nelle pagine in cui sono pertinenti  
✅ I clienti vedono messaggi personalizzati in base alla loro posizione, fonte o segmento  
✅ Le campagne a tempo sensibile vengono eseguite automaticamente senza intervento manuale  
✅ Gli acquirenti ospiti e quelli loggati ricevono esperienze differenziate  
✅ Il traffico pubblicitario riceve messaggistica coerente dal clic alla conversione  
✅ I merchant evitano di mostrare la stessa barra generica a ogni visitatore

Utilizzare efficacemente queste opzioni di targeting garantisce che ogni announcement bar risulti intenzionale, tempestiva e pertinente per le persone che la vedono 🎯