Bij het genereren van XML-feeds voor Google, Facebook, Bing en Pinterest moeten valutawaarden correct worden geformatteerd om ervoor te zorgen dat ze zonder fouten worden verwerkt. Deze platforms vereisen dat prijzen een punt als decimaalscheidingsteken gebruiken, geen duizendscheidingspunten, en drieletterige valutacodes. De valutacodes worden gedefinieerd door ISO 4217, terwijl de scheidingstekensregels afkomstig zijn uit de eigen feedspecificatie van elk platform.
Het indienen van feeds die niet voldoen aan deze platformformacerequirementen, resulteert in afwijzing van de feed of onjuiste prijsinterpretatie in Google Merchant Center, Facebook Catalog, Microsoft Bing Shopping en Pinterest Catalogs. Product Feed Pro en Product Feed Elite verwerken deze opmaak automatisch voor al deze platforms.
Als u regionale scheidingstekens wilt gebruiken in plaats van dit formaat, is een oplossing op ontwikkelaarsniveau met PHP-snippets beschikbaar. Zie de sectie Regionale scheidingstekens gebruiken hieronder. Merk op dat deze aanpak niet wordt ondersteund.
Vereisten
- Product Feed Pro of Product Feed Elite geïnstalleerd en actief
- WooCommerce geïnstalleerd en geconfigureerd met uw winkelvaluta
- Minstens één productfeed geconfigureerd voor Google, Facebook, Bing of Pinterest
Inzicht in ISO 4217 en feedformacerequirementen
ISO 4217 is de internationale standaard voor valutacodes. Het definieert de drieletterige codes die worden gebruikt om valuta's te identificeren in financiële en commerciële systemen, zoals USD voor US Dollar, EUR voor Euro en JPY voor Japanse Yen. Google, Facebook, Bing en Pinterest vereisen allemaal deze ISO 4217 valutacodes bij het indienen van productfeeds.
De regels voor het decimaal- en duizendscheidingssteken maken geen deel uit van ISO 4217. Ze komen uit de eigen feedspecificatie van elk platform, hoewel alle vier de platforms dezelfde vereisten hanteren:
- Decimaalscheidingsteken: Een punt (
.) moet worden gebruikt voor decimale waarden. - Duizendscheidingspunten: Niet gebruikt. Het weglaten ervan voorkomt interpretatiefouten.
- Valutacodes: De drieletterige ISO 4217-code (bijv.
USD,EUR,JPY) wordt toegevoegd aan de prijs.
Waarom Google, Facebook, Bing en Pinterest dit formaat vereisen
Bij het indienen van productfeeds bij Google Merchant Center, Facebook Catalog, Microsoft Bing Shopping of Pinterest Catalogs moeten valutawaarden deze formacerequirementen volgen om feedfouten te voorkomen. Deze platforms handhaven een uniforme standaard omdat:
- Voorkomt verkeerde gegevensinterpretatie: Sommige landen gebruiken komma's (
,) als decimaalteken en punten (.) voor duizendtallen (bijv.1.000,50in plaats van1,000.50). Zonder standaardisatie leidt dit tot onjuiste prijsinterpretatie. - Zorgt voor consistentie: Door hetzelfde decimaalformaat (
.) te vereisen, kunnen platforms prijswaarden nauwkeurig interpreteren, ongeacht regionale verschillen. - Verplichte feednaleving: Google, Facebook, Bing en Pinterest wijzen feeds af die niet voldoen aan hun vereiste opmaak. Zie de officiële documentatie voor elk platform: Google, Facebook, Bing, Pinterest.
Hoe Product Feed Pro deze opmaak afhandelt
Product Feed Pro en Product Feed Elite formatteren prijzen in uw XML-feeds automatisch om aan deze platformvereisten te voldoen. U hoeft niets te configureren. De plugin regelt dit standaard:
- Prijzen worden altijd geformatteerd met een punt (
.) als decimaal scheidingsteken. - Er worden geen scheidingstekens voor duizendtallen opgenomen om problemen met het parsen te voorkomen.
- De juiste drieletterige valutacode (bijv.
USD,GBP,EUR) wordt toegevoegd aan de prijswaarden, gelezen uit de valutainstelling van uw WooCommerce-winkel (get_woocommerce_currency()).
Bijvoorbeeld:
| Regionale opmaak (niet geaccepteerd door deze kanalen) | Vereist feedformaat |
|---|---|
| 1.234,56 EUR | 1234,56 EUR |
| 10.500,99 USD | 10.500,99 USD |
| 5.000,75 GBP | 5.000,75 GBP |
Opmerking: de regionale formaten in de linkerkolom zijn niet inherent fout. Ze zijn in veel landen perfect geldig. Ze worden simpelweg niet geaccepteerd door Google, Facebook, Bing en Pinterest, wier feedparsers het punt-decimale formaat vereisen dat aan de rechterkant wordt getoond.
Veelvoorkomende problemen en oplossingen
Als uw feed wordt afgewezen vanwege fouten in de valutaconversie, controleer dan op:
- Onjuiste decimaaltekens: gebruik
.in plaats van, - Gebruik van duizendtaltekens: verwijder ze volledig
- Ontbrekende valutacodes: zorg ervoor dat prijzen de juiste drieletterige code bevatten
Gebruik van regionale tekens in plaats van het vereiste formaat
Standaard handhaven Product Feed Pro en Product Feed Elite de juiste opmaak voor alle Google-, Facebook-, Bing- en Pinterest-feeds. Als uw winkel echter regionale nummeropmaak gebruikt (bijvoorbeeld een punt als duizendtal scheidingsteken en een komma als decimaalteken) en u wilt dat uw feeds dit weerspiegelen, kunt u de onderstaande PHP-snippets gebruiken om het standaardgedrag te overschrijven.
Let op: Dit is een aanpassing op ontwikkelaarsniveau. Er is geen ondersteuning beschikbaar voor problemen die voortvloeien uit het toepassen van deze snippets, dus ga alleen verder als u zich comfortabel voelt bij het bewerken van het functions.php-bestand van uw thema of het gebruik van een code-snippet-plugin zoals WPCode.
Zorg er eerst voor dat uw WooCommerce-valuta-opties overeenkomen met uw voorkeur. Ga naar WooCommerce → Instellingen → Algemeen en scrol naar de sectie Valuta-opties. Stel voor Europese regionale opmaak het duizendtal scheidingsteken in op een punt (.) en het decimaalteken op een komma (,).
Voeg vervolgens het volgende codefragment toe aan uw functions.php of via de WPCode-plugin. Dit dwingt al uw feeds en sjablonen om uw voorkeursseparators te gebruiken via het adt_product_feed_localize_price_args filter. Voor Europese regionale opmaak moet het codefragment 'decimal' => ',' en 'thousand' => '.' instellen:
Voeg vervolgens een of meer van de volgende codefragmenten toe om de vereiste opmaak voor specifieke platforms te verwijderen via het adt_pfp_localize_price_iso4217_feeds filter:
Een compleet codefragment om de vereiste opmaak alleen voor Google-feeds te verwijderen, bijvoorbeeld:
Vernieuw uw feeds na het toevoegen van de codefragmenten. De uitvoer zal uw voorkeuren voor regionale separators weerspiegelen:
Veelgestelde vragen
Past Product Feed Pro deze opmaak toe op alle feedtypen of alleen op Google, Facebook, Bing en Pinterest?
Deze opmaak wordt specifiek toegepast op feed-sjablonen voor Google, Facebook, Bing en Pinterest, aangezien deze platforms dit expliciet vereisen. Andere feedtypen volgen uw WooCommerce-valuta-instellingen, tenzij u aanvullende overrides configureert.
Mijn feed werd afgewezen vanwege een prijsformaatfout. Wat moet ik eerst controleren?
Controleer eerst of Product Feed Pro prijzen genereert met een punt als decimaalscheidingsteken, geen duizendscheidingsteken en een driecijferige valutacode (bijv. 1234.56 USD). Als de feed er correct uitziet, controleer dan of u geen regionale separator-codefragmenten hebt toegepast die de uitvoer kunnen overschrijven. Verifieer ook of uw WooCommerce-valuta-instellingen overeenkomen met uw beoogde uitvoer.
Heeft deze opmaak invloed op prijzen die op mijn website worden weergegeven?
Nee. Deze opmaak is alleen van toepassing op de XML-feeduitvoer die naar Google, Facebook, Bing en Pinterest wordt verzonden. Uw prijzen op de website worden weergegeven met uw WooCommerce-valuta-opmaakinstellingen.
Ik gebruik een valuta zonder decimalen (bijv. JPY). Hoe wordt dit afgehandeld?
Voor Google-, Facebook-, Bing- en Pinterest-feeds worden prijzen altijd opgemaakt met twee decimalen, ongeacht uw WooCommerce-decimaleninstellingen. Een Japanse Yen-prijs van 1500 wordt verzonden als 1500.00 JPY, niet als 1500 JPY. Dit wordt afgedwongen door de plugin om te voldoen aan de platformvereisten.
Ik heb de regionale separator-codefragmenten toegepast, maar mijn feed toont nog steeds het standaardformaat. Waarom?
Zorg ervoor dat u *beide* codefragmenten hebt toegevoegd: het eerste stelt uw voorkeursseparators in via adt_product_feed_localize_price_args (met 'decimal' => ',' en 'thousand' => '.' voor Europese opmaak), en het tweede verwijdert het specifieke platform uit de afdwinglijst via adt_pfp_localize_price_iso4217_feeds. Zorg er ook voor dat u de betreffende feed hebt vernieuwd na het opslaan van de codefragmenten, aangezien feeds in de cache worden opgeslagen en pas worden bijgewerkt wanneer ze opnieuw worden gegenereerd.
Kan ik regionale separators toepassen op slechts één platform en het standaardformaat voor de anderen behouden?
Ja. Het adt_pfp_localize_price_iso4217_feeds filter laat u individuele platforms (Google, Facebook, Bing of Pinterest) onafhankelijk uit de afdwingingslijst verwijderen. Neem eenvoudigweg alleen het snippet op voor het platform dat u wilt overschrijven en laat de andere weg.
Hoe vernieuw ik een feed na het aanbrengen van wijzigingen?
Ga naar Product Feed → Manage feeds, zoek de feed die u opnieuw wilt genereren en klik op Refresh Feed. Het feedbestand wordt opnieuw opgebouwd met behulp van de huidige plugin-instellingen en eventuele actieve snippets.
Heeft deze instelling invloed op zowel verkoopprijzen als reguliere prijzen op dezelfde manier?
Ja. De opmaak wordt consistent toegepast op alle prijsvelden die in de feed worden verzonden, inclusief reguliere prijzen, verkoopprijzen en eventuele aangepaste prijsattributen die in uw feedsjabloon zijn toegewezen.
Wat gebeurt er als WooCommerce is ingesteld om prijzen zonder decimalen weer te geven?
Voor Google-, Facebook-, Bing- en Pinterest-feeds geeft de plugin altijd prijzen met twee decimalen weer. Uw WooCommerce-decimalinstellingen worden niet toegepast op deze afgedwongen feeds. Een prijs van 1500 wordt bijvoorbeeld weergegeven als 1500.00 in de feed, ongeacht hoe WooCommerce is geconfigureerd om deze op uw website weer te geven.
Hulp & ondersteuning
Als u verdere hulp nodig heeft met het formatteren van valuta in uw productfeeds, kunt u gerust een ondersteuningsticket openen om contact op te nemen met het ondersteuningsteam.
Houd er rekening mee dat het ticketondersteuningssysteem exclusief is voor Product Feed Elite-gebruikers.
Als je alleen de Product Feed Pro plugin gebruikt, kun je gerust een nieuw onderwerp openen op het WordPress.org forum.
