Waarom ISO 4217 wordt gebruikt voor Google, Facebook, Bing, Pinterest en TikTok in XML-feeds

Bij het genereren van XML-feeds voor Google, Facebook, Bing, Pinterest en TikTok moeten valutawaarden correct worden opgemaakt om ervoor te zorgen dat ze zonder fouten worden verwerkt. Deze platforms vereisen dat prijzen een punt als decimaalscheidingsteken gebruiken, geen duizendscheidingspunten en valutacodes van drie letters. De valutacodes worden gedefinieerd door ISO 4217, terwijl de scheidingsregels afkomstig zijn van de eigen feedspecificatie van elk platform.

Het indienen van feeds die niet voldoen aan deze opmaakvereisten van het platform, resulteert in afwijzing van de feed of onjuiste prijsinterpretatie in Google Merchant Center, Facebook Catalog, Microsoft Bing Shopping, Pinterest Catalogs en TikTok Product Catalog. 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.

ISO 4217-handhaving voor TikTok vereist Product Feed Pro 13.5.7 of hoger. In eerdere versies konden TikTok Product Catalog-feeds prijzen uitvoeren met het decimaalteken van het locale van uw winkel in plaats van het vereiste punt, wat de catalogusparser van TikTok kon afwijzen. Werk bij naar 13.5.7+ als uw TikTok-feed hierdoor wordt beïnvloed. Zie Hoe stel ik een TikTok-catalogusfeed in voor hulp bij het instellen van een TikTok-feed.

Vereisten

Inzicht in ISO 4217 en feedformacerequirementen

ISO 4217 is de internationale standaard voor valutacodes. Het definieert de codes van drie letters 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, Pinterest en TikTok vereisen allemaal deze ISO 4217-valutacodes bij het indienen van productfeeds.

De regels voor het decimaal- en duizendscheidingspunt maken geen deel uit van ISO 4217. Ze komen uit de eigen feedspecificatie van elk platform, hoewel alle vijf de platforms overeenkomen met dezelfde vereisten:

• 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, Pinterest en TikTok dit formaat vereisen

Bij het indienen van productfeeds bij Google Merchant Center, Facebook Catalog, Microsoft Bing Shopping, Pinterest Catalogs of TikTok Product Catalog moeten valutawaarden voldoen aan deze opmaakregels om feedfouten te voorkomen. Deze platforms handhaven een uniforme standaard omdat:

1. Voorkomt verkeerde gegevensinterpretatie: Sommige landen gebruiken komma's (,) als decimaalteken en punten (.) voor duizendtallen (bijv. 1.000,50 in plaats van 1,000.50). Zonder standaardisatie leidt dit tot onjuiste prijsinterpretatie.
2. Zorgt voor consistentie: Door hetzelfde decimaalformaat (.) te vereisen, kunnen platforms prijswaarden nauwkeurig interpreteren, ongeacht regionale verschillen.
3. Verplichte naleving van de feed: Google, Facebook, Bing, Pinterest en TikTok wijzen feeds af die niet voldoen aan hun vereiste opmaak. Zie de officiële documentatie voor elk platform: Google, Facebook, Bing, Pinterest, TikTok.

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:

De regionale formaten in de linkerkolom zijn niet inherent verkeerd. Ze zijn in veel landen volkomen geldig. Ze worden simpelweg niet geaccepteerd door Google, Facebook, Bing, Pinterest en TikTok, wiens feed parsers het punt-decimale formaat vereisen dat aan de rechterkant wordt weergegeven.

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-, Pinterest- en TikTok-feeds. Als uw winkel echter regionale nummeropmaak gebruikt (bijvoorbeeld een punt als duizendseparator en een komma als decimaalscheidingsteken) en u wilt dat uw feeds dit weerspiegelen, kunt u de onderstaande PHP-snippets gebruiken om het standaardgedrag te overschrijven.

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 de functions.php 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 de volgende snippet 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 de snippet 'decimal_separator' => ',' en 'thousand_separator' => '.' instellen:

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

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:

// 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';
    });
});

Een compleet codefragment om de vereiste opmaak alleen voor Google-feeds te verwijderen, bijvoorbeeld:

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;
    });
});

Vernieuw uw feeds na het toevoegen van de codefragmenten. De uitvoer zal uw voorkeuren voor regionale separators weerspiegelen:

Veelgestelde vragen

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.