Google Universal Cart y UCP: Preparar WooCommerce para Compras de Agentes de IA

Versión ampliada y actualizada de este tema: Universal Commerce Protocol: cómo los agentes de IA cambian las compras online.

#Del clic a la transacción de máquina: la transición del modelo clásico

Durante más de dos décadas, el comercio electrónico en buscadores ha seguido una secuencia invariable:

1. El usuario introduce una consulta de compra (por ejemplo, zapatillas de trail running impermeables hombre talla 43).
2. El buscador devuelve una lista de resultados orgánicos y anuncios de Google Shopping.
3. El usuario hace clic en un resultado y aterriza en la tienda online externa.
4. En la web de destino, el cliente revisa la ficha, escoge la talla, acepta las cookies, añade el producto a la cesta y completa el checkout manualmente.

Con la expansión de los asistentes multimodales y los agentes de navegación autónoma, este proceso está cambiando con rapidez. Los consumidores ya no desean navegar manualmente por diez sitios web distintos, crear cuentas de usuario temporales ni reintroducir sus datos bancarios en cada compra. La instrucción al asistente es directa: Encuentra zapatillas de trail negras con membrana Gore-Tex en talla 43 con entrega antes del viernes por menos de 150 euros, y cómpralas.

Para ejecutar esta orden de principio a fin, el agente de IA requiere:

• Búsqueda estructurada en catálogos a partir de parámetros técnicos precisos.
• Comprobación inmediata del inventario disponible y del precio total con gastos de envío.
• Una interfaz transaccional tipada que cierre el pedido sin depender de clics en un navegador visual.

Esta es la función exacta del Universal Commerce Protocol. En lugar de considerar una tienda online como un conjunto de páginas HTML que deben ser leídas mediante scraping, el protocolo UCP estructura la tienda como una base de datos expuesta con procedimientos transaccionales seguros.

#Arquitectura del Universal Commerce Protocol

El Universal Commerce Protocol se estructura en tres capas complementarias:

#1. Capa semántica de descubrimiento y capacidades

Permite a la tienda declarar públicamente su identidad, reglas comerciales y modalidades de compra admitidas. La tienda sirve un archivo de manifiesto en la ruta estándar: /.well-known/ucp.json

Este archivo informa a los agentes de IA sobre las capacidades disponibles (solicitud de presupuesto, precios B2B por volumen, pago nativo mediante billetera digital o pasarela integrada en iframe), monedas aceptadas y ubicación de los endpoints de API.

#2. Capa de datos de catálogo estructurados

UCP amplía los estándares de Schema.org en formato JSON-LD, exigiendo un nivel de detalle significativamente mayor al habitual en proyectos SEO convencionales:

• ItemAvailability: Estados de stock rigurosos que diferencian artículos con entrega inmediata, productos bajo pedido o roturas temporales de stock.
• PriceSpecification: Desglose claro de importes netos y brutos, tipos impositivos aplicables, moneda y tramos de precios por volumen.
• hasMerchantReturnPolicy: Condiciones de devolución legibles por máquina, con indicación de plazos legales, gastos de transporte y dirección de recepción.
• DeliveryTimeSpecification: Ventanas de entrega garantizadas según el código postal o la provincia del comprador.

#3. Protocolo transaccional con estado

A diferencia de los feeds estáticos en XML, UCP establece un protocolo bidireccional seguro para la finalización del pedido:

• Creación de la Sesión del Carrito: El agente transmite identificadores SKU, variantes y dirección postal de entrega.
• Reserva Temporal de Stock (Hold Lock): La tienda bloquea las unidades en inventario durante un tiempo fijado (por ejemplo, 15 minutos) bajo una clave de idempotencia exclusiva.
• Cálculo de Impuestos y Logística: El sistema devuelve el importe final garantizado para su aprobación por el cliente.
• Ejecución del Pago: La transacción se autoriza de forma nativa (con tokenización segura de billetera digital) o en un contenedor seguro mediante iframe.

#Diferencias: Google Merchant Center vs Universal Commerce Protocol

Suele existir la duda de si un feed clásico de Google Merchant Center no es ya suficiente. Ambos sistemas responden a propósitos totalmente diferentes:

El feed de Merchant Center actúa como un índice inicial. Sin embargo, en el instante en que un usuario confirma la compra en Gemini, el motor de Google consulta directamente los endpoints UCP de la tienda para verificar que el precio y las existencias siguen vigentes en ese mismo segundo.

#Guía práctica de implementación en WooCommerce

WooCommerce, gracias a su arquitectura modular y a su REST API nativa (/wp-json/wc/v3/), ofrece una base excelente para adoptar UCP, siempre que se optimicen la latencia y la estructura de datos expuesta.

#1. Publicación del manifiesto /.well-known/UCP.json

Cada tienda participante debe servir este archivo desde la raíz del servidor:

{
  "version": "1.0",
  "name": "Tienda Ejemplo WooCommerce",
  "domain": "tiendaejemplo.es",
  "capabilities": {
    "supportsCart": true,
    "supportsInstantHold": true,
    "supportsQuote": true,
    "checkoutModes": ["native", "iframe"]
  },
  "endpoints": {
    "catalog": "https://tiendaejemplo.es/wp-json/wc/v3/products",
    "availability": "https://tiendaejemplo.es/wp-json/ucp/v1/availability",
    "cart": "https://tiendaejemplo.es/wp-json/ucp/v1/cart",
    "returnPolicy": "https://tiendaejemplo.es/es/politica-de-devoluciones/"
  },
  "supportedCurrencies": ["EUR"],
  "contactEmail": "[email protected]"
}

#2. Enriquecimiento de Schema.org en PHP

Para que los agentes de compras determinen correctamente los costes de envío y los plazos de devolución, estos datos deben incorporarse en el marcado JSON-LD de WooCommerce:

add_filter('woocommerce_structured_data_product_offer', function($offer, $product) {
    if (!$product instanceof WC_Product) {
        return $offer;
    }

    $offer['priceSpecification'] = [
        '@type' => 'PriceSpecification',
        'price' => wc_format_decimal($product->get_price(), 2),
        'priceCurrency' => get_woocommerce_currency(),
        'valueAddedTaxIncluded' => wc_prices_include_tax() ? 'true' : 'false'
    ];

    $offer['hasMerchantReturnPolicy'] = [
        '@type' => 'MerchantReturnPolicy',
        'applicableCountry' => 'ES',
        'returnPolicyCategory' => 'https://schema.org/MerchantReturnFiniteReturnWindow',
        'merchantReturnDays' => 30,
        'returnMethod' => 'https://schema.org/ReturnByMail',
        'returnFees' => 'https://schema.org/FreeReturn'
    ];

    $offer['shippingDetails'] = [
        '@type' => 'OfferShippingDetails',
        'shippingRate' => [
            '@type' => 'MonetaryAmount',
            'value' => '4.50',
            'currency' => get_woocommerce_currency()
        ],
        'shippingDestination' => [
            '@type' => 'DefinedRegion',
            'addressCountry' => 'ES'
        ],
        'deliveryTime' => [
            '@type' => 'ShippingDeliveryTime',
            'handlingTime' => [
                '@type' => 'QuantitativeValue',
                'minValue' => 0,
                'maxValue' => 1,
                'unitCode' => 'DAY'
            ],
            'transitTime' => [
                '@type' => 'QuantitativeValue',
                'minValue' => 1,
                'maxValue' => 3,
                'unitCode' => 'DAY'
            ]
        ]
    ];

    return $offer;
}, 10, 2);

#3. Endpoints ligeros para verificación y reserva de stock

Las rutas habituales de compra en WooCommerce cargan multitud de ganchos de plantillas y sesiones de usuario. Las solicitudes de agentes de IA deben responderse en menos de 150 milisegundos.

La solución adecuada es crear un controlador REST ligero:

add_action('rest_api_init', function () {
    register_rest_route('ucp/v1', '/availability', [
        'methods' => 'POST',
        'callback' => 'handle_ucp_fast_availability',
        'permission_callback' => '__return_true',
    ]);
});

function handle_ucp_fast_availability(WP_REST_Request $request) {
    $sku = sanitize_text_field($request->get_param('sku'));
    $quantity = max(1, intval($request->get_param('quantity')));

    $product_id = wc_get_product_id_by_sku($sku);
    if (!$product_id) {
        return new WP_Error('not_found', 'El producto no existe', ['status' => 404]);
    }

    $product = wc_get_product($product_id);
    $in_stock = $product->is_in_stock();
    $stock_qty = $product->get_stock_quantity();

    $is_available = $in_stock && ($stock_qty === null || $stock_qty >= $quantity);

    return rest_ensure_response([
        'sku' => $sku,
        'available' => $is_available,
        'stockQuantity' => $stock_qty,
        'price' => wc_format_decimal($product->get_price(), 2),
        'currency' => get_woocommerce_currency(),
        'holdDurationSeconds' => 900 // Garantía de reserva por 15 minutos
    ]);
}

#4. Idempotencia para evitar pedidos duplicados

Cuando un agente autónomo experimenta una pequeña interrupción en la red, su lógica de reintento enviará la petición nuevamente. Si la tienda no cuenta con protecciones, podría reservar o cobrar el mismo producto en dos ocasiones.

La solución consiste en exigir una cabecera X-Idempotency-Key con un valor UUIDv4. La respuesta se guarda en memoria caché (como Redis). Si se recibe una petición con la misma clave en un plazo de 24 horas, el sistema devuelve el resultado almacenado sin volver a procesar el pedido en la base de datos.

#El problema de las etiquetas UTM y la atribución en buscadores de IA

Investigaciones recientes sobre el comportamiento de herramientas como ChatGPT, SearchGPT y Perplexity han revelado que estas plataformas eliminan sistemáticamente las etiquetas de seguimiento UTM de los enlaces salientes. Este filtrado se realiza para proteger la privacidad del usuario y presentar direcciones web limpias.

Para las tiendas online, este fenómeno genera consecuencias importantes:

• Las visitas generadas a partir de recomendaciones de IA aparecen erróneamente clasificadas como tráfico directo (Direct) en Google Analytics.
• Los equipos de marketing no pueden calcular el retorno de inversión real (ROI) de sus esfuerzos en optimización para motores generativos (GEO).

#Solución: atribución basada en document.referrer

Al desaparecer los parámetros de la URL, la cabecera Referer capturada por el navegador es la única referencia fidedigna.

El código de analítica de la tienda debe evaluar document.referrer en la primera página vista:

• Accesos procedentes de chatgpt.com, chat.openai.com o aplicaciones móviles de OpenAI se categorizan como fuente ai:chatgpt y medio ai-referral.
• Lo mismo aplica a visitas provenientes de perplexity.ai, claude.ai o gemini.google.com.
• Esta procedencia debe guardarse en el almacenamiento de atribución de primer toque, garantizando que futuras navegaciones del usuario hasta completar la compra no borren el origen real de la venta.

#Relación entre UCP, Anthropic MCP y WordPress

En el debate técnico sobre WordPress e inteligencia artificial aparecen con frecuencia las siglas UCP y MCP (Model Context Protocol):

• Model Context Protocol (MCP): Estándar abierto publicado por Anthropic en noviembre de 2024. Permite a los modelos de lenguaje consultar bases de datos y ejecutar funciones de forma estructurada. Es la interfaz de ejecución técnica del asistente.
• Universal Commerce Protocol (UCP): Estándar de negocio enfocado exclusivamente en las operaciones de compraventa. Define las reglas de carritos, reservas de stock, confirmación de precios y garantías de devolución.

En arquitecturas avanzadas, ambos trabajan juntos: un servidor MCP permite al asistente explorar y comprender el catálogo de la tienda, mientras que UCP gestiona la formalización de la compra. La visión de Automattic que sitúa a WordPress como el sistema operativo de la web agéntica refuerza las ventajas del software de código abierto, ofreciendo a los propietarios de tiendas soberanía total sobre sus datos transaccionales y su relación con los clientes.

#Conclusiones y plan de acción

El lanzamiento del Google Universal Cart confirma que las compras gestionadas por agentes de IA son ya una realidad comercial.

Pasos clave para tiendas WooCommerce:

1. Auditar los datos Schema.org: Verificar que precios, condiciones de devolución y plazos de entrega están definidos en formato JSON-LD.
2. Publicar el manifiesto UCP: Crear el archivo /.well-known/ucp.json en la raíz de la web.
3. Optimizar la REST API: Desvincular las consultas de stock de la carga pesada del tema para garantizar tiempos de respuesta inferiores a 150ms.
4. Actualizar el seguimiento: Implementar atribución basada en referrer para monitorizar visitas de plataformas de IA sin etiquetas UTM.

Si desea contar con asistencia técnica especializada en la arquitectura o implementación de su tienda, conozca nuestros servicios de Universal Commerce Protocol e integración de IA en WordPress. Póngase en contacto a través de nuestro formulario de contacto para analizar su proyecto.