Warum ISO 4217 für Google, Facebook, Bing, Pinterest und TikTok in XML-Feeds verwendet wird

Beim Erstellen von XML-Feeds für Google, Facebook, Bing, Pinterest und TikTok 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 sind durch 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 abgelehnten Feeds oder falscher Preisinterpretation im Google Merchant Center, Facebook-Katalog, Microsoft Bing Shopping, Pinterest-Kataloge und TikTok-Produktkatalog. 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.

Die Durchsetzung von ISO 4217 für TikTok erfordert Product Feed Pro 13.5.7 oder neuer. In früheren Versionen konnten TikTok-Produktkatalog-Feeds Preise mit dem lokal formatierten Dezimaltrennzeichen Ihres Shops anstelle des erforderlichen Punkts ausgeben, was vom TikTok-Katalog-Parser abgelehnt werden konnte. Aktualisieren Sie auf 13.5.7+, wenn Ihr TikTok-Feed betroffen ist. Hilfe beim Einrichten eines TikTok-Feeds finden Sie unter Einrichten eines TikTok-Katalog-Feeds.

Voraussetzungen

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, Pinterest und TikTok 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 jeweiligen Feed-Spezifikation jeder Plattform, obwohl alle fünf 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, Pinterest und TikTok dieses Format benötigen

Bei der Übermittlung von Produktfeeds an das Google Merchant Center, den Facebook-Katalog, Microsoft Bing Shopping, Pinterest-Kataloge oder den TikTok-Produktkatalog müssen Währungswerte diesen Formatierungsregeln folgen, um Feed-Fehler zu vermeiden. Diese Plattformen erzwingen einen einheitlichen Standard, weil:

1. Verhindert Datenfehlinterpretationen: Einige Länder verwenden Kommas (,) als Dezimaltrennzeichen und Punkte (.) für Tausender (z. B. 1.000,50 statt 1,000.50). Ohne Standardisierung führt dies zu einer falschen Preisanalyse.
2. Gewährleistet Konsistenz: Durch die Anforderung desselben Dezimalformats (.) können Plattformen Preiswerte unabhängig von regionalen Unterschieden korrekt interpretieren.
3. Zwingende Feed-Konformität: Google, Facebook, Bing, Pinterest und TikTok lehnen Feeds ab, die nicht deren Formatierungsanforderungen entsprechen. Sehen Sie sich die offizielle Dokumentation für jede Plattform an: Google, Facebook, Bing, Pinterest, TikTok.

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:

Die regionalen Formate in der linken Spalte sind nicht grundsätzlich falsch. Sie sind in vielen Ländern völlig gültig. Sie werden einfach nicht von Google, Facebook, Bing, Pinterest und TikTok akzeptiert, deren Feed-Parser das auf der rechten Seite gezeigte Punkt-Dezimalformat erfordern.

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-, Pinterest- und TikTok-Feeds. Wenn Ihr Shop jedoch regionale Zahlenformate verwendet (z. B. einen Punkt als Tausendertrennzeichen und ein Komma als Dezimaltrennzeichen) und Ihre Feeds dies widerspiegeln sollen, können Sie die unten stehenden PHP-Snippets verwenden, um das Standardverhalten zu überschreiben.

Dies ist eine Anpassung für Entwickler. Für Probleme, die sich aus der Anwendung dieser Snippets ergeben, 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 Snippet zu Ihrer functions.php oder über das WPCode-Plugin hinzu. Dies erzwingt die Verwendung Ihrer bevorzugten Trennzeichen für alle Ihre Feeds und Vorlagen über den Filter adt_product_feed_localize_price_args. Für die europäische regionale Formatierung muss der Snippet 'decimal_separator' => ',' und 'thousand_separator' => '.' festlegen:

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

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:

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

Zum Beispiel ein vollständiger Codeausschnitt, um die erforderliche Formatierung nur für Google-Feeds zu entfernen:

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

Nachdem Sie die Codeausschnitte hinzugefügt haben, aktualisieren Sie Ihre Feeds. Die Ausgabe spiegelt Ihre regionalen Trennzeicheneinstellungen wider:

Häufig gestellte Fragen

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.