Prepara tu cuenta de Merchant Center

Debes tener una cuenta de Merchant Center en regla y productos aprobados para las fichas gratuitas en tu cuenta. Para comenzar, consulta los siguientes artículos del Centro de ayuda:

Una vez que hayas configurado tu cuenta de Merchant Center con productos, debes completar los requisitos de esta sección antes de compilar la integración de la API.

1. Configuración de Merchant Center

Asegúrate de que los siguientes parámetros de configuración estén establecidos en tu cuenta de Google Merchant Center:

1.1. Política de devoluciones

Debes definir tus políticas de devoluciones en Merchant Center, ya que es un requisito del comercio registrado y se hará referencia a ellas en la pantalla de confirmación de compra. Las políticas configuradas se aplican a nivel global en tu cuenta, aunque puedes usar el atributo del feed return_policy_label para restringir una política de devoluciones determinada a un subconjunto de productos.

Si tu cuenta de Merchant Center es una cuenta avanzada, tus políticas de devoluciones deben configurarse en cada cuenta secundaria individual.

Debes incluir el costo de devolución, la velocidad de devolución (período) y un vínculo a la política completa. Obtén más información para configurar las devoluciones aquí.

1.2. Información de asistencia al cliente

Debes configurar la información de asistencia al cliente en Merchant Center. Se usará para generar el vínculo "Comunicarse con el comercio" en la página de confirmación del pedido. Obtén más información para configurar la información de asistencia al cliente aquí.

2. Datos del producto

Debes actualizar tu feed de productos para indicar la elegibilidad y proporcionar datos de cumplimiento. Esta información es necesaria para habilitar la confirmación de compra a través de la UCP con Google, ya que permite que los agentes determinen la elegibilidad de los productos, calculen los costos totales exactos y muestren las advertencias legales obligatorias al usuario.

usar un feed complementario para evitar que se vean afectados tus datos de productos principales.

2.1. Elegibilidad para la confirmación de compra con agentes

Esta acción habilita un producto para la experiencia de confirmación de compra en Google.

Esto se proporciona con un atributo del producto native_commerce que contiene un solo valor booleano. Si se establece como falso o falta, el producto no será apto para la confirmación de la compra.

2.2. Advertencias sobre los productos

Esto es obligatorio para los artículos con requisitos de advertencia reglamentarios (p.ej., California Proposition 65). Eres responsable de cumplir con todas las leyes aplicables, incluidos los requisitos de advertencia sobre los productos. Estas advertencias se muestran de forma destacada en la pantalla de confirmación de compra cuando las proporcionas.

Proporciona el grupo de atributos consumer_notice con dos atributos secundarios:

consumer_notice_type: Debe ser uno de los siguientes: legal_disclaimer, safety_warning o prop_65.
consumer_notice_message: Cadena (máx. 1,000 caracteres). Se aceptan las etiquetas HTML <b>, <br> y <i>.

2.3. Identificador de producto

El id de tu feed de productos debe coincidir con el ID de producto que espera tu API de Checkout. Si coinciden, no es necesario realizar ninguna acción. De lo contrario, usa el atributo personalizado merchant_item_id para asignarlos.

2.4. Cómo agregar los atributos a tus productos

En los siguientes ejemplos, se describen diferentes opciones para proporcionar el producto a Merchant Center.

2.4.1. Feeds

Te recomendamos que crees una fuente de datos complementaria (instrucciones aquí). Puedes agregar este atributo a tu feed principal, pero ten cuidado, ya que el formato incorrecto puede afectar la incorporación normal de productos.

Nota sobre la sintaxis: Asegúrate de que las cadenas complejas (como el mensaje de la Prop 65) no contengan caracteres que interrumpan el formato de tu archivo (como comas adicionales en un archivo CSV), a menos que se hayan escapado correctamente.

Formato de archivo de texto:

ID	native_commerce	consumer_notice
11111	TRUE	`prop_65:This product can expose you...`
22222	TRUE
33333	FALSO

Formato XML:

<item>
  <g:id>11111</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
  <g:consumer_notice>
    <g:consumer_notice_type>prop_65</g:consumer_notice_type>
    <g:consumer_notice_message>
      This product can expose you to chemicals...
    </g:consumer_notice_message>
  </g:consumer_notice>
</item>
<item>
  <g:id>22222</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
</item>
<item>
  <g:id>33333</g:id>
  <g:native_commerce>FALSE</g:native_commerce>
</item>

2.4.2. Content API

Proporciona los atributos como atributos personalizados. Deben incluirse en un products.insert que contenga el producto completo, ya que products.update no admite la actualización de customAttributes.

Ejemplo:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

2.4.2. API de Merchant

Proporciona los atributos como atributos personalizados. Puedes agregarlos a tus accounts.productInputs.insert existentes o actualizarlos directamente con accounts.productInputs.patch.

Ejemplo para insert:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

Ejemplo para update:

Tipo	Nombre	Valor
Parámetros de ruta	`productInput.name`	`accounts/{account}/productInputs/en~US~11111`
Parámetros de consulta	`updateMask`	`customAttributes.native%20commerce,customAttributes.consumer%20notice,customAttributes.product%20fee,customAttributes.merchant%20item%20id`
	`dataSource`	`dataSources/{datasource}`

{
  "offerId": "11111",
  "contentLanguage": "en",
  "feedLabel": "US",
    "customAttributes": [
    {
      "name": "native commerce",
      "groupValues": [
        {
          "name": "checkout eligibility",
          "value": "true"
        }
      ]
    },
    {
      "name": "consumer notice",
      "groupValues": [
        {
          "name": "notice type",
          "value": "prop_65"
        },
        {
          "name": "notice message",
          "value": "This product can expose you to chemicals..."
        }
      ]
    },
    {
      "name": "product fee",
      "groupValues": [
        {
          "name": "product fee type",
          "value": "US_AZ_TIRE_FEE"
        },
        {
          "name": "product fee amount",
          "value": "2.75 USD"
        }
      ]
    },
    {
      "name": "merchant item id",
      "value": "some_checkout_item_id_1"
    }
  ]
}

3. Restricciones de productos

Las siguientes categorías de productos no son aptas para la confirmación de compra. Asegúrate de que estos elementos tengan native_commerce vacío o configurado como false.

Productos financieros y modelos de facturación recurrente

Suscripciones: Son productos que requieren ciclos de facturación recurrentes.
Cuotas: Transacciones que requieren planes de pago o financiación obligatorios por parte del comercio

Bienes personalizados y opciones de preparación de pedidos

Artículos personalizados: Artículos que requieren decisiones de diseño personalizadas (p. ej., grabados o monogramas)
Artículos en oferta o no nuevos: Productos reacondicionados, artículos usados y artículos marcados como "Oferta final" (sin devoluciones).
Artículos de pedidos por adelantado: Productos con fechas de lanzamiento futuras y cumplimiento diferido.
Servicios agrupados: Son artículos que requieren contratos adicionales, como garantías, instalación o configuración.
Envío especial: Artículos que requieren tarifas de envío no estándar (p. ej., envío premium o por transporte)
Regalos: Transacciones que requieren logística de facturas divididas o precios ocultos para los destinatarios.
Activación en la tienda: Productos que se deben activar físicamente en una ubicación de venta minorista.

Restricciones de seguridad y políticas

Con restricción de edad: Artículos que requieren verificación de identidad (p.ej., Alcohol y tabaco).
Contenido prohibido: Armas, contenido para adultos, productos farmacéuticos o de cuidado de la salud, falsificaciones o cualquier otra categoría bloqueada por la Política estándar de Google Shopping

Bienes y servicios digitales

Servicios: Lecciones, clases en línea y paquetes de viajes (a menos que se integren con rieles de viajes específicos)
Alquileres: alquiler de películas, alquiler de equipos o arrendamiento
Artículos virtuales: Moneda del juego, artículos de MMORPG o skins
Dependencias de software: Bienes que requieren que el usuario instale software específico antes de completar la compra.