Quando si generano feed XML per Google, Facebook, Bing e Pinterest, i valori della valuta devono essere formattati correttamente per garantire che vengano elaborati senza errori. Queste piattaforme richiedono che i prezzi utilizzino un punto come separatore decimale, nessun separatore delle migliaia e codici valuta di tre lettere. I codici valuta sono definiti da ISO 4217, mentre le regole del separatore provengono dalle specifiche del feed di ciascuna piattaforma.
L'invio di feed che non soddisfano questi requisiti di formattazione della piattaforma comporterà il rifiuto del feed o l'errata analisi dei prezzi su Google Merchant Center, Catalogo Facebook, Microsoft Bing Shopping e Cataloghi Pinterest. Product Feed Pro e Product Feed Elite gestiscono automaticamente questa formattazione per tutte queste piattaforme.
Se è necessario utilizzare separatori regionali anziché questo formato, è disponibile una soluzione alternativa a livello di sviluppatore tramite snippet PHP. Vedere la sezione Utilizzo dei separatori regionali di seguito. Si noti che questo approccio non è supportato.
Requisiti
- Product Feed Pro o Product Feed Elite installato e attivo
- WooCommerce installato e configurato con la valuta del tuo negozio
- Almeno un feed di prodotti configurato per Google, Facebook, Bing o Pinterest
Comprensione di ISO 4217 e delle regole di formattazione dei feed
ISO 4217 è lo standard internazionale per i codici valuta. Definisce i codici di tre lettere utilizzati per identificare le valute nei sistemi finanziari e commerciali, come USD per il dollaro USA, EUR per l'euro e JPY per lo yen giapponese. Google, Facebook, Bing e Pinterest richiedono tutti questi codici valuta ISO 4217 nelle presentazioni dei feed di prodotti.
Le regole per i separatori decimali e delle migliaia non fanno parte di ISO 4217. Provengono dalle specifiche del feed di ciascuna piattaforma, sebbene tutte e quattro le piattaforme siano allineate sugli stessi requisiti:
- Separatore decimale: un punto (
.) deve essere utilizzato per i valori decimali. - Separatori delle migliaia: non utilizzati. Ometterli previene errori di analisi.
- Codici valuta: il codice ISO 4217 di tre lettere (ad es.
USD,EUR,JPY) viene aggiunto al valore del prezzo.
Perché Google, Facebook, Bing e Pinterest richiedono questo formato
Quando si inviano feed di prodotti a Google Merchant Center, Catalogo Facebook, Microsoft Bing Shopping o Cataloghi Pinterest, i valori della valuta devono seguire queste regole di formattazione per evitare errori nel feed. Queste piattaforme impongono uno standard uniforme perché:
- Previene l'errata interpretazione dei dati: alcuni paesi utilizzano le virgole (
,) come separatori decimali e i punti (.) per le migliaia (ad es.1.000,50anziché1,000.50). Senza standardizzazione, ciò porta a un'errata analisi dei prezzi. - Garantisce la coerenza: Richiedendo lo stesso formato decimale (
.), le piattaforme possono interpretare accuratamente i valori dei prezzi indipendentemente dalle differenze regionali. - Conformità obbligatoria del feed: Google, Facebook, Bing e Pinterest rifiutano i feed che non rispettano la formattazione richiesta. Consulta la documentazione ufficiale per ciascuna piattaforma: Google, Facebook, Bing, Pinterest.
Come Product Feed Pro gestisce questa formattazione
Product Feed Pro e Product Feed Elite formattano automaticamente i prezzi nei tuoi feed XML per soddisfare i requisiti di queste piattaforme. Non è necessario configurare nulla. Il plugin lo gestisce per impostazione predefinita:
- I prezzi sono sempre formattati utilizzando un punto (
.) come separatore decimale. - Non vengono inclusi separatori delle migliaia per evitare problemi di analisi.
- Il codice valuta corretto di tre lettere (es.
USD,GBP,EUR) viene aggiunto ai valori dei prezzi, letto dall'impostazione della valuta del tuo negozio WooCommerce (get_woocommerce_currency()).
Ad esempio:
| Formato regionale (non accettato da questi canali) | Formato feed richiesto |
|---|---|
| 1.234,56 EUR | 1234,56 EUR |
| 10.500,99 USD | 10.500,99 USD |
| 5.000,75 GBP | 5.000,75 GBP |
Nota: i formati regionali nella colonna di sinistra non sono intrinsecamente sbagliati. Sono perfettamente validi in molti paesi. Semplicemente non sono accettati da Google, Facebook, Bing e Pinterest, i cui parser di feed richiedono il formato con punto decimale mostrato a destra.
Problemi comuni e soluzioni
Se il tuo feed viene rifiutato a causa di errori di formattazione della valuta, controlla:
- Separatori decimali errati: usa
.invece di, - Uso dei separatori delle migliaia: rimuovili completamente
- Codici valuta mancanti: assicurati che i prezzi includano il codice corretto di tre lettere
Utilizzo di separatori regionali invece del formato richiesto
Per impostazione predefinita, Product Feed Pro e Product Feed Elite applicano la formattazione corretta per tutti i feed Google, Facebook, Bing e Pinterest. Tuttavia, se il tuo negozio utilizza la formattazione numerica regionale (ad esempio, un punto come separatore delle migliaia e una virgola come separatore decimale) e desideri che i tuoi feed riflettano questo, puoi utilizzare gli snippet PHP di seguito per sovrascrivere il comportamento predefinito.
Attenzione: Questa è una personalizzazione a livello di sviluppatore. Non è disponibile supporto per problemi derivanti dall'applicazione di questi snippet, quindi procedi solo se ti senti a tuo agio nel modificare il file functions.php del tuo tema o nell'utilizzare un plugin per snippet di codice come WPCode.
Innanzitutto, assicurati che le opzioni valutarie di WooCommerce corrispondano alle tue preferenze. Vai su WooCommerce → Impostazioni → Generali e scorri fino alla sezione Opzioni valuta. Per la formattazione regionale europea, imposta il separatore delle migliaia su un punto (.) e il separatore decimale su una virgola (,).
Successivamente, aggiungi il seguente snippet al tuo functions.php o tramite il plugin WPCode. Questo forza tutti i tuoi feed e modelli a utilizzare i tuoi separatori preferiti tramite il filtro adt_product_feed_localize_price_args. Per la formattazione regionale europea, lo snippet deve impostare 'decimal' => ',' e 'thousand' => '.':
Quindi aggiungi uno o più dei seguenti snippet per rimuovere la formattazione richiesta per piattaforme specifiche tramite il filtro adt_pfp_localize_price_iso4217_feeds:
Ad esempio, uno snippet completo per rimuovere la formattazione richiesta solo per i feed di Google:
Dopo aver aggiunto gli snippet, aggiorna i tuoi feed. L'output rifletterà le tue preferenze sui separatori regionali:
Domande frequenti
Product Feed Pro applica questa formattazione a tutti i tipi di feed o solo a Google, Facebook, Bing e Pinterest?
Questa formattazione viene applicata specificamente ai modelli di feed di Google, Facebook, Bing e Pinterest, poiché queste piattaforme la richiedono esplicitamente. Altri tipi di feed seguono le impostazioni valutarie del tuo WooCommerce a meno che tu non configuri ulteriori override.
Il mio feed è stato rifiutato per un errore di formato del prezzo. Cosa dovrei controllare per prima cosa?
Prima conferma che Product Feed Pro stia generando prezzi con un punto come separatore decimale, nessun separatore delle migliaia e un codice valuta di tre lettere (ad esempio, 1234.56 USD). Se il feed sembra corretto, verifica di non aver applicato snippet di separatori regionali che potrebbero sovrascrivere l'output. Verifica anche che le impostazioni valutarie del tuo WooCommerce corrispondano all'output desiderato.
Questa formattazione influenzerà i prezzi visualizzati sul mio storefront?
No. Questa formattazione si applica solo all'output del feed XML inviato a Google, Facebook, Bing e Pinterest. I prezzi del tuo storefront continuano a essere visualizzati utilizzando le impostazioni di formattazione valutarie del tuo WooCommerce.
Utilizzo una valuta senza decimali (ad esempio, JPY). Come viene gestito?
Per i feed di Google, Facebook, Bing e Pinterest, i prezzi vengono sempre formattati con due cifre decimali indipendentemente dalle impostazioni decimali del tuo WooCommerce. Un prezzo in Yen giapponese di 1500 viene inviato come 1500.00 JPY, non 1500 JPY. Questo è imposto dal plugin per soddisfare i requisiti della piattaforma.
Ho applicato gli snippet dei separatori regionali ma il mio feed mostra ancora il formato standard. Perché?
Assicurati di aver aggiunto *entrambi* gli snippet: il primo imposta i tuoi separatori preferiti tramite adt_product_feed_localize_price_args (con 'decimal' => ',' e 'thousand' => '.' per la formattazione europea), e il secondo rimuove la piattaforma specifica dall'elenco di applicazione tramite adt_pfp_localize_price_iso4217_feeds. Assicurati anche di aver aggiornato il feed interessato dopo aver salvato gli snippet, poiché i feed sono memorizzati nella cache e non verranno aggiornati finché non rigenerati.
Posso applicare separatori regionali solo a una piattaforma e mantenere il formato standard per le altre?
Sì. Il filtro adt_pfp_localize_price_iso4217_feeds ti consente di rimuovere singole piattaforme (Google, Facebook, Bing o Pinterest) dall'elenco di applicazione in modo indipendente. Includi semplicemente lo snippet per la piattaforma che desideri sovrascrivere e lascia fuori le altre.
Come si aggiorna un feed dopo aver apportato modifiche?
Vai su Product Feed → Gestisci feed, individua il feed che desideri rigenerare e fai clic su Aggiorna feed. Il file del feed verrà ricostruito utilizzando le impostazioni correnti del plugin e gli snippet attivi.
Questa impostazione influisce allo stesso modo sui prezzi in saldo e sui prezzi regolari?
Sì. La formattazione viene applicata in modo coerente a tutti i campi di prezzo inviati nel feed, inclusi i prezzi regolari, i prezzi in saldo e gli attributi di prezzo personalizzati mappati nel modello del tuo feed.
Cosa succede se WooCommerce è impostato per visualizzare i prezzi senza decimali?
Per i feed di Google, Facebook, Bing e Pinterest, il plugin restituisce sempre i prezzi con due cifre decimali. Le impostazioni decimali del tuo WooCommerce non vengono applicate a questi feed obbligatori. Ad esempio, un prezzo di 1500 apparirà come 1500.00 nel feed indipendentemente da come WooCommerce è configurato per visualizzarlo nel tuo negozio.
Aiuto e supporto
Se hai bisogno di ulteriore assistenza con la formattazione della valuta nei tuoi feed di prodotto, non esitare ad aprire un ticket di supporto per contattare il team di supporto.
Si prega di notare che il sistema di supporto tramite ticket è esclusivo per gli utenti di Product Feed Elite.
Se utilizzi solo il plugin Product Feed Pro, non esitare a aprire un nuovo argomento nel forum di WordPress.org.
