Generazione Feed per Negozio — Lingue, Valute e Paesi

Configura per quali lingue e paesi viene generato il feed del catalogo prodotti e quale valuta riceve ciascun mercato.

note

Disponibile dalla v2.0.0

Panoramica

Il modulo genera fino a tre file XML separati per negozio: un feed principale, un feed Lingue opzionale e un feed Paesi opzionale. Puoi scegliere quali lingue e paesi sono attivi; il modulo produce i dati prodotto corretti — nomi tradotti, descrizioni, URL e prezzi nella valuta giusta — per ciascuno di essi.

Facebook e Instagram richiedono un singolo URL di catalogo per mercato. Abilitando lingue e paesi aggiuntivi qui, eviti di gestire installazioni separate del modulo o di duplicare manualmente i cataloghi. Un'unica esecuzione di generazione produce tutti i file necessari ai tuoi account pubblicitari.

Se il tuo negozio vende in una sola lingua e una sola valuta, devi configurare soltanto il feed principale. I feed Lingue e Paesi sono facoltativi e vengono generati solo quando almeno una lingua o un paese è abilitato al di fuori delle impostazioni predefinite.

Configurazione

1. Vai su Moduli > Gestione moduli, trova Facebook & Instagram Product Catalogue Feed Pro e clicca su Configura.
2. Clicca sulla scheda Generazione Feed. Se gestisci più negozi, appare una scheda separata per ciascuno.
3. Configura i campi descritti di seguito, poi clicca su Salva configurazione.

Impostazioni Feed Principale

Campo	Valori	Descrizione
Generare questo negozio?	Abilitato / Disabilitato	Appare solo nelle configurazioni multi-negozio. Quando disabilitato, questo negozio viene completamente ignorato durante la generazione del feed — nessun file viene scritto e gli URL del feed del negozio restituiscono vuoto.
Lingua predefinita del feed	Qualsiasi lingua attiva	La lingua usata per nomi prodotto, descrizioni e URL nel feed principale.
Valuta predefinita del feed	Qualsiasi valuta attiva	La valuta usata per i prezzi nel feed principale. Impostala sulla tua valuta di vendita principale.
URL feed predefinito	(sola lettura)	L'URL da registrare in Facebook Ads Manager > Cataloghi. Cliccaci sopra per copiarlo negli appunti.

Il feed principale viene sempre generato finché il negozio è abilitato. Usa la lingua e la valuta predefinite che hai scelto qui, indipendentemente da eventuali impostazioni aggiuntive di lingua o paese.

Lingue Aggiuntive

Questa sezione appare solo quando il tuo negozio ha più di una lingua attiva.

Campo	Valori	Descrizione
Genera [Nome Lingua]	Abilitato / Disabilitato	Quando abilitato, i dati prodotto in quella lingua vengono inclusi nel feed Lingue. Puoi abilitare tutte le lingue che hai attive.
URL feed lingue	(sola lettura)	L'URL del feed Lingue. Usa questo URL — non l'URL del feed principale — quando registri il catalogo specifico per lingua in Facebook.

Abilita una lingua qui solo se disponi di nomi prodotto, descrizioni e URL tradotti nel tuo negozio per quella lingua. Se le traduzioni mancano, il feed tornerà al contenuto della lingua predefinita.

Le lingue già selezionate come Lingua predefinita del feed vengono automaticamente escluse dal feed lingue per evitare voci duplicate.

Override Valuta / Prezzi per Paese

Questa sezione appare solo quando il tuo negozio ha più di un paese attivo.

Campo	Valori	Descrizione
[Nome Paese] (interruttore)	Abilitato / Disabilitato	Quando abilitato, una sezione specifica per paese viene inclusa nel feed Paesi con i prezzi nella valuta selezionata.
Valuta	Qualsiasi valuta attiva	La valuta da usare per i prezzi prodotto nella generazione del feed Paesi per questo paese.
Lingua associata	Qualsiasi lingua attiva	La lingua usata per nomi prodotto, descrizioni e — aspetto fondamentale — gli URL prodotto nel feed di questo paese. Facebook usa l'URL per indirizzare gli acquirenti direttamente alla pagina prodotto corretta.
URL feed paesi	(sola lettura)	L'URL del feed Paesi. Registra questo URL in Facebook quando hai bisogno di prezzi o valute diversi per paese.

Integrazione Catalogo Facebook

Campo	Descrizione
Numero Catalogo	Il tuo ID Catalogo Prodotti Facebook. Visibile solo quando è installato anche il modulo Facebook Pixel Plus. Trovalo in Facebook Ads Manager > Cataloghi — appare sotto il nome del tuo catalogo. Incollalo qui in modo che i due moduli possano scambiarsi dati.

Come Funziona

Tre Feed, Un'Unica Esecuzione

Ogni volta che il feed viene generato — manualmente, tramite cron o tramite l'URL di generazione — il modulo scrive fino a tre file XML per negozio:

• Feed principale (fpf-{nome-negozio}-{hash}.xml): Sempre prodotto. Contiene tutti i prodotti attivi nella lingua e valuta predefinite.
• Feed Lingue (fpf-{nome-negozio}-lang-{hash}.xml): Prodotto solo se almeno una lingua è abilitata nella sezione Lingue Aggiuntive. Contiene gli stessi prodotti tradotti in ciascuna lingua abilitata.
• Feed Paesi (fpf-{nome-negozio}-country-{hash}.xml): Prodotto solo se almeno un paese è abilitato nella sezione Paesi. Contiene i prezzi ricalcolati nella valuta assegnata al paese.

Tutti e tre i file condividono lo stesso catalogo prodotti. Abilitare più lingue o paesi non duplica i prodotti — genera rappresentazioni localizzate aggiuntive degli stessi articoli.

Come Vengono Memorizzati i Dati di Lingua e Paese

Quando salvi le impostazioni di Generazione Feed, il modulo memorizza le lingue abilitate come oggetto JSON compatto in un singolo record del database (FPF_{shop_id}_LANGS). Le impostazioni per paese — il flag di abilitazione, la valuta e la lingua associata — sono memorizzate insieme in un secondo record JSON (FPF_{shop_id}_COUNTRIES). Questa struttura significa che la generazione del feed legge solo due righe del database per conoscere l'intera matrice di lingue e paesi, mantenendo la generazione rapida anche con molte lingue configurate.

Comportamento Multi-Negozio

Ogni negozio ha la propria scheda Generazione Feed con impostazioni indipendenti. L'interruttore Generare questo negozio? (visibile solo in modalità multi-negozio) ti consente di escludere un negozio dalla generazione senza rimuoverne la configurazione. La lingua predefinita, la valuta e gli eventuali override di lingua o paese sono tutti memorizzati per negozio e non vengono mai condivisi tra i negozi.

URL e Sicurezza

Gli URL del feed contengono un hash MD5 derivato dalla chiave cookie del tuo negozio. Questo li rende non indovinabili senza necessità di configurazione. Se hai bisogno di proteggere ulteriormente i feed, usa le impostazioni di Protezione Feed (HTTP Basic Auth) nella scheda Protezione Feed — si applicano a tutti e tre i tipi di feed.

Esempi d'Uso

Esempio: negozio francese che vende in Francia, Belgio e Svizzera

Imposta la Lingua predefinita del feed su Francese e la Valuta predefinita del feed su EUR. Abilita la Svizzera nella sezione Paesi e seleziona CHF come valuta con il Francese come lingua associata. Il feed principale copre Francia e Belgio (entrambi EUR); il feed paesi copre la Svizzera con prezzi in CHF. Registra entrambi gli URL del feed nelle impostazioni del catalogo Facebook.

Esempio: negozio spagnolo con traduzioni in inglese e tedesco

Imposta la lingua predefinita sullo Spagnolo. Abilita Inglese e Tedesco nella sezione Lingue Aggiuntive. Tutte e tre le lingue sono incluse nel feed — Spagnolo nel feed principale, Inglese e Tedesco nel feed lingue. Registra l'URL del feed lingue in Facebook insieme all'URL del feed principale per servire gli acquirenti in ciascuna lingua.

Esempio: configurazione multi-negozio con un negozio B2B e uno B2C

In una configurazione multi-negozio, ogni scheda negozio è indipendente. Abilita l'interruttore Generare questo negozio? solo per il negozio B2C. Il negozio B2B è escluso da tutta la generazione del feed, impedendo che i prezzi all'ingrosso appaiano nel tuo catalogo Facebook.

Note Importanti

• L'interruttore Generare questo negozio? appare solo in modalità multi-negozio. Nelle installazioni con un singolo negozio, la generazione è sempre attiva.
• L'URL del feed Lingue e l'URL del feed Paesi sono identici per tutti i negozi — il modulo usa gli stessi nomi di file con hash tra i negozi. Se gestisci più negozi, i loro feed vengono scritti in file separati denominati in base allo slug del negozio.
• Le voci per paese appaiono in questa sezione solo se il paese è attivo e associato al negozio corrente nel back office di PrestaShop (Internazionale > Localizzazione > Paesi).
• Disabilitare tutti i negozi in una configurazione multi-negozio causa l'interruzione immediata della generazione senza output.
• La Lingua associata per un paese influisce sia sul contenuto dei prodotti (nomi, descrizioni) sia sugli URL prodotto nel feed paesi. Se il tuo negozio ha URL localizzati (ad es. /de/ per il tedesco), assegna la lingua corretta affinché il link nel feed rimandi alla pagina giusta per gli acquirenti di quel paese.

Risoluzione dei Problemi

Problema	Soluzione
La sezione Lingue o Paesi non appare	La sezione è nascosta quando il negozio ha una sola lingua attiva o un solo paese attivo. Aggiungi altre lingue o paesi in Internazionale > Traduzioni e Internazionale > Localizzazione e poi torna a questa scheda.
L'URL del feed paesi restituisce un file vuoto	Nessun paese è ancora abilitato, oppure tutti i paesi abilitati hanno zero prodotti dopo i filtri di categoria/esclusione. Abilita almeno un paese e rigenera.
I prezzi di un paese appaiono nella valuta sbagliata	Controlla il menu a tendina Valuta per quel paese nella sezione Paesi. Assicurati che la valuta selezionata sia attiva in Internazionale > Localizzazione > Valute.
Dopo il salvataggio, una selezione di lingua torna al valore precedente	Il modulo preserva l'ultimo stato salvato dall'archivio JSON. Se il menu a tendina sembra azzerarsi, svuota la cache del browser e ricarica la pagina di configurazione.
Multi-negozio: viene generato il feed di un solo negozio	Verifica che Generare questo negozio? sia abilitato per tutti i negozi che vuoi includere. Questa impostazione è globale — non è influenzata dal selettore di contesto negozio nel Back Office.
Il campo Numero Catalogo è assente	Questo campo appare solo quando il modulo Facebook Pixel Plus (facebookconversiontrackingplus) è installato e attivo.

Domande Frequenti

Devo registrare tutti e tre gli URL dei feed in Facebook?

Registra solo gli URL dei feed che hai effettivamente configurato. Se non hai abilitato lingue aggiuntive, salta l'URL del feed Lingue. Se non hai abilitato nessun paese, salta l'URL del feed Paesi. Registrare in Facebook un URL di feed vuoto o inesistente causerà errori nel catalogo.

Cosa succede al feed se cambio la lingua predefinita dopo la prima generazione?

La successiva esecuzione di generazione ricostruisce il feed principale nella nuova lingua predefinita. Il vecchio file viene sostituito. Se Facebook ha già importato il feed precedente, aggiornerà il suo catalogo alla successiva importazione pianificata.

Posso avere una valuta predefinita diversa per ogni lingua?

Non tramite il feed Lingue — utilizza la stessa valuta predefinita del feed principale, traducendo solo il contenuto testuale. Per servire valute diverse, usa il feed Paesi e assegna a ciascun paese la propria valuta nel menu a tendina Valuta.

In che modo la Lingua associata per un paese influisce sugli URL prodotto?

Facebook usa l'URL prodotto del feed per indirizzare gli acquirenti alla pagina prodotto corretta. Se il tuo negozio ha URL specifici per lingua (ad es. /fr/ per il francese, /en/ per l'inglese), imposta la lingua associata in modo corrispondente affinché il link nel feed si risolva correttamente per gli acquirenti di quel paese.

Se abilito in Lingue Aggiuntive la stessa lingua già usata come predefinita, apparirà due volte?

No. Il modulo esclude automaticamente la lingua predefinita dal feed Lingue durante la generazione, anche se è attivata nella sezione Lingue Aggiuntive.

Abilitare molti paesi rallenta la generazione del feed?

Ogni paese abilitato aggiunge un passaggio separato sul catalogo prodotti durante la generazione. Per cataloghi di grandi dimensioni, considera l'uso delle impostazioni di generazione a cicli (scheda Opzioni di Generazione) per distribuire il lavoro su più richieste, oppure configura un cron job per la generazione automatica.

Funzionalità Correlate

• Opzioni di Generazione — Configura dimensione ciclo, timeout e numero massimo di prodotti per esecuzione
• Protezione Feed — Proteggi con password gli URL del feed tramite HTTP Basic Auth
• Generazione Automatica (Cron Job) — Pianifica la generazione del feed senza intervento manuale