Campi Speciali Prodotto (Mappatura Taglia, Colore, Materiale)
Associa gli attributi e le caratteristiche dei prodotti del tuo negozio ai campi XML standard g:size, g:color e g:material richiesti da Facebook e Instagram per i cataloghi di abbigliamento e moda.
Disponibile dalla v1.1.0
Panoramica
Il catalogo prodotti di Facebook riconosce campi XML specifici — g:size, g:color e g:material — per il filtraggio, gli annunci dinamici e le superfici di acquisto. Questi campi devono essere collegati ai dati di PrestaShop, ma ogni negozio li organizza in modo diverso: alcuni usano gruppi di attributi (per i prodotti con combinazioni), altri usano caratteristiche di prodotto (per i prodotti semplici), e molti adottano una combinazione di entrambi.
La sezione Campi Speciali Prodotto ti permette di indicare al modulo quale gruppo di attributi o caratteristica del tuo negozio corrisponde a ciascun campo standard. Una volta configurata la mappatura, il feed produce automaticamente i valori corretti per ogni prodotto e combinazione.
È disponibile anche un'opzione per includere gli attributi di combinazione rimanenti come elementi <additional_variant_attribute>, fornendo a Facebook dati più completi sulle varianti senza dover mappare manualmente ogni attributo.
Configurazione
- Vai su Moduli > Gestore moduli, trova Facebook & Instagram Product Catalogue Feed Pro e clicca su Configura.
- Clicca sulla scheda Campi Speciali Prodotto.
- Il pannello mostra tre campi tag — Taglia Prodotto, Colore Prodotto e Materiale Prodotto — oltre all'opzione Campi Variabili Aggiuntivi.
Assegnazione delle sorgenti a Taglia, Colore e Materiale
Ciascuno dei tre campi mostra un widget di inserimento tag. Clicca in un punto qualsiasi del widget per visualizzare un menu a tendina con tutti i gruppi di attributi e le caratteristiche di prodotto disponibili nel tuo negozio. Seleziona la voce che contiene i dati pertinenti.
| Campo | Cosa assegnare | Elemento XML risultante |
|---|---|---|
| Taglia Prodotto | Il gruppo di attributi o la caratteristica che contiene i valori di taglia (es. "Taglia", "Numero scarpe") | <g:size> |
| Colore Prodotto | Il gruppo di attributi o la caratteristica che contiene i valori di colore (es. "Colore") | <g:color> |
| Materiale Prodotto | Il gruppo di attributi o la caratteristica che contiene i valori di materiale (es. "Materiale", "Tessuto") | <g:material> |
Puoi assegnare più di una sorgente a un singolo campo. Se un prodotto ha un valore per la prima sorgente, viene utilizzato quello; in caso contrario il modulo prova la seconda sorgente, e così via. Questo è utile quando alcuni prodotti usano un gruppo di attributi e altri usano una caratteristica per lo stesso concetto.
Dopo aver effettuato le selezioni, clicca su Salva configurazione in fondo alla sezione.
Come Funziona
Gruppi di attributi vs. caratteristiche
PrestaShop archivia i dati di variazione dei prodotti in due luoghi:
- I gruppi di attributi (es. Taglia, Colore, Numero scarpe) gestiscono le combinazioni. Una "T-Shirt" nelle taglie S, M, L usa un gruppo di attributi. Ogni combinazione porta un valore distinto del gruppo di attributi.
- Le caratteristiche di prodotto (es. Materiale, Paese di origine) sono campi di metadati piatti collegati al prodotto stesso, non alle singole combinazioni.
Durante la generazione del feed, il modulo verifica ogni prodotto in base alle mappature configurate:
- Per una sorgente di tipo gruppo di attributi, recupera il valore della combinazione corrente per quel gruppo e lo inserisce nel feed.
- Per una sorgente di tipo caratteristica, legge il valore della caratteristica dal record del prodotto.
Vince la prima sorgente che restituisce un valore non vuoto. Se nessuna sorgente trova dati per un determinato prodotto, l'elemento XML viene semplicemente omesso per quel prodotto — Facebook accetta gli articoli senza questi campi; sono obbligatori solo per determinate categorie di prodotto.
Campi Variabili Aggiuntivi
| Campo | Valori | Predefinito | Descrizione |
|---|---|---|---|
| Generare i campi Variabili aggiuntivi? | Abilitato / Disabilitato | Abilitato | Quando attivo, tutti gli attributi di combinazione NON già mappati a Taglia, Colore o Materiale vengono inseriti nel feed come elementi <additional_variant_attribute>. |
Quando questa opzione è abilitata, il modulo prende ogni gruppo di attributi presente in una combinazione ed esclude quelli già assegnati a Taglia, Colore o Materiale. Gli attributi rimanenti vengono scritti ciascuno come:
<additional_variant_attribute>
<label>Fabric Weight</label>
<value>300gsm</value>
</additional_variant_attribute>
Questa opzione è particolarmente utile per i negozi con molte dimensioni di variazione (es. stile, vestibilità, lunghezza gamba) che non hanno un corrispondente diretto nei campi standard di Facebook. Disabilitare questa opzione produce un feed più snello e semplice — adatto se hai già mappato tutti gli attributi rilevanti nei campi standard.
Questa opzione si applica al feed completo principale e al feed per lingua. Non si applica ai feed in modalità paese (override di prezzo per paese).
Riferimento Sintassi
Il widget tag memorizza i valori internamente come elenco separato da virgole con prefissi di tipo. Di norma non sarà necessario modificarli direttamente, ma comprendere il formato è utile in fase di risoluzione dei problemi:
| Prefisso | Significato | Esempio |
|---|---|---|
a:<id> | Gruppo di attributi con l'ID indicato | a:3 (gruppo di attributi ID 3) |
f:<id> | Caratteristica di prodotto con l'ID indicato | f:7 (caratteristica ID 7) |
Più sorgenti sono separate da virgole: a:3,f:7 significa "prova prima il gruppo di attributi 3, poi la caratteristica 7".
Puoi trovare gli ID dei gruppi di attributi in Catalogo > Attributi e Caratteristiche > Attributi e gli ID delle caratteristiche in Catalogo > Attributi e Caratteristiche > Caratteristiche nel Back Office.
Esempi d'Uso
Esempio: Negozio di abbigliamento standard
Il tuo negozio vende T-shirt con combinazioni di Taglia e Colore. In PrestaShop si tratta di gruppi di attributi denominati "Taglia" (ID 1) e "Colore" (ID 3). Assegna "Taglia" a Taglia Prodotto e "Colore" a Colore Prodotto. Lascia Materiale vuoto se non tieni traccia dei dati sul tessuto. Il feed produrrà <g:size>M</g:size> e <g:color>Blue</g:color> per ogni combinazione, e Facebook potrà filtrare gli annunci in base a questi valori.
Esempio: Catalogo misto con caratteristiche e attributi
Vendi scarpe (combinazioni per taglia) e accessori (prodotti semplici con una caratteristica "Materiale"). Assegna il gruppo di attributi delle taglie scarpe a Taglia Prodotto e la caratteristica "Materiale" a Materiale Prodotto. Per le scarpe, il feed legge la taglia dalla combinazione. Per gli accessori, legge il materiale dalla caratteristica. Entrambi i tipi di prodotto funzionano con un'unica configurazione.
Esempio: Soppressione di variabili aggiuntive ridondanti
Hai già mappato Colore, Taglia e Materiale. I tuoi prodotti hanno anche un attributo "Fantasia", ma non vuoi che appaia nel feed. Lascia Campi Variabili Aggiuntivi disabilitato — non compariranno elementi <additional_variant_attribute>. Se in seguito decidi che la Fantasia è utile per il filtraggio su Facebook, riabilita il toggle e comparirà automaticamente per tutte le combinazioni che hanno un valore per la Fantasia.
Note Importanti
- Se un prodotto non ha alcun valore per le sorgenti assegnate a un campo, quell'elemento XML viene omesso. Il feed rimane valido — Facebook richiede Taglia, Colore e Genere solo per gli articoli di abbigliamento.
- Le sorgenti di tipo gruppo di attributi funzionano solo per i prodotti con combinazioni. Se un prodotto semplice non ha combinazioni, le sorgenti di tipo gruppo di attributi non restituiscono nulla; usa una sorgente di tipo caratteristica per i prodotti semplici.
- L'opzione Campi Variabili Aggiuntivi inserisce i gruppi di attributi non presenti nella mappatura Taglia/Colore/Materiale. Se nessuno è escluso, tutti i gruppi di attributi compaiono come variabili aggiuntive.
- Queste impostazioni sono per negozio. In una configurazione multi-negozio, vai nel contesto di ciascun negozio per configurare le mappature in modo indipendente.
- Dopo aver modificato le mappature, rigenera manualmente il feed dalla scheda Generazione Manuale del Feed affinché Facebook acquisisca la struttura aggiornata alla successiva importazione.
Risoluzione dei Problemi
| Problema | Soluzione |
|---|---|
g:size o g:color non sono presenti nel feed | Verifica che il gruppo di attributi o la caratteristica sia assegnato nel widget tag. Controlla che i prodotti abbiano effettivamente valori per quel gruppo/caratteristica. I prodotti semplici richiedono una sorgente di tipo caratteristica, non di tipo gruppo di attributi. |
| Per una combinazione appare il valore sbagliato | Potresti aver assegnato la sorgente di tipo caratteristica prima della sorgente di tipo gruppo di attributi per un campo. Vince la prima sorgente — riordina i tag in modo che il tag del gruppo di attributi compaia per primo. |
Gli elementi <additional_variant_attribute> non compaiono | Verifica che Generare i campi Variabili aggiuntivi? sia impostato su Abilitato e che il prodotto abbia attributi di combinazione non già mappati a Taglia, Colore o Materiale. |
| Dopo il salvataggio, i tag risultano vuoti al ricaricamento | Può accadere se gli ID non esistono più nel tuo negozio (es. un gruppo di attributi è stato eliminato). Apri il widget tag e riassegna dal menu a tendina. |
| Facebook segnala attributi obbligatori mancanti per l'abbigliamento | Taglia, Colore e Genere sono obbligatori per l'abbigliamento in alcune aree geografiche. Assicurati che Taglia e Colore siano mappati. Il Genere si configura separatamente nella scheda Genere all'interno di Campi Speciali Prodotto. |
Domande Frequenti
Posso assegnare lo stesso gruppo di attributi sia a Colore che a Taglia?
Tecnicamente sì, anche se non avrebbe senso pratico — lo stesso valore comparirebbe sia in <g:color> che in <g:size> per ogni combinazione. Usa gruppi di attributi o caratteristiche distinti per ciascun campo.
Devo mappare tutti e tre i campi (Taglia, Colore, Materiale)?
No. Mappa solo i campi applicabili ai tuoi prodotti. Facebook richiede Taglia e Colore solo per le categorie abbigliamento e calzature. Materiale è sempre facoltativo. I campi non mappati vengono semplicemente omessi dal feed.
Il mio negozio ha combinazioni, ma i valori di taglia sono memorizzati come caratteristica di prodotto, non come gruppo di attributi. Funzionerà comunque?
Sì. Assegna la sorgente di tipo caratteristica (con prefisso f:) al campo Taglia Prodotto. Il modulo legge le caratteristiche sia sui prodotti semplici che sui prodotti con combinazioni. Tieni presente che una caratteristica contiene un unico valore per prodotto, quindi tutte le combinazioni di quel prodotto mostreranno lo stesso valore di taglia.
Qual è la differenza tra assegnare due sorgenti a un campo e abilitare i Campi Variabili Aggiuntivi?
Le sorgenti multiple su un singolo campo (es. a:1,f:7) sono alternative di fallback — il modulo le prova nell'ordine indicato e inserisce nel campo standard <g:size> il primo risultato non vuoto. I Campi Variabili Aggiuntivi invece inseriscono tutti i gruppi di attributi rimanenti (quelli non presenti in nessuna delle tre mappature standard) come elementi separati <additional_variant_attribute>. Servono a scopi diversi e possono essere entrambi attivi contemporaneamente.
Come trovo gli ID numerici dei miei gruppi di attributi e caratteristiche?
Nel Back Office, vai su Catalogo > Attributi e Caratteristiche. La colonna ID è visibile nella vista elenco. In alternativa, quando apri il widget tag in Campi Speciali Prodotto, ogni voce nel menu a tendina ha già il prefisso corretto a: o f: applicato — non è necessario cercare gli ID manualmente quando si usa il widget.