Usted está aquí:
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
verdaderoofalso. - 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:
- Producto variante: B2C Commerce primero verifica el valor del atributo del producto variante.
- Grupo de variaciones: Si la variante no tiene el valor del atributo, B2C Commerce revisa el grupo de variaciones (si aplica).
- 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:
- 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.
-
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.
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.
| 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.
