Lors de la génération de flux XML pour Google, Facebook, Bing et Pinterest, les valeurs monétaires doivent être formatées correctement pour garantir qu'elles soient 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 de plateforme entraînera des rejets de flux ou une analyse incorrecte des prix sur Google Merchant Center, Catalogue Facebook, Microsoft Bing Shopping et Catalogues Pinterest. Product Feed Pro et Product Feed Elite gèrent ce formatage automatiquement 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.
Exigences
- Product Feed Pro ou Product Feed Elite installé et actif
- WooCommerce installé et configuré avec la devise de votre boutique
- Au moins un flux de produits configuré pour Google, Facebook, Bing ou Pinterest
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 et Pinterest 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 milliers ne font pas partie de l'ISO 4217. Elles proviennent des spécifications de flux de chaque plateforme, bien que les quatre 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 et Pinterest exigent ce format
Lors de la soumission de flux de produits à Google Merchant Center, Catalogue Facebook, Microsoft Bing Shopping ou Catalogues Pinterest, les valeurs monétaires doivent suivre ces règles de formatage pour éviter les erreurs de flux. Ces plateformes appliquent une norme uniforme car :
- 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,50au lieu de1,000.50). Sans standardisation, cela entraîne une analyse incorrecte des prix. - 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. - Conformité obligatoire du flux : Google, Facebook, Bing et Pinterest rejettent les flux qui ne respectent pas leur formatage requis. Consultez la documentation officielle de chaque plateforme : Google, Facebook, Bing, Pinterest.
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 :
| Format régional (non accepté par ces canaux) | Format de flux requis |
|---|---|
| 1,23 EUR | 1234,56 EUR |
| 10,50 USD | 10500,99 USD |
| 5,75 GBP | 5000,75 GBP |
Remarque : les formats régionaux dans la colonne de gauche ne sont pas intrinsèquement incorrects. Ils sont parfaitement valides dans de nombreux pays. Ils ne sont tout simplement pas acceptés par Google, Facebook, Bing et Pinterest, 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 et Pinterest. 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.
Attention : il s'agit d'une personnalisation de niveau développeur. Aucune assistance n'est fournie pour les problèmes résultant de l'application de ces extraits. Procédez donc 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 de code 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 de code doit définir 'decimal' => ',' et 'thousand' => '.' :
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 :
Par exemple, un extrait de code complet pour supprimer le formatage requis uniquement pour les flux Google :
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
Product Feed Pro applique-t-il ce formatage à tous les types de flux ou uniquement à Google, Facebook, Bing et Pinterest ?
Ce formatage est appliqué spécifiquement aux modèles de flux Google, Facebook, Bing et Pinterest, car ces plateformes l'exigent explicitement. Les autres types de flux suivent les paramètres de devise de votre WooCommerce, sauf si vous configurez des substitutions supplémentaires.
Mon flux a été rejeté pour une erreur de format de prix. Que dois-je vérifier en premier ?
Vérifiez d'abord que Product Feed Pro génère les prix avec un point comme séparateur décimal, sans séparateur de milliers et avec un code de devise à trois lettres (par exemple, 1234.56 USD). Si le flux semble correct, vérifiez que vous n'avez appliqué aucun extrait de code de séparateur régional qui pourrait remplacer la sortie. Vérifiez également que les paramètres de devise de votre WooCommerce correspondent à la sortie souhaitée.
Ce formatage affectera-t-il les prix affichés sur ma vitrine ?
Non. Ce formatage s'applique uniquement à la sortie du flux XML envoyée à Google, Facebook, Bing et Pinterest. Les prix de votre vitrine continueront de s'afficher en utilisant les paramètres de formatage de devise de votre WooCommerce.
J'utilise une devise sans décimales (par exemple, JPY). Comment cela est-il géré ?
Pour les flux Google, Facebook, Bing et Pinterest, les prix sont toujours formatés avec deux décimales, quelles que soient vos configurations décimales WooCommerce. Un prix en Yen japonais de 1500 est soumis comme 1500.00 JPY, et non 1500 JPY. Ceci est imposé par le plugin pour répondre aux exigences de la plateforme.
J'ai appliqué les extraits de code de séparateur régional mais mon flux affiche toujours le format standard. Pourquoi ?
Assurez-vous d'avoir ajouté les deux extraits de code : le premier définit vos séparateurs préférés via adt_product_feed_localize_price_args (avec 'decimal' => ',' et 'thousand' => '.' pour le formatage européen), et le second supprime la plateforme spécifique de la liste d'application via adt_pfp_localize_price_iso4217_feeds. Assurez-vous également d'avoir actualisé le flux concerné après avoir enregistré les extraits de code, car les flux sont mis en cache et ne seront pas mis à jour tant qu'ils ne seront pas régénérés.
Puis-je appliquer des séparateurs régionaux à une seule plateforme et conserver le format standard pour les autres ?
Oui. Le filtre adt_pfp_localize_price_iso4217_feeds vous permet de supprimer individuellement des plateformes (Google, Facebook, Bing ou Pinterest) de la liste d'application. Incluez simplement l'extrait pour la plateforme que vous souhaitez remplacer et omettez les autres.
Comment actualiser un flux après avoir effectué des modifications ?
Allez dans Product Feed → Gérer les flux, localisez le flux que vous souhaitez régénérer et cliquez sur Actualiser le flux. Le fichier du flux sera reconstruit en utilisant les paramètres actuels du plugin et tous les extraits actifs.
Ce paramètre affecte-t-il les prix soldés et les prix réguliers de la même manière ?
Oui. Le formatage est appliqué de manière cohérente à tous les champs de prix soumis dans le flux, y compris les prix réguliers, les prix soldés et tous les attributs de prix personnalisés mappés dans votre modèle de flux.
Que se passe-t-il si WooCommerce est configuré pour afficher les prix sans décimales ?
Pour les flux Google, Facebook, Bing et Pinterest, le plugin affiche toujours les prix avec deux décimales. Vos paramètres de décimales WooCommerce ne sont pas appliqués à ces flux obligatoires. Par exemple, un prix de 1500 apparaîtra sous la forme 1500.00 dans le flux, quelle que soit la configuration de WooCommerce pour l'afficher sur votre vitrine.
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.
