Perché ISO 4217 viene utilizzato per Google, Facebook, Bing, Pinterest e TikTok nei feed XML

Quando si generano feed XML per Google, Facebook, Bing, Pinterest e TikTok, i valori valutari 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 dei separatori 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 interpretazione dei prezzi su Google Merchant Center, Catalogo Facebook, Microsoft Bing Shopping, Cataloghi Pinterest e Catalogo Prodotti TikTok. 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.

L'applicazione di ISO 4217 per TikTok richiede Product Feed Pro 13.5.7 o versioni successive. Nelle versioni precedenti, i feed del Catalogo Prodotti TikTok potevano generare prezzi utilizzando il separatore decimale formattato secondo la localizzazione del tuo negozio invece del punto richiesto, cosa che il parser del catalogo di TikTok poteva rifiutare. Aggiorna alla versione 13.5.7+ se il tuo feed TikTok è interessato. Per assistenza nella configurazione di un feed TikTok, consulta Come configurare un feed catalogo TikTok.

Requisiti

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, Pinterest e TikTok 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 cinque le piattaforme concordino 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, Pinterest e TikTok richiedono questo formato

Quando si inviano feed di prodotti a Google Merchant Center, Catalogo Facebook, Microsoft Bing Shopping, Cataloghi Pinterest o Catalogo Prodotti TikTok, i valori valutari devono seguire queste regole di formattazione per evitare errori nel feed. Queste piattaforme impongono uno standard uniforme perché:

1. Previene l'errata interpretazione dei dati: alcuni paesi utilizzano le virgole (,) come separatori decimali e i punti (.) per le migliaia (ad es. 1.000,50 anziché 1,000.50). Senza standardizzazione, ciò porta a un'errata analisi dei prezzi.
2. Garantisce la coerenza: Richiedendo lo stesso formato decimale (.), le piattaforme possono interpretare accuratamente i valori dei prezzi indipendentemente dalle differenze regionali.
3. Conformità obbligatoria del feed: Google, Facebook, Bing, Pinterest e TikTok rifiutano i feed che non rispettano la loro formattazione richiesta. Consulta la documentazione ufficiale per ciascuna piattaforma: Google, Facebook, Bing, Pinterest, TikTok.

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:

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, Pinterest e TikTok, i cui parser di feed richiedono il formato decimale con punto 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 di Google, Facebook, Bing, Pinterest e TikTok. 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 la riflettano, puoi utilizzare gli snippet PHP di seguito per sovrascrivere il comportamento predefinito.

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 template 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_separator' => ',' e 'thousand_separator' => '.':

add_filter('adt_product_feed_localize_price_args', function($args) {
    $args['decimal_separator'] = ',';
    $args['thousand_separator'] = '.';
    return $args;
});

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:

// Google feeds
add_filter('adt_pfp_localize_price_iso4217_feeds', function($feeds) {
    return array_filter($feeds, function($feed) {
        return strpos($feed, 'google_') !== 0;
    });
});

// Facebook feeds
add_filter('adt_pfp_localize_price_iso4217_feeds', function($feeds) {
    return array_filter($feeds, function($feed) {
        return strpos($feed, 'facebook_') !== 0;
    });
});

// Bing feeds
add_filter('adt_pfp_localize_price_iso4217_feeds', function($feeds) {
    return array_filter($feeds, function($feed) {
        return strpos($feed, 'bing_') !== 0;
    });
});

// Pinterest feeds
add_filter('adt_pfp_localize_price_iso4217_feeds', function($feeds) {
    return array_filter($feeds, function($feed) {
        return $feed !== 'pinterest';
    });
});

// TikTok feeds
add_filter('adt_pfp_localize_price_iso4217_feeds', function($feeds) {
    return array_filter($feeds, function($feed) {
        return $feed !== 'tiktok';
    });
});

Ad esempio, uno snippet completo per rimuovere la formattazione richiesta solo per i feed di Google:

add_filter('adt_product_feed_localize_price_args', function($args) {
    $args['decimal_separator'] = ',';
    $args['thousand_separator'] = '.';
    return $args;
});

add_filter('adt_pfp_localize_price_iso4217_feeds', function($feeds) {
    return array_filter($feeds, function($feed) {
        return strpos($feed, 'google_') !== 0;
    });
});

Dopo aver aggiunto gli snippet, aggiorna i tuoi feed. L'output rifletterà le tue preferenze sui separatori regionali:

Domande frequenti

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.