Identificatore e Descrizione del Prodotto
Controlla quale valore il feed utilizza come ID univoco di ogni prodotto e quale campo di testo Facebook riceve come descrizione.
Disponibile dalla v1.0.0
Panoramica
Il formato del catalogo di Facebook richiede due dati per ogni prodotto: un identificatore stabile e univoco (id) e una descrizione testuale. Il modulo ti offre il controllo completo su entrambi.
L'identificatore è ciò che Facebook usa per abbinare le voci del catalogo alle campagne pubblicitarie, agli eventi pixel e alle schede prodotto nel negozio. Scegliere il valore sbagliato — o cambiarlo in un secondo momento — rompe il collegamento tra il catalogo e le campagne attive. Scegli una volta e mantienilo.
La descrizione è il testo che gli acquirenti leggono negli annunci dinamici e nelle pagine di navigazione del catalogo. I prodotti di PrestaShop spesso hanno due o tre campi di testo (descrizione breve, descrizione completa, meta descrizione), e la loro qualità varia da prodotto a prodotto. Il modulo può selezionare automaticamente il campo migliore in base a un ordine di priorità che definisci tu.
Configurazione
- Vai su Moduli > Gestione moduli, trova Facebook & Instagram Product Catalogue Feed Pro e clicca su Configura.
- Clicca sulla scheda Opzioni Prodotto.
- Il blocco Identificatore Principale del Prodotto si trova in cima alla scheda. Il campo Priorità Descrizione Prodotto si trova direttamente sotto.
- Modifica le impostazioni descritte di seguito, quindi clicca su Salva in fondo al modulo.
Identificatore Principale del Prodotto
L'impostazione Identificatore Principale del Prodotto (FPF_PRODUCT_ID_TYPE) determina il valore scritto nel campo id di ogni voce del catalogo.
| Opzione | Valore usato nel feed | Quando usarlo |
|---|---|---|
| ID (predefinito) | ID numerico interno di PrestaShop (es. 42) | Il tuo negozio non ha un riferimento/SKU coerente per ogni prodotto, oppure stai partendo da zero senza un catalogo esistente |
| Riferimento | Il campo Riferimento del prodotto nella scheda prodotto | I tuoi prodotti hanno già codici SKU/riferimento stabili che compaiono anche nel tuo ERP, nel sistema di magazzino o in altri canali |
La modalità ID è il predefinito più sicuro. Ogni prodotto in PrestaShop ha un ID numerico che non cambia mai. Lo svantaggio è che questi numeri sono privi di significato al di fuori di PrestaShop — se mai dovessi migrare a una piattaforma diversa, gli ID non corrisponderanno.
La modalità Riferimento usa il valore inserito nel campo Riferimento di ogni scheda prodotto. Questo rende il catalogo portabile e coerente con altri sistemi. Il requisito è che ogni prodotto (e ogni combinazione, se vendi combinazioni) abbia un riferimento univoco e non vuoto. I prodotti con un riferimento vuoto tornano automaticamente al formato ID numerico.
Se stai già gestendo campagne pubblicitarie attive su Facebook o Instagram collegate a un catalogo esistente, non modificare questa impostazione. Cambiare il tipo di identificatore modifica il valore
iddi ogni prodotto, interrompendo il collegamento tra i tuoi annunci e le nuove voci del catalogo.
Prefisso e Suffisso
Se il tuo negozio condivide un catalogo prodotti con un altro canale (un secondo feed, un'esportazione Google Shopping, un'altra installazione PrestaShop), potresti trovare che due cataloghi contengono prodotti con lo stesso ID. Facebook li tratta come duplicati. Un prefisso o un suffisso rende univoco ogni ID in questo feed senza toccare i dati dei prodotti sottostanti.
| Campo | Chiave di configurazione | Descrizione |
|---|---|---|
| Prefisso ID Prodotto (opzionale) | FPF_PREFIX | Testo anteposto a ogni ID prodotto nel feed. Esempio: shop1- produce shop1-42. |
| Suffisso ID Prodotto (opzionale) | FPF_SUFFIX | Testo aggiunto in fondo a ogni ID prodotto, indipendentemente dall'abilitazione delle combinazioni. Esempio: -IT produce 42-IT. |
Come vengono costruiti gli ID con entrambi i campi impostati:
- Prodotto semplice in modalità ID:
{prefix}{id_product}{suffix}— es.shop1-42-IT - Prodotto semplice in modalità Riferimento (con riferimento):
{reference}{suffix}— es.MYSKU001-IT(il prefisso non viene applicato in modalità riferimento) - Combinazione in modalità ID:
{prefix}{id_product}{combination_prefix}{id_product_attribute}{suffix} - Combinazione in modalità Riferimento (la combinazione ha il proprio riferimento):
{combi_reference}{suffix}
Lascia entrambi i campi vuoti se il tuo catalogo è l'unico a usare questi ID prodotto su Facebook.
Il campo Prefisso ID Combinazione (anch'esso presente in questa scheda) è separato — si inserisce tra l'ID prodotto e l'ID combinazione per i prodotti con combinazioni in modalità ID. Non è trattato in questa guida.
Priorità Descrizione Prodotto
L'impostazione Priorità Descrizione Prodotto (FPF_PRODUCT_DESC_PRIO) controlla quale campo di testo il modulo scrive nel campo description del feed, e in quale ordine li prova quando il campo preferito è vuoto o troppo corto.
I campi sorgente disponibili sono:
| Codice | Campo sorgente | Note |
|---|---|---|
Descrizione Breve (s) | Descrizione breve del prodotto | Di solito un riassunto di una o due frasi. Spesso ben scritta e concisa. |
Descrizione (d) | Descrizione completa del prodotto | Può essere lunga e contenere markup HTML. Il modulo rimuove automaticamente l'HTML. |
Meta Descrizione (m) | Campo meta descrizione SEO | Di solito una frase breve e pulita, scritta per i motori di ricerca. |
Il menu a discesa elenca tutti i possibili ordinamenti di questi tre campi. Selezionando Descrizione Breve > Descrizione > Meta Descrizione si ottiene: usa la descrizione breve se è abbastanza lunga; se non lo è, ricadi sulla descrizione completa; se anche quella è troppo corta, prova la meta descrizione.
Facebook richiede una lunghezza minima per la descrizione. Il modulo usa un minimo interno di 20 caratteri. Qualsiasi campo più corto di questa soglia viene saltato e si passa al campo successivo nell'ordine di priorità.
Esiste anche un'opzione speciale:
| Opzione | Comportamento |
|---|---|
Più lunga — Scegli sempre la più lunga disponibile (l) | Ignora l'ordine di priorità e sceglie sempre il campo tra i tre con il maggior numero di caratteri. |
Il valore predefinito è Descrizione Breve > Descrizione (sd), che funziona bene per la maggior parte dei negozi.
Se un prodotto non ha alcun campo descrizione che soddisfi la lunghezza minima tra le sorgenti configurate, il prodotto viene segnalato come errore di descrizione. Puoi vedere questi errori nella scheda Errori dopo la generazione.
Esempi d'uso
Esempio: Negozio con SKU coerenti già in uso
I tuoi prodotti hanno tutti un Riferimento come SEDIA-ROVERE-L. Esporti anche su Google Shopping usando gli stessi riferimenti. Imposta Identificatore Principale del Prodotto su Riferimento in modo che entrambi i cataloghi condividano gli stessi ID prodotto. Gli eventi pixel di Facebook attivati con il codice riferimento corrisponderanno correttamente alle voci del catalogo.
Esempio: Configurazione multi-feed per due paesi
Generi un feed per la Francia e uno per la Germania. Entrambi i feed includono gli stessi prodotti (stessi ID). Per evitare che Facebook li tratti come duplicati, imposta Suffisso ID Prodotto su -FR nella configurazione del negozio francese e -DE in quella tedesca. I prodotti nel feed francese diventano 42-FR e in quello tedesco 42-DE.
Esempio: Prodotti con descrizioni complete dettagliate ma descrizioni brevi scarse
Il tuo catalogo è stato migrato da un'altra piattaforma e le descrizioni brevi sono per lo più vuote. Imposta Priorità Descrizione Prodotto su Descrizione > Descrizione Breve > Meta Descrizione in modo che il modulo provi sempre prima la descrizione completa.
Note Importanti
- Modificare l'Identificatore Principale del Prodotto dopo aver già collegato un catalogo alle inserzioni di Facebook richiede di ricreare la connessione al catalogo o rimappare il set di prodotti. Pianifica questa modifica durante la configurazione iniziale.
- Nelle configurazioni multi-negozio, questa impostazione viene salvata per negozio. Il feed di ogni negozio può usare un tipo di identificatore e prefisso/suffisso diverso senza influenzare gli altri negozi.
- La modalità Riferimento applica il prefisso solo ai prodotti in fallback ID (quelli senza riferimento). I prodotti con un riferimento ricevono solo il suffisso.
- La descrizione viene privata dei tag HTML prima di essere scritta nel feed. Non è necessario usare campi in solo testo — il modulo gestisce la pulizia automaticamente.
- Le descrizioni più lunghe di 10.000 caratteri vengono troncate a 9.996 caratteri con
...aggiunto in fondo per rispettare il limite di lunghezza del campo di Facebook.
Risoluzione dei Problemi
| Problema | Soluzione |
|---|---|
| Facebook segnala ID prodotto duplicati dopo l'aggiunta di un secondo feed | Aggiungi un Prefisso ID Prodotto o un Suffisso univoco per differenziare questo feed dall'altro. |
| Molti prodotti segnalati come "errore di descrizione" dopo la generazione | Controlla la scheda Errori per vedere quali prodotti sono coinvolti. Poi aggiungi descrizioni a quei prodotti oppure modifica l'ordine di priorità in modo che venga provato prima un campo compilato. |
| Le campagne pubblicitarie hanno smesso di essere pubblicate dopo aver modificato l'impostazione dell'identificatore | Gli ID prodotto nel catalogo sono cambiati. Ricarica o aggiorna il catalogo in Facebook Business Manager e ricollega il set di prodotti alla campagna. |
| I prodotti in modalità Riferimento usano ID numerici invece dei riferimenti | Quei prodotti hanno il campo Riferimento vuoto nella scheda prodotto. Compila il campo Riferimento o passa alla modalità ID. |
Domande Frequenti
Quale tipo di identificatore consiglia Facebook?
Facebook non impone un valore specifico, ma deve essere univoco e stabile. Se già tracci i prodotti tramite SKU o riferimento in altri sistemi, usa la modalità Riferimento per coerenza. Se i tuoi prodotti non hanno riferimenti affidabili, usa la modalità ID predefinita.
Posso usare sia un prefisso che un suffisso allo stesso tempo?
Sì. Entrambi i campi vengono applicati indipendentemente. Un prodotto con prefisso A- e suffisso -B produce un ID come A-42-B.
Cosa succede se due prodotti hanno lo stesso valore di Riferimento?
Facebook rifiuterà la voce duplicata durante l'elaborazione del catalogo e segnalerà un errore di validazione. Assicurati che tutti i riferimenti prodotto siano univoci prima di passare alla modalità Riferimento. Puoi verificarlo in PrestaShop sotto Catalogo > Prodotti esportando e controllando la colonna Riferimento.
L'impostazione della priorità della descrizione influenza tutte le lingue nel feed?
Sì. Lo stesso ordine di priorità viene applicato nella costruzione del feed per ogni lingua. Se un prodotto ha una descrizione breve in francese ma non in inglese, il modulo passa al campo di priorità successivo per la voce in inglese.
I miei prodotti hanno descrizioni complete molto dettagliate con tabelle ed elenchi puntati. Verranno visualizzati correttamente su Facebook?
Il campo descrizione di Facebook è solo testo normale. Il modulo rimuove tutti i tag HTML prima di scrivere il valore. Gli elenchi puntati e il contenuto delle tabelle appariranno come frasi in testo normale, il che è il comportamento corretto per un feed catalogo.