Loading
Primeros pasos con B2C Commerce
Referencia del campo del feed de productos para Google

Referencia del campo del feed de productos para Google

Información de referencia para los campos del feed de productos usados con Google, incluyendo campos requeridos, campos opcionales y sus asignaciones predeterminadas a atributos B2C Commerce.

Cómo funcionan los mapeos por defecto

El feed de productos de Google utiliza un sistema de mapeo basado en datos para transformar los datos de productos de B2C Commerce al formato requerido por Google. Cuando B2C Commerce puede derivar un valor usando atributos estándar de B2C Commerce, crea un mapeo predeterminado que especifica cómo se obtiene el valor:

  • Mapeos de campo: Mapea directamente a un solo atributo de producto de B2C Commerce, como nombre, marca o precio.
  • Mapeos derivados: Calcula valores de múltiples atributos o aplica transformaciones, como eliminar HTML de descripciones o formatear precios con códigos de moneda.
  • Mapeos constantes: Usa un valor fijo para todos los productos.
  • Mapeos de respaldo: Mapea primero al atributo primario, luego regresa a una alternativa si el atributo primario está vacío para ese producto. Por ejemplo, el título usa nombre, volviendo a masterProductName si el nombre está en blanco.

Puedes personalizar campos marcados como Sobrescribibles: Sí, en Business Manager. Campos marcados como Anulables: No son gestionados por el sistema y visibles en la tabla de Mapeo de Campos, pero no puedes cambiar su mapeo.

Formateo automático de campos

B2C Commerce aplica formato automático a los valores de campos antes de que se escriban en el feed. Este formato ocurre sin importar si mantienes el mapeo predeterminado o lo sobrescribes con un atributo diferente. Cuando anulas un mapeo predeterminado, no necesitas adaptar los datos de tu catálogo para que coincidan con el formato de Google—B2C Commerce se encarga de la transformación.

El formato aplica de la siguiente manera:

  • Fechas: Los valores de fecha y fecha y hora están formateados a ISO 8601. Las fechas inválidas se omiten del feed.
  • Booleanos: Los valores se convierten en verdadero o falso.
  • Números: Los valores numéricos se formatean con la precisión requerida (por ejemplo, enteros sin decimales, o dos decimales para los precios). Los valores inválidos o nulos se omiten.
  • Precios: Los valores positivos se formatean con dos decimales y se concatenan con el código de moneda.
  • Descripciones: Las etiquetas HTML se eliminan del texto.
  • Enums: Valores como disponibilidad y age_group se validan contra valores permitidos predefinidos.

Herencia personalizada de atributos para variantes

Cuando asignas un atributo personalizado a un campo de Google, B2C Commerce resuelve automáticamente los valores de atributos para productos variantes usando la siguiente cadena de herencia:

  1. Producto variante: B2C Commerce primero verifica el valor del atributo del producto variante.
  2. Grupo de variaciones: Si la variante no tiene el valor del atributo, B2C Commerce revisa el grupo de variaciones (si aplica).
  3. Producto maestro: Si el grupo de variaciones no tiene el valor, B2C Commerce revisa el producto maestro.

Esta cadena de herencia asegura que los atributos personalizados definidos a nivel maestro o grupo de variaciones sean heredados automáticamente por variantes sin requerir la entrada de datos duplicada.

Elegibilidad del Producto

Dos capas controlan qué productos aparecen en el feed:

  • Reglas de filtro de producto: Configurable incluye y excluye reglas que determinan qué productos se envían a Google. Por defecto, las reglas coinciden con productos que están en línea y se pueden buscar, pero puedes ajustarlas. Consulta las reglas de filtro de producto para el feed de productos.
  • Exclusiones automáticas: Independientemente de tus reglas de filtro, B2C Commerce siempre excluye lo siguiente del feed:
    • Productos maestros (en su lugar se exportan variantes)
    • Grupos de variaciones (en su lugar se exportan variantes)
    • Sets de productos. Los paquetes, que tienen componentes fijos, son soportados y se envían a Google como productos independientes.

Después de que un producto se incluye en el feed, puedes controlar aún más dónde aparece en Google mapeando los campos included_destination, excluded_destination y pausa. Por ejemplo, usa excluded_destination para mantener un producto fuera de los anuncios de Shopping mientras lo envias a listados gratuitos. Consulta la tabla de Campos Opcionales.

Derivación del precio de lista

El campo de precio se corresponde con el precio regular (de lista) de un producto. B2C Commerce no tiene un concepto de "precio de lista" incorporado; Los equipos de tiendas implementan precios por lista usando diferentes estrategias de libros de precios. Para acomodar esta variedad, B2C Commerce deduce el precio de lista del alimento en dos pasos:

  1. Libro de precios de lista seleccionado. Si seleccionas una libreta de precios en Libro de Precios de Lista en la pestaña de Configuración General, B2C Commerce usa el precio de esa libreta. El desplegable contiene solo libros de precios activos y que contienen precios en la moneda de alimentación. Si después desactivas el libro de precios seleccionado, reconfigura el libro de precios de lista para que apunte a otro libro de precios diferente.
  2. Camino del libro de precios en oferta. Si no seleccionas un libro de precios de lista, B2C Commerce obtiene el precio de lista del libro de precios de venta que el motor de precios B2C Commerce selecciona para el producto. El motor de precios evalúa todos los libros de precios aplicables para el producto, no solo los activos, y devuelve el mejor (más bajo) precio junto con su libro de precios fuente. De ese libro de precios de oferta, B2C Commerce aplica una de dos reglas:
    • Si el libro de precios de venta tiene un libro de precios padre, B2C Commerce recorre la cadena madre hasta la raíz y regresa el precio del libro raíz. Esto coincide con el comportamiento predeterminado de las tiendas de SFRA y SiteGenesis.
    • Si el libro de precio de venta no tiene un libro principal, B2C Commerce devuelve el precio máximo en todos los libros de precios aplicables para el producto. Esto coincide con el comportamiento predeterminado de las tiendas PWA Kit.
Nota
Nota Si el precio de lista resuelto es igual al precio de oferta, B2C Commerce solo llena el campo de precios y omite sale_price en la entrada de alimentación de ese producto. Esto evita mostrar un precio de strike en Google para productos que no están en oferta.

Configurar el libro de precios de lista en la pestaña de Configuración General es la forma más confiable de asegurar que el precio de lista en tu feed coincida con lo que los compradores ven en tu tienda, especialmente para locales con lógica de precios personalizada, precios por zonas o libros de precios multimoneda.

Derivación del precio de venta

El campo sale_price se asigna al atributo B2C Commerce salePrice más la moneda configurada. El valor del precio de venta no se toma de un solo libro de precios: el motor de precios B2C Commerce selecciona el mejor (el más bajo) precio entre todos los libros de precios aplicables para el producto, sin importar la jerarquía del libro de precios o si existe una jerarquía configurada.

Como el mismo motor muestra el precio que muestra tu tienda, el valor sale_price enviado a Google coincide con lo que ven los compradores en tu sitio.

Si el precio de venta resuelto es igual al precio de lista resuelto (el campo de precio ), B2C Commerce omite sale_price en la entrada de alimentación de ese producto. Esto evita mostrar un precio de strike en Google para productos que no están en oferta. Ver Derivación de Precio de Lista.

Si tu tienda utiliza lógica de precios personalizada—como selección de libros de precios basada en zonas o geogeográfica—el cálculo predeterminado del precio de venta puede no coincidir con lo que ven los compradores. Configurar la Lista de Precios en la pestaña de Configuración General es la forma más confiable de alinear el feed con tu tienda en estos casos.

Campos obligatorios

Los siguientes campos son requeridos para una entrada válida de alimentación de producto. Los productos que carecen de campos requeridos aún se incluyen en el feed, pero Google puede rechazar esas filas individuales. Usa la Vista previa del Feed del Producto para identificar productos con campos requeridos faltantes y corregirlos antes de activar la sincronización diaria del feed. Consulta la vista previa del feed del producto.

Advertencia
Advertencia Si más del 30% de tus productos carecen de campos requeridos, Google puede rechazar todo el feed. Asegúrate de que los datos de tu catálogo estén completos antes de activar la sincronización del feed diario.
Google Field Tipo Mapeo SFCC predeterminado Descripción Anulable
identificación string id (ID del producto) Identificador único de producto (SKU). Gestionado por B2C Commerce. Manténganse estables a través de las actualizaciones del feed. No
Título string name, vuelve a masterProductName si está en blanco Título del producto. Evita el texto promocional. Sí
description string longDescription, vuelve a shortDescription (HTML eliminado) si está en blanco Descripción completa del producto. Las etiquetas HTML se eliminan automáticamente. Sí
enlace string productUrl (generado) URL de la página de detalles del producto. Generado usando el nombre de host de la configuración de Einstein. Para el PWA Kit y las tiendas sin cabeza, configura los patrones de URL por separado. Consulta Configurar patrones de URL para el feed de productos. Sí
image_link string Tipo de vista de imagen seleccionada, o búsqueda predeterminada por tipo de vista URL de la imagen principal del producto. Si seleccionas un tipo de vista en Tipo de vista de imagen en la pestaña de Configuración General, B2C Commerce usa ese tipo de vista. De lo contrario, B2C Commerce intenta el tipo de vista "grande" y regresa al primer tipo de vista disponible. Debido a que el respaldo puede seleccionar un tipo de vista inadecuado (como una vista de mostra), Salesforce recomienda seleccionar un tipo de vista específico. Usa imágenes de alta resolución sin superposiciones promocionales. Sí
Disponibilidad string Disponibilidad (derivada) Estado de las acciones. Valores derivados al mapear los niveles de inventario de B2C Commerce con los valores de disponibilidad de Google: in_stock, out_of_stock, preventa, pedido pendiente. Gestionado por el sistema. No
precio número Combina precio y moneda (Libro de Precio de Lista Seleccionado, o vía de venta-precio-libro) Precio regular (lista) del producto con código de moneda, como "15.00 USD". Si seleccionas una libreta de precios en Libro de Precios de Lista en la pestaña de Configuración General, B2C Commerce usa esa libreta de precios. De lo contrario, B2C Commerce obtiene el precio de lista del libro de precios de venta seleccionado por el motor de precios B2C Commerce. Ver Derivación de Precio de Lista. Solo se incluyen valores positivos. Sí

Campos Opcionales

Los siguientes campos son opcionales y pueden mejorar tus listados de productos en Google. Los campos opcionales se omiten del feed cuando el atributo asignado o valor constante está en blanco. Los campos con un mapeo predeterminado obtienen su valor automáticamente; Los campos sin un mapeo predeterminado (mostrados como "(ninguno)") se llenan solo cuando mapeas un atributo o estableces un valor o patrón constante.

Google Field Tipo Mapeo SFCC predeterminado Descripción Anulable
sale_price número Combina el precio de venta y la moneda si un precio de venta está activo Precio con descuento con código de cambio, como "10.00 USD". B2C Commerce omite este campo cuando el precio de venta resuelto es igual al precio resuelto. Ver Derivación de Precio de Venta. Sí
sale_price_effective_date date Combina la ofertaPrecioInicio y PrecioFin Rango de fecha de venta en formato ISO 8601, como "2016-02-24T11:07+0100/2016-02-29T23:07+0100". Sí
availability_date date inStockDate La fecha en que un producto de preventa se vuelve disponible, como "2016-02-24T11:07+0100". Sí
expiration_date date onlineTo La fecha en que el producto debería dejar de aparecer en los feeds, como "2016-07-11T11:07+0100". Sí
Marca string Marca Nombre de la marca. Sí
gtin string ean, vuelve a UPC si EAN no está disponible Número Global de Artículo Comercial (UPC/EAN). Mejora el emparejamiento de productos. Sí
mpn string mpn Número de pieza del fabricante. Sí
identifier_exists boolean Calculado a partir de si el producto tiene identificadores estándar (EAN, UPC, MPN o marca) Indica si el producto tiene identificadores estándar. Sí
is_bundle boolean Se evalúa a verdadero cuando se llena bundleProductIds Indica si el producto es un paquete. Gestionado por B2C Commerce. No
item_group_id string masterProductId Agrupa variantes de producto que comparten el mismo producto maestro, como "AB12345". Sí
product_type string categoríaCamino (camino completo) Categoría de producto definida por comerciantes, como "Home > > Women Dresses > Maxi Dresses". Sí
google_product_category string (ninguno) Categoría de producto definida por Google, como "Accesorios > de Ropa & Ropa > Abrigos > & Abrigos Chaquetas". Sí
additional_image_link string adicionalalImageLink URLs de imágenes adicionales para una presentación más completa. Sí
lifestyle_image_link string (ninguno) URL de imagen de estilo de vida. Sí
mobile_link string (ninguno) URL de página de aterrizaje optimizada para móviles. Sí
virtual_model_link string (ninguno) URL del modelo virtual (3D) del activo. Sí
ads_redirect string (ninguno) URL usada para redirigir el tráfico de anuncios, como uno que incluye parámetros de rastreo. Sí
color string (ninguno) Color del producto. Sí
Material string (ninguno) Materiales principales del producto, como el "cuero". Sí
pattern string (ninguno) Patrón de producto, como "lunares". Sí
tamaño string (ninguno) Tamaño de producto, como "XL". Sí
size_system string (ninguno) Sistema de tamaño, como "US". Sí
size_type string (ninguno) Tipo de tamaño, como "regular". Sí
Género string (ninguno) Público de género al que va dirigido, como "masculino", "femenino" o "unisex". Sí
age_group string (ninguno) Grupo de edad objetivo. Valores: recién nacido, bebé, niño pequeño, niños, adulto. Sí
Adulto boolean (ninguno) Indica si el producto está orientado a adultos. Sí
condición string (ninguno) Condición del producto, como "nuevo", "usado" o "reacondicionado". Sí
Multipack número (ninguno) Número de productos idénticos en un multipack definido por el comerciante. Sí
product_highlight string (ninguno) Un producto clave destacado, como "Soporta miles de aplicaciones". Sí
short_title string (ninguno) Un título corto usado en posiciones restringidas, como "Polo Shirt". Sí
structured_title string (ninguno) Título estructurado, incluyendo el origen del título, para contenido generado por IA. Sí
structured_description string (ninguno) Descripción estructurada, incluyendo el origen de la descripción, para contenido generado por IA. Sí
custom_label_0–custom_label_4 string (ninguno) Etiquetas personalizadas usadas para segmentar productos para reportes y pujas, como "Estacional", "Compensación" o "BestSeller". Sí
product_length, product_width, product_height número (ninguno) Dimensiones del producto con unidad, como "20 in". Sí
product_weight número (ninguno) Peso del producto con unidad, como "3.5 lb". Sí
unit_pricing_measure string Combina unidadCantidad y unidadMedida Medir y dimensionar el producto tal como se vende, como "1.5 kg". Sí
unit_pricing_base_measure string (ninguno) La medida base del producto para el precio, como "100g". Sí
energy_efficiency_class string (ninguno) Clase de eficiencia energética, como "A+". Sí
min_energy_efficiency_class string (ninguno) La clase de eficiencia energética más baja en la etiqueta del producto, como "A+++". Sí
max_energy_efficiency_class string (ninguno) La clase de eficiencia energética más alta en la etiqueta del producto, como "D". Sí
Certificación string (ninguno) Certificación de productos, como "EC:EPREL:123456". Sí
consumer_notice string (ninguno) Un aviso al consumidor, como una advertencia de la Proposición 65. Sí
cost_of_goods_sold número (ninguno) Costo de los bienes vendidos con código de moneda, como "8.00 USD". Sí
auto_pricing_min_price número (ninguno) Precio mínimo para descuentos automatizados, como "15.00 USD". Sí
maximum_retail_price número (ninguno) Precio máximo al público (usado en algunas regiones, como India), como "15.00 INR". Sí
Entrega string (ninguno) Detalles de pagos a plazos, como "6:30 EUR:199 EUR". Sí
subscription_cost string (ninguno) Detalles del costo de suscripción, como "mes:12:35.00USD". Sí
loyalty_program string (ninguno) Beneficios del programa de lealtad, como "my_loyalty_program:plata:10 USD::10::free_member_shipping". Sí
promotion_id string (ninguno) Identificador de promoción, como "ABC123". Sí
Transporte marítimo string (ninguno) Detalles de costos de envío, como "US:CA: Overnight: 16.00 USD". Sí
free_shipping_threshold string (ninguno) Valor mínimo de pedido para envío gratuito, como "US:16.00 USD". Sí
carrier_shipping string (ninguno) Envío calculado por el transportista, como "US:80302:USPS_MEDIA_MAIL:1:3:2:5". Sí
shipping_label string (ninguno) Etiqueta usada para asignar reglas de envío, como "perecedero". Sí
shipping_length, shipping_width, shipping_height número (ninguno) Dimensiones del paquete usadas para calcular el envío, como "22 in". Sí
shipping_weight número (ninguno) Peso del paquete usado para calcular el envío, como "3 kg". Sí
min_handling_time número (ninguno) Tiempo mínimo de manejo del producto, como "1". Sí
max_handling_time número (ninguno) Tiempo máximo de manejo del producto, como "3". Sí
shipping_handling_business_days string (ninguno) Días hábiles en los que se manejan los pedidos, como "US:Lun-Sábado". Sí
shipping_transit_business_days string (ninguno) Días hábiles en los que los pedidos están en tránsito, como "US:Lun-Sábado". Sí
ships_from_country string (ninguno) País desde donde se envía el producto. Utiliza el código de país ISO 3166 de 2 letras, como "US". Sí
return_policy_label string (ninguno) Etiqueta usada para asignar una política de devoluciones, como "90 días". Sí
included_destination string (ninguno) Destinos donde debe incluirse el producto, como "Shopping_ads". Sí
excluded_destination string (ninguno) Destinos donde el producto debe ser excluido, como "Shopping_ads". Sí
shopping_ads_excluded_country string (ninguno) Países excluidos de los anuncios de Shopping, como "DE". Sí
pausa string (ninguno) Pausa el artículo en un destino, como "ads". Sí
native_commerce boolean (ninguno) Indica si el producto es elegible para el comercio nativo, es decir, experiencias de compra que ocurren directamente dentro de las superficies de Google en lugar de en tu tienda. Establece este booleano por producto para controlar la elegibilidad. Este campo no tiene mapeo predeterminado, así que los productos no se marcan como elegibles a menos que los mapees. Sí
external_seller_id string (ninguno) Identificador de vendedor para cuentas con múltiples vendedores, como "SellerPublicName1991". Sí
merchant_item_id string (ninguno) Identificador de artículo de pago proporcionado por el comerciante, como "some_checkout_item_id_1". Sí

Campos Opcionales Adicionales (Detalle del Producto)

Usa la sección de Campos Opcionales Adicionales de la tabla de Mapeo de Campos para enviar especificaciones técnicas u otros atributos al campo product_detail de Google. Para cada entrada, mapea un atributo de Comercio B2C y, opcionalmente, proporciona un nombre de sección para los detalles relacionados con el grupo. Haz clic en Agregar Atributo para agregar otro detalle del producto.

El campo product_detail ofrece a los compradores información legible y estructurada sobre aspectos de un producto que otros campos no cubren, y ayuda a Google a mostrar tus productos en experiencias de búsqueda y IA. Para la lista completa de atributos aceptados y requisitos de formato, consulta Detalle del producto [product_detail] en la Ayuda del Centro de Comerciantes de Google.

 
Cargando
Salesforce Help | Article