Pourquoi l'ISO 4217 est utilisé pour Google, Facebook, Bing, Pinterest et TikTok dans les flux XML

Lors de la génération de flux XML pour Google, Facebook, Bing, Pinterest et TikTok, les valeurs monétaires doivent être formatées correctement pour garantir qu'elles sont traitées sans erreurs. Ces plateformes exigent que les prix utilisent un point comme séparateur décimal, aucun séparateur de milliers et des codes de devise à trois lettres. Les codes de devise sont définis par ISO 4217, tandis que les règles de séparateur proviennent des spécifications de flux de chaque plateforme.

La soumission de flux qui ne respectent pas ces exigences de formatage des plateformes entraînera des rejets de flux ou une analyse incorrecte des prix sur Google Merchant Center, Catalogue Facebook, Microsoft Bing Shopping, Catalogues Pinterest et Catalogue de produits TikTok. Product Feed Pro et Product Feed Elite gèrent automatiquement ce formatage pour toutes ces plateformes.

Si vous avez besoin d'utiliser des séparateurs régionaux au lieu de ce format, une solution de contournement au niveau du développeur utilisant des extraits PHP est disponible. Voir la section Utilisation des séparateurs régionaux ci-dessous. Notez que cette approche n'est pas prise en charge.

L'application de l'ISO 4217 pour TikTok nécessite Product Feed Pro 13.5.7 ou une version ultérieure. Sur les versions antérieures, les flux du Catalogue de produits TikTok pouvaient afficher les prix en utilisant le séparateur décimal formaté selon la locale de votre boutique au lieu du point requis, ce qui pouvait être rejeté par l'analyseur de catalogue de TikTok. Mettez à jour vers la version 13.5.7+ si votre flux TikTok est affecté. Pour obtenir de l'aide sur la configuration d'un flux TikTok, consultez Comment configurer un flux de catalogue TikTok.

Exigences

Comprendre l'ISO 4217 et les règles de formatage des flux

L'ISO 4217 est la norme internationale pour les codes de devise. Elle définit les codes à trois lettres utilisés pour identifier les devises dans les systèmes financiers et commerciaux, tels que USD pour le dollar américain, EUR pour l'euro et JPY pour le yen japonais. Google, Facebook, Bing, Pinterest et TikTok exigent tous ces codes de devise ISO 4217 dans les soumissions de flux de produits.

Les règles de séparateur décimal et de séparateur de milliers ne font pas partie de l'ISO 4217. Elles proviennent des spécifications de flux de chaque plateforme, bien que les cinq plateformes s'alignent sur les mêmes exigences :

• Séparateur décimal : Un point (.) doit être utilisé pour les valeurs décimales.
• Séparateurs de milliers : Non utilisés. Leur omission évite les erreurs d'analyse.
• Codes de devise : Le code à trois lettres ISO 4217 (par exemple, USD, EUR, JPY) est ajouté à la valeur du prix.

Pourquoi Google, Facebook, Bing, Pinterest et TikTok exigent ce format

Lors de la soumission de flux de produits au Google Merchant Center, au Catalogue Facebook, à Microsoft Bing Shopping, aux Catalogues Pinterest ou au Catalogue de produits TikTok, les valeurs monétaires doivent suivre ces règles de formatage pour éviter les erreurs de flux. Ces plateformes appliquent une norme uniforme car :

1. Empêche l'interprétation erronée des données : certains pays utilisent des virgules (,) comme séparateurs décimaux et des points (.) pour les milliers (par exemple, 1.000,50 au lieu de 1,000.50). Sans standardisation, cela entraîne une analyse incorrecte des prix.
2. Assure la cohérence : en exigeant le même format décimal (.), les plateformes peuvent interpréter correctement les valeurs de prix, quelles que soient les différences régionales.
3. Conformité obligatoire du flux : Google, Facebook, Bing, Pinterest et TikTok rejettent les flux qui ne respectent pas leur formatage requis. Consultez la documentation officielle de chaque plateforme : Google, Facebook, Bing, Pinterest, TikTok.

Comment Product Feed Pro gère ce formatage

Product Feed Pro et Product Feed Elite formatent automatiquement les prix dans vos flux XML pour répondre aux exigences de ces plateformes. Vous n'avez rien à configurer. Le plugin le gère par défaut :

• Les prix sont toujours formatés avec un point (.) comme séparateur décimal.
• Aucun séparateur de milliers n'est inclus pour éviter les problèmes d'analyse.
• Le code de devise à trois lettres correct (par exemple, USD, GBP, EUR) est ajouté aux valeurs de prix, lu à partir du paramètre de devise de votre boutique WooCommerce (get_woocommerce_currency()).

Par exemple :

Les formats régionaux dans la colonne de gauche ne sont pas intrinsèquement faux. Ils sont parfaitement valides dans de nombreux pays. Ils ne sont tout simplement pas acceptés par Google, Facebook, Bing, Pinterest et TikTok, dont les analyseurs de flux exigent le format décimal avec point indiqué à droite.

Problèmes courants et solutions

Si votre flux est rejeté en raison d'erreurs de formatage de devise, vérifiez ceci :

• Séparateurs décimaux incorrects : utilisez . au lieu de ,
• Utilisation de séparateurs de milliers : supprimez-les complètement
• Codes de devise manquants : assurez-vous que les prix incluent le code à trois lettres approprié

Utilisation de séparateurs régionaux au lieu du format requis

Par défaut, Product Feed Pro et Product Feed Elite appliquent le formatage correct pour tous les flux Google, Facebook, Bing, Pinterest et TikTok. Cependant, si votre boutique utilise le formatage numérique régional (par exemple, un point comme séparateur de milliers et une virgule comme séparateur décimal) et que vous souhaitez que vos flux le reflètent, vous pouvez utiliser les extraits PHP ci-dessous pour remplacer le comportement par défaut.

Ceci est une personnalisation de niveau développeur. Le support n'est pas disponible pour les problèmes qui surviennent lors de l'application de ces extraits, alors procédez uniquement si vous êtes à l'aise avec la modification du fichier functions.php de votre thème ou l'utilisation d'un plugin d'extraits de code tel que WPCode.

Tout d'abord, assurez-vous que vos options de devise WooCommerce correspondent à vos préférences. Accédez à WooCommerce → Paramètres → Général et faites défiler jusqu'à la section Options de devise. Pour le formatage régional européen, définissez le séparateur de milliers sur un point (.) et le séparateur décimal sur une virgule (,).

Ensuite, ajoutez l'extrait suivant à votre fichier functions.php ou via le plugin WPCode. Cela force tous vos flux et modèles à utiliser vos séparateurs préférés via le filtre adt_product_feed_localize_price_args. Pour le formatage régional européen, l'extrait doit définir 'decimal_separator' => ',' et 'thousand_separator' => '.' :

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

Ajoutez ensuite un ou plusieurs des extraits de code suivants pour supprimer le formatage requis pour des plateformes spécifiques via le filtre 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';
    });
});

Par exemple, un extrait de code complet pour supprimer le formatage requis uniquement pour les flux 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;
    });
});

Après avoir ajouté les extraits de code, actualisez vos flux. La sortie reflétera vos préférences de séparateurs régionaux :

Questions fréquemment posées

Aide et support

Si vous avez besoin d'aide supplémentaire pour le formatage des devises dans vos flux de produits, n'hésitez pas à ouvrir un ticket de support pour contacter l'équipe de support.

Veuillez noter que le système de support par ticket est exclusif aux utilisateurs de Product Feed Elite.

Si vous utilisez uniquement le plugin Product Feed Pro, n'hésitez pas à ouvrir un nouveau sujet sur le forum WordPress.org.