Google Merchant API exposes AI Mode and Gemini checkout funnels — with an alpha reporting trap

Google's October 2026 Merchant Reports API release makes two Universal Commerce Protocol (UCP) performance views queryable through v1alpha accounts.reports.search. The account-level ucp_agentic_performance_view reports buy-button clicks, account linking, purchase counts and values, cancellations and cart transfers, while ucp_agentic_product_performance_view exposes product-level buy-button clicks by offer ID. Reports cover Google surfaces including Search AI Mode and Gemini, support standalone and multi-client merchant accounts, and require a date filter. Google warns that mixing currency-denominated Price metrics with currency-independent counts in one query can split or omit rows, so merchants should run separate count and value queries. The feature is alpha, subject to change, and does not itself expand merchant eligibility or guarantee UCP orders.

Agentic commerce moves parts of product discovery and purchase decisions inside search and assistant interfaces, where conventional site analytics can miss upstream intent. First-party reporting of buy-button, account-linking, cart and purchase stages gives retailers and commerce SaaS teams a way to diagnose funnel drop-off and evaluate integrations. But misgrouping money and count metrics can create incorrect totals, and the alpha API is not a mature cross-platform attribution standard. This is a distinct reporting capability, not the Shopify Global Catalog UCP migration or Google's existing warranty-feed expansion.

UcpAgenticPerformanceView aggregates buy-button clicks, account links, purchases, cancellations, cart transfers and value metrics by date, merchant account and customer country. UcpAgenticProductPerformanceView exposes product-level buy-button clicks by offer_id, date and country. Queries use Merchant Center Query Language through the v1alpha accounts.reports.search endpoint, and date must be included in WHERE.

Google warns that combining Price fields such as purchase_value or average_order_value with currency-independent counts such as buy_button_clicks can split results by currency and omit count-only rows. Query count/funnel metrics separately from monetary metrics, and aggregate value metrics by currency. The published sample is illustrative, not a performance benchmark.

Both standalone leaf accounts and advanced multi-client accounts are supported, contrary to the assumption that only aggregators qualify. This is explicitly experimental v1alpha functionality and may change. The API reports UCP activity across Google surfaces including AI Mode and Gemini; it does not promise full user-level attribution or comparable data from other assistants.

Google launched Universal Cart in US Search and Gemini earlier in October, already covered in BTN's dossier #471. The new API adds a developer-accessible measurement layer for participating merchants. Existing Google Search Console generative-AI reporting measures content discovery rather than UCP purchase funnels; they are not interchangeable.