Beim Erstellen von XML-Feeds für Google, Facebook, Bing und Pinterest müssen Währungswerte korrekt formatiert sein, um sicherzustellen, dass sie ohne Fehler verarbeitet werden. Diese Plattformen verlangen, dass Preise einen Punkt als Dezimaltrennzeichen, keine Tausendertrennzeichen und dreibuchstabige Währungscodes verwenden. Die Währungscodes werden von ISO 4217 definiert, während die Trennzeichenregeln aus der eigenen Feed-Spezifikation jeder Plattform stammen.
Die Übermittlung von Feeds, die diese Formatierungsanforderungen der Plattformen nicht erfüllen, führt zu Feed-Ablehnungen oder falschen Preisanalysen im Google Merchant Center, Facebook-Katalog, Microsoft Bing Shopping und Pinterest-Katalogen. Product Feed Pro und Product Feed Elite übernehmen diese Formatierung automatisch für all diese Plattformen.
Wenn Sie regionale Trennzeichen anstelle dieses Formats verwenden müssen, steht eine Workaround-Lösung auf Entwicklerebene mit PHP-Snippets zur Verfügung. Siehe den Abschnitt Regionale Trennzeichen verwenden unten. Beachten Sie, dass dieser Ansatz nicht unterstützt wird.
Voraussetzungen
- Product Feed Pro oder Product Feed Elite installiert und aktiv
- WooCommerce installiert und mit Ihrer Shop-Währung konfiguriert
- Mindestens ein Produktfeed konfiguriert für Google, Facebook, Bing oder Pinterest
Verständnis von ISO 4217 und Feed-Formatierungsregeln
ISO 4217 ist der internationale Standard für Währungscodes. Er definiert die dreibuchstabigen Codes, die zur Identifizierung von Währungen in Finanz- und Handelssystemen verwendet werden, wie z. B. USD für US-Dollar, EUR für Euro und JPY für japanischen Yen. Google, Facebook, Bing und Pinterest verlangen diese ISO 4217-Währungscodes bei der Übermittlung von Produktfeeds.
Die Regeln für Dezimal- und Tausendertrennzeichen sind nicht Teil von ISO 4217. Sie stammen aus der eigenen Feed-Spezifikation jeder Plattform, obwohl alle vier Plattformen die gleichen Anforderungen haben:
- Dezimaltrennzeichen: Ein Punkt (
.) muss für Dezimalwerte verwendet werden. - Tausendertrennzeichen: Nicht verwendet. Das Weglassen verhindert Parsing-Fehler.
- Währungscodes: Der dreibuchstabige ISO 4217-Code (z. B.
USD,EUR,JPY) wird an den Preiswert angehängt.
Warum Google, Facebook, Bing und Pinterest dieses Format benötigen
Bei der Übermittlung von Produktfeeds an Google Merchant Center, Facebook Catalog, Microsoft Bing Shopping oder Pinterest Catalogs müssen Währungswerte diesen Formatierungsregeln folgen, um Feed-Fehler zu vermeiden. Diese Plattformen erzwingen einen einheitlichen Standard, weil:
- Verhindert Datenfehlinterpretationen: Einige Länder verwenden Kommas (
,) als Dezimaltrennzeichen und Punkte (.) für Tausender (z. B.1.000,50statt1,000.50). Ohne Standardisierung führt dies zu einer falschen Preisanalyse. - Gewährleistet Konsistenz: Durch die Anforderung desselben Dezimalformats (
.) können Plattformen Preiswerte unabhängig von regionalen Unterschieden korrekt interpretieren. - Obligatorische Feed-Konformität: Google, Facebook, Bing und Pinterest lehnen Feeds ab, die nicht den erforderlichen Formatierungen entsprechen. Sehen Sie sich die offizielle Dokumentation für jede Plattform an: Google, Facebook, Bing, Pinterest.
Wie Product Feed Pro diese Formatierung handhabt
Product Feed Pro und Product Feed Elite formatieren Preise in Ihren XML-Feeds automatisch, um diese Plattformanforderungen zu erfüllen. Sie müssen nichts konfigurieren. Das Plugin handhabt dies standardmäßig:
- Preise werden immer mit einem Punkt (
.) als Dezimaltrennzeichen formatiert. - Keine Tausendertrennzeichen enthalten, um Parsing-Probleme zu vermeiden.
- Der korrekte dreistellige Währungscode (z. B.
USD,GBP,EUR) wird an die Preiswerte angehängt, gelesen aus Ihrer WooCommerce-Währungseinstellung (get_woocommerce_currency()).
Zum Beispiel:
| Regionales Format (nicht von diesen Kanälen akzeptiert) | Erforderliches Feed-Format |
|---|---|
| 1,234.56 EUR | 1.234,56 EUR |
| 10.500,99 USD | 10.500,99 USD |
| 5.000,75 GBP | 5.000,75 GBP |
Hinweis: Die regionalen Formate in der linken Spalte sind nicht grundsätzlich falsch. Sie sind in vielen Ländern vollkommen gültig. Sie werden einfach nicht von Google, Facebook, Bing und Pinterest akzeptiert, deren Feed-Parser das auf der rechten Seite gezeigte Punkt-Dezimalformat benötigen.
Häufige Probleme und Lösungen
Wenn Ihr Feed aufgrund von Währungsformatierungsfehlern abgelehnt wird, überprüfen Sie:
- Falsche Dezimaltrennzeichen: verwenden Sie
.anstelle von, - Verwendung von Tausendertrennzeichen: entfernen Sie diese vollständig
- Fehlende Währungscodes: stellen Sie sicher, dass Preise den richtigen dreistelligen Code enthalten
Verwendung regionaler Trennzeichen anstelle des erforderlichen Formats
Standardmäßig erzwingen Product Feed Pro und Product Feed Elite die korrekte Formatierung für alle Google-, Facebook-, Bing- und Pinterest-Feeds. Wenn Ihr Shop jedoch regionale Zahlenformate verwendet (z. B. einen Punkt als Tausendertrennzeichen und ein Komma als Dezimaltrennzeichen) und Sie möchten, dass Ihre Feeds dies widerspiegeln, können Sie die folgenden PHP-Snippets verwenden, um das Standardverhalten zu überschreiben.
Vorsicht: Dies ist eine Anpassung auf Entwicklerebene. Für Probleme, die bei der Anwendung dieser Snippets auftreten, wird kein Support angeboten. Fahren Sie daher nur fort, wenn Sie sich mit der Bearbeitung der functions.php-Datei Ihres Themes oder der Verwendung eines Code-Snippet-Plugins wie WPCode wohlfühlen.
Stellen Sie zunächst sicher, dass Ihre WooCommerce-Währungsoptionen Ihren Präferenzen entsprechen. Navigieren Sie zu WooCommerce → Einstellungen → Allgemein und scrollen Sie zum Abschnitt Währungsoptionen. Für europäische regionale Formatierungen setzen Sie das Tausendertrennzeichen auf einen Punkt (.) und das Dezimaltrennzeichen auf ein Komma (,).
Fügen Sie als Nächstes den folgenden Codeausschnitt zu Ihrer functions.php oder über das WPCode-Plugin hinzu. Dies erzwingt die Verwendung Ihrer bevorzugten Trennzeichen für alle Feeds und Vorlagen über den adt_product_feed_localize_price_args-Filter. Für die europäische regionale Formatierung muss der Codeausschnitt 'decimal' => ',' und 'thousand' => '.' festlegen:
Fügen Sie dann einen oder mehrere der folgenden Codeausschnitte hinzu, um die erforderliche Formatierung für bestimmte Plattformen über den adt_pfp_localize_price_iso4217_feeds-Filter zu entfernen:
Zum Beispiel ein vollständiger Codeausschnitt, um die erforderliche Formatierung nur für Google-Feeds zu entfernen:
Nachdem Sie die Codeausschnitte hinzugefügt haben, aktualisieren Sie Ihre Feeds. Die Ausgabe spiegelt Ihre regionalen Trennzeicheneinstellungen wider:
Häufig gestellte Fragen
Wendet Product Feed Pro diese Formatierung auf alle Feed-Typen an oder nur auf Google, Facebook, Bing und Pinterest?
Diese Formatierung wird speziell auf die Feed-Vorlagen für Google, Facebook, Bing und Pinterest angewendet, da diese Plattformen sie explizit verlangen. Andere Feed-Typen folgen Ihren WooCommerce-Währungseinstellungen, es sei denn, Sie konfigurieren zusätzliche Überschreibungen.
Mein Feed wurde wegen eines Preisformatfehlers abgelehnt. Was sollte ich zuerst überprüfen?
Bestätigen Sie zuerst, dass Product Feed Pro Preise mit einem Punkt als Dezimaltrennzeichen, ohne Tausendertrennzeichen und mit einem dreibuchstabigen Währungscode generiert (z. B. 1234.56 USD). Wenn der Feed korrekt aussieht, überprüfen Sie, ob Sie keine regionalen Trennzeichen-Codeausschnitte angewendet haben, die die Ausgabe überschreiben könnten. Überprüfen Sie auch, ob Ihre WooCommerce-Währungseinstellungen mit der gewünschten Ausgabe übereinstimmen.
Beeinflusst diese Formatierung die Preise, die auf meiner Website angezeigt werden?
Nein. Diese Formatierung gilt nur für die XML-Feed-Ausgabe, die an Google, Facebook, Bing und Pinterest gesendet wird. Ihre Website-Preise werden weiterhin mit Ihren WooCommerce-Währungsformatierungseinstellungen angezeigt.
Ich verwende eine Währung ohne Dezimalstellen (z. B. JPY). Wie wird damit umgegangen?
Für Google-, Facebook-, Bing- und Pinterest-Feeds werden Preise immer mit zwei Dezimalstellen formatiert, unabhängig von Ihren WooCommerce-Dezimalstelleneinstellungen. Ein japanischer Yen-Preis von 1500 wird als 1500.00 JPY übermittelt, nicht als 1500 JPY. Dies wird vom Plugin erzwungen, um die Plattformanforderungen zu erfüllen.
Ich habe die regionalen Trennzeichen-Codeausschnitte angewendet, aber mein Feed zeigt immer noch das Standardformat an. Warum?
Stellen Sie sicher, dass Sie *beide* Codeausschnitte hinzugefügt haben: Der erste legt Ihre bevorzugten Trennzeichen über adt_product_feed_localize_price_args fest (mit 'decimal' => ',' und 'thousand' => '.' für die europäische Formatierung), und der zweite entfernt die spezifische Plattform aus der Erzwingungsliste über adt_pfp_localize_price_iso4217_feeds. Stellen Sie außerdem sicher, dass Sie den betroffenen Feed nach dem Speichern der Codeausschnitte aktualisiert haben, da Feeds zwischengespeichert werden und erst nach der Neuerstellung aktualisiert werden.
Kann ich regionale Trennzeichen nur für eine Plattform anwenden und für die anderen das Standardformat beibehalten?
Ja. Der adt_pfp_localize_price_iso4217_feeds Filter ermöglicht es Ihnen, einzelne Plattformen (Google, Facebook, Bing oder Pinterest) unabhängig von der Erzwingungsliste zu entfernen. Fügen Sie einfach nur den Snippet für die Plattform ein, die Sie überschreiben möchten, und lassen Sie die anderen weg.
Wie aktualisiere ich einen Feed nach Änderungen?
Gehen Sie zu Product Feed → Manage feeds, suchen Sie den Feed, den Sie neu generieren möchten, und klicken Sie auf Refresh Feed. Die Feed-Datei wird mit den aktuellen Plugin-Einstellungen und allen aktiven Snippets neu erstellt.
Beeinflusst diese Einstellung Sale-Preise und reguläre Preise auf die gleiche Weise?
Ja. Die Formatierung wird konsistent auf alle Preis-Felder angewendet, die im Feed übermittelt werden, einschließlich regulärer Preise, Sale-Preise und aller benutzerdefinierten Preisattribute, die in Ihrer Feed-Vorlage zugeordnet sind.
Was passiert, wenn WooCommerce so eingestellt ist, dass Preise ohne Dezimalstellen angezeigt werden?
Für Google-, Facebook-, Bing- und Pinterest-Feeds gibt das Plugin Preise immer mit zwei Dezimalstellen aus. Ihre WooCommerce-Dezimalstelleneinstellungen werden nicht auf diese erzwungenen Feeds angewendet. Zum Beispiel wird ein Preis von 1500 als 1500.00 im Feed angezeigt, unabhängig davon, wie WooCommerce konfiguriert ist, um ihn in Ihrem Shop anzuzeigen.
Hilfe & Support
Wenn Sie weitere Unterstützung bei der Währungsformatierung in Ihren Produkt-Feeds benötigen, können Sie jederzeit ein Support-Ticket eröffnen, um das Support-Team zu kontaktieren.
Bitte beachten Sie, dass das Ticket-Supportsystem ausschließlich für Product Feed Elite-Benutzer bestimmt ist.
Wenn Sie nur das Product Feed Pro-Plugin verwenden, können Sie gerne ein neues Thema eröffnen im WordPress.org-Forum.
