Por qué se utiliza ISO 4217 para Google, Facebook, Bing, Pinterest y TikTok en los feeds XML

Al generar feeds XML para Google, Facebook, Bing, Pinterest y TikTok, los valores de moneda deben formatearse correctamente para garantizar que se procesen sin errores. Estas plataformas requieren que los precios utilicen un punto como separador decimal, sin separadores de miles y códigos de moneda de tres letras. Los códigos de moneda están definidos por ISO 4217, mientras que las reglas de separadores provienen de la especificación de feed de cada plataforma.

La presentación de feeds que no cumplen con estos requisitos de formato de plataforma dará lugar a rechazos de feed o a un análisis incorrecto de los precios en Google Merchant Center, Facebook Catalog, Microsoft Bing Shopping, Pinterest Catalogs y TikTok Product Catalog. Product Feed Pro y Product Feed Elite manejan este formato automáticamente para todas estas plataformas.

Si necesita utilizar separadores regionales en lugar de este formato, hay una solución alternativa a nivel de desarrollador utilizando fragmentos de PHP disponible. Consulte la sección Uso de separadores regionales a continuación. Tenga en cuenta que este enfoque no está soportado.

La aplicación de ISO 4217 para TikTok requiere Product Feed Pro 13.5.7 o posterior. En versiones anteriores, los feeds de TikTok Product Catalog podían mostrar precios utilizando el separador decimal con formato de configuración regional de tu tienda en lugar del punto requerido, lo que el analizador del catálogo de TikTok podía rechazar. Actualiza a la versión 13.5.7 o superior si tu feed de TikTok se ve afectado. Para obtener ayuda con la configuración de un feed de TikTok, consulta Cómo configurar un feed de catálogo de TikTok.

Requisitos

Comprensión de ISO 4217 y las reglas de formato de feed

ISO 4217 es el estándar internacional para códigos de moneda. Define los códigos de tres letras utilizados para identificar monedas en sistemas financieros y comerciales, como USD para Dólar estadounidense, EUR para Euro y JPY para Yen japonés. Google, Facebook, Bing, Pinterest y TikTok requieren estos códigos de moneda ISO 4217 en las presentaciones de los feeds de productos.

Las reglas de separadores decimales y de miles no forman parte de ISO 4217. Provienen de la especificación de feed de cada plataforma, aunque las cinco plataformas coinciden en los mismos requisitos:

• Separador decimal: Se debe utilizar un punto (.) para los valores decimales.
• Separadores de miles: No se utilizan. Omitirlos evita errores de análisis.
• Códigos de moneda: El código de tres letras ISO 4217 (por ejemplo, USD, EUR, JPY) se anexa al valor del precio.

Por qué Google, Facebook, Bing, Pinterest y TikTok requieren este formato

Al enviar feeds de productos a Google Merchant Center, Facebook Catalog, Microsoft Bing Shopping, Pinterest Catalogs o TikTok Product Catalog, los valores de moneda deben seguir estas reglas de formato para evitar errores en el feed. Estas plataformas aplican un estándar uniforme porque:

1. Evita la mala interpretación de datos: Algunos países utilizan comas (,) como separadores decimales y puntos (.) para los miles (por ejemplo, 1.000,50 en lugar de 1,000.50). Sin estandarización, esto conduce a un análisis incorrecto de los precios.
2. Garantiza la coherencia: Al exigir el mismo formato decimal (.), las plataformas pueden interpretar con precisión los valores de los precios independientemente de las diferencias regionales.
3. Cumplimiento obligatorio del feed: Google, Facebook, Bing, Pinterest y TikTok rechazan los feeds que no cumplen con su formato requerido. Consulte la documentación oficial de cada plataforma: Google, Facebook, Bing, Pinterest, TikTok.

Cómo Product Feed Pro maneja este formato

Product Feed Pro y Product Feed Elite formatean automáticamente los precios en sus feeds XML para cumplir con los requisitos de estas plataformas. No necesita configurar nada. El plugin lo maneja por defecto:

• Los precios siempre se formatean utilizando un punto (.) como separador decimal.
• No se incluyen separadores de miles para evitar problemas de análisis.
• Se añade el código de divisa de tres letras correcto (p. ej., USD, GBP, EUR) a los valores de los precios, leído de la configuración de divisa de su tienda WooCommerce (get_woocommerce_currency()).

Por ejemplo:

Los formatos regionales de la columna izquierda no son intrínsecamente incorrectos. Son perfectamente válidos en muchos países. Simplemente no son aceptados por Google, Facebook, Bing, Pinterest y TikTok, cuyos analizadores de feeds requieren el formato de punto decimal que se muestra a la derecha.

Problemas comunes y soluciones

Si tu feed es rechazado debido a errores de formato de moneda, comprueba:

• Separadores decimales incorrectos: use . en lugar de ,
• Uso de separadores de miles: elimínelos por completo
• Códigos de divisa faltantes: asegúrese de que los precios incluyan el código de tres letras adecuado

Uso de separadores regionales en lugar del formato requerido

Por defecto, Product Feed Pro y Product Feed Elite aplican el formato correcto para todos los feeds de Google, Facebook, Bing, Pinterest y TikTok. Sin embargo, si tu tienda utiliza formato numérico regional (por ejemplo, un punto como separador de miles y una coma como separador decimal) y necesitas que tus feeds lo reflejen, puedes usar los fragmentos de PHP a continuación para anular el comportamiento predeterminado.

Esta es una personalización a nivel de desarrollador. No se ofrece soporte para problemas que surjan al aplicar estos fragmentos, así que procede solo si te sientes cómodo editando el archivo functions.php de tu tema o utilizando un plugin de fragmentos de código como WPCode.

Primero, asegúrese de que las opciones de divisa de WooCommerce coincidan con sus preferencias. Navegue a WooCommerce → Ajustes → General y desplácese hasta la sección Opciones de divisa. Para el formato regional europeo, establezca el separador de miles en un punto (.) y el separador decimal en una coma (,).

A continuación, añade el siguiente fragmento a tu archivo functions.php o a través del plugin WPCode. Esto fuerza a que todos tus feeds y plantillas utilicen tus separadores preferidos a través del filtro adt_product_feed_localize_price_args. Para el formato regional europeo, el fragmento debe establecer 'decimal_separator' => ',' y 'thousand_separator' => '.':

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

A continuación, agregue uno o más de los siguientes fragmentos para eliminar el formato requerido para plataformas específicas a través del filtro adt_pfp_localize_price_iso4217_feeds:

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

Por ejemplo, un fragmento completo para eliminar el formato requerido solo para los feeds de Google:

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

Después de agregar los fragmentos, actualice sus feeds. La salida reflejará sus preferencias de separadores regionales:

Preguntas frecuentes

Ayuda y soporte

Si necesitas más ayuda con el formato de moneda en tus feeds de productos, no dudes en abrir un ticket de soporte para contactar con el equipo de soporte.

Ten en cuenta que el sistema de soporte por tickets es exclusivo para usuarios de Product Feed Elite.

Si solo está utilizando el plugin Product Feed Pro, no dude en abrir un nuevo tema en el foro de WordPress.org.