Як налаштувати Universal Commerce Protocol для вашого магазину.Google має схвалити інтеграцію, перш ніж покупець зможе купити у вас в AI Mode чи Gemini.

Покупець в AI Mode від Google просить товар, агент знаходить його у вашому каталозі, і покупка відбувається без того, щоб покупець хоч раз завантажив ваш сайт. Universal Commerce Protocol (UCP) дає агенту змогу це зробити, і він працює лише тоді, коли ваш магазин правильно відповідає в момент запиту агента. Що має публікувати ваш магазин? Які товари може купити агент? Що перевіряє Google, перш ніж дозволити вам запуститися? У нашій роботі з UCP сторінка товару щоразу знала більше, ніж фід, і ендпоінт, побудований лише з фіду, давав би агентам менше, ніж покупець бачить на сторінці.

UCP це відкритий стандарт, і ваш магазин публікує те, що він підтримує

UCP розробила Google разом із Shopify, Etsy, Wayfair, Target і Walmart, а його специфікація розміщена на ucp.dev. Офіційним продавцем (merchant of record) є ваш магазин: клієнт, замовлення і відповідальність за платіж залишаються за вами, а агент діє від імені покупця.

Усе починається з профілю, який ваш магазин публікує за адресою /.well-known/ucp. У ньому вказано версію протоколу, сервіси, які ви пропонуєте, і як до них дістатися, ваші платіжні обробники та публічні ключі, якими агент перевіряє ваші підписані повідомлення. Агент читає його, перш ніж робити будь-що інше.

Версії UCP це дати. Остання специфікація станом на жовтень 2026 року це 2026-08-25, а посібники Google з упровадження використовують 2026-04-08. Магазин може обслуговувати REST, MCP, A2A або вбудоване оформлення замовлення, і основним є REST.

Крок 1: Виправте неправильні дані про товари

Google читає фід за розкладом, але агент викликає ендпоінт UCP у реальному часі, тож усе, що неправильно у ваших даних, доходить до покупця в момент покупки, і нікого поруч немає, щоб це перехопити. Ми виправляємо неправильні дані, перш ніж щось додавати, і ці виправлення окуповуються в Merchant Center незалежно від того, чи запуститься UCP взагалі.

Зберігайте GTIN як текст на всьому шляху. Система, яка обробляє їх як числа, відкидає нулі на початку, і GTIN перестає збігатися. Перевіряйте кожен за записом виробника в GS1, а не доповнюйте його, доки він не підійде.

Крок 2: Додайте дані, потрібні агенту, щоб завершити покупку

Сторінки товарів зазвичай містять більше, ніж фід: повну галерею зображень, бренд, рейтинги, справжню роздрібну ціну й умови доставки. Агент бачить лише те, що ви йому надсилаєте.

• Розгорнуті описи. Ставте головну відмінність товару на початок, бо агент може процитувати лише вступ. Прямо вказуйте обмеження, як-от граничну вагу, вимоги до живлення і куди товар можна відправити, і наводьте розміри в обох системах одиниць.
• Окремі варіанти. Батьківський товар, розміри чи кольори якого злиті в один рядок, має стати окремим рядком для кожного варіанта, згрупованим за item_group_id.
• Доставка, повернення і гарантія у вигляді даних, а не лише абзаців на сторінці політики.
• Кожне зображення, яке показує сторінка. Фід, що містить лише перше, залишає агенту менше, ніж бачить покупець.
• Живі рівні залишків замість позначки «є в наявності» чи «немає в наявності». Google вимагає живої перевірки залишків під час оформлення замовлення і помилки out_of_stock, коли товар розпродано.

Merchant Center обмежує опис 5 000 символів і не хоче бачити в ньому рекламних деталей, як-от цін чи пропозицій доставки, тоді як опис UCP може містити доставку, гарантію й обмеження. Напишіть повну версію для UCP і скоротіть її для фіду.

Ціни в UCP це цілі числа в найменшій одиниці валюти, тож $129.99 надсилається як 12999. Помилка в одиниці змінює ціну товару в сто разів в той чи інший бік, тож перевірте це, перш ніж щось запуститься.

Крок 3: Вирішіть, які товари може купувати агент

Настанови Google щодо Merchant Center виключають з оформлення замовлення агентом цілі категорії, серед них:

• підписки і плани розстрочки чи фінансування;
• персоналізовані товари, відновлені, вживані товари і товари без права повернення, а також попередні замовлення;
• пакетні послуги на кшталт встановлення чи розширеної гарантії, вантажні перевезення і преміальна доставка, а також активація в магазині;
• товари з віковими обмеженнями і заборонені товари, послуги, оренда і віртуальні предмети.

Виключіть їх, а решту вмикайте товар за товаром.

Дорогий товар, який багато покупців купують за планом фінансування, може продаватися гірше через оформлення замовлення з гаманцем, що не пропонує такого плану. Виміряйте, скільки замовлень цього товару використовують фінансування, перш ніж вмикати для нього оформлення замовлення агентом. Магазин також може публікувати свій каталог для агентів і залишати оформлення замовлення на власному сайті. Це законна конфігурація UCP і часто правильний перший етап.

Крок 4: Підготуйте Merchant Center

Посібник Google з упровадження починається з Merchant Center: акаунт має бути з хорошою репутацією, а товари мають бути схвалені для безкоштовних оголошень.

• Політика повернення. Укажіть вартість повернення, строк повернення і посилання на повну політику на рівні акаунта або для кожного товару через атрибут returns. Google показує її на екрані оформлення замовлення.
• Підтримка клієнтів. Додайте щонайменше один спосіб зв’язку: сторінку підтримки, адресу електронної пошти або номер телефону. На ньому працює посилання «Contact Merchant» у підтвердженні замовлення.
• Увімкнення товарів. Установіть native_commerce(checkout_eligibility) у значення TRUE для кожного придатного товару. Google рекомендує додаткове джерело даних, щоб увімкнення не порушувало ваш основний фід.
• Регуляторні повідомлення. Товари з юридичним застереженням, попередженням про безпеку або попередженням Proposition 65 потребують consumer_notice з його типом і повідомленням довжиною до 1 000 символів.
• Відповідність ID. id у фіді має збігатися з ID товару, який очікує ваше оформлення замовлення. Якщо вони різняться, надсилайте merchant_item_id.

Крок 5: Приєднайтеся до списку очікування Google

Google каже, що інтеграція «має бути схвалена Google, перш ніж ви зможете запуститися» в AI Mode і Gemini. Вхід до процесу лежить через форму заявки на інтеграцію UCP у Довідці Merchant Center, яка ставить ваш магазин у список очікування. Вбудоване оформлення замовлення, коли ваше власне оформлення замовлення працює всередині інтерфейсу Google, доступне лише схваленим продавцям. Надішліть форму, поки ведете розробку, бо схвалення це крок, який ви не можете пришвидшити самі.

Крок 6: Створіть профіль і ендпоінти

Магазин або використовує підтримку UCP, вбудовану в його комерційну платформу, або створює її сам. Коли створюємо ми, то ставимо перед магазином тонкий сервіс, який спілкується з агентами через UCP, а з магазином через власний API платформи, і розміщуємо його під доменом магазину, щоб профіль і ендпоінти мали одне джерело (origin). UCP часто переглядають, і якщо тримати його поза платформою, нова версія не чекає на реліз платформи.

• Публікуйте лише те, що працює. Агент, який знайде оформлення замовлення у вашому профілі, спробує ним скористатися. Перший реліз може оголошувати лише пошук і перегляд каталогу, а оформлення замовлення додати, коли воно буде готове.
• Використовуйте справжні ключі підпису. Публічні ключі профілю перевіряють ваші підписані оновлення замовлень, тож згенеруйте пару ключів і тримайте приватну половину на сервері.
• Зробіть повторні спроби безпечними. Приймайте ключ ідемпотентності у викликах оформлення замовлення, щоб повторний запит не списав кошти двічі.
• Працюйте через HTTPS. Специфікація REST вимагає щонайменше TLS 1.3.
• Перевіряйте адреси. Повертайте адресу, за якою неможливо доставити, як помилку, яку можна виправити, щоб покупець міг її виправити, а не опинився в глухому куті.
• Додайте посилання на свої політики. Ваші умови діють для кожної покупки через UCP, тож включіть у відповідь оформлення замовлення посилання на політику конфіденційності, умови використання, політику відшкодування і політику доставки.

Крок 7: Підключіть платежі

На шляху нативного оформлення замовлення Google ваш профіль оголошує платіжний обробник Google Pay. Вам не потрібен Google Pay API на власному сайті, але ваш платіжний процесор має приймати платіжні токени Google, і більшість великих процесорів їх приймає. У FAQ Google зазначено, що його AI-поверхні використовують лише метод авторизації PAN_ONLY і що налаштування Google Pay у профілі використовують назви у snake_case. Тримайте тестові та робочі облікові дані платіжного процесора окремо і ніколи не записуйте їх у логи.

Крок 8: Протестуйте так, як тестуватиме Google

Google надсилає перевірки стану з user agent Google-UCP-Prober/1.0 і позначає запити агентів заголовком UCP-Agent та user agent, що починається з Google/UCP. Перш ніж подавати заявку, надішліть запити до власних ендпоінтів так, як це зробив би Google.

• Чи доходить /.well-known/ucp до вашого магазину? Правило вебсервера може відповідати на цей шлях власним 404 ще до того, як запит дійде до застосунку, навіть коли ваші ендпоінти UCP працюють.
• Чи пропускає ваш фаєрвол Google? Захист від ботів, який блокує скриптовий трафік, заблокує і пробер, тож пропускайте запити Google до UCP за їхніми заголовками, а не за адресою.
• Чи правильно поводяться захищені ендпоінти? Ендпоінти оформлення замовлення, платежів і замовлень мають відхиляти запити без облікових даних і приймати облікові дані Google.

Крок 9: Сплануйте наступну версію UCP

Специфікація 2026-08-25 додає стандартні політики повернення і гарантії, яких немає у 2026-04-08, а Google документує 2026-04-08. Доки посібники Google не перейдуть на новішу версію, цю інформацію несе ваша політика повернення в Merchant Center. Коли ви переходите на нову версію, Google рекомендує обслуговувати її з окремого ендпоінта, щоб у разі збою можна було повернути трафік на стару.

WISLR налаштовує UCP для брендів і для клієнтів агенцій

Кожен крок вище входить до сервісу WISLR Agentic Commerce Optimization. Ми перевіряємо каталог на відповідність вимогам Google, виправляємо й доповнюємо дані про товари, готуємо Merchant Center і фід для увімкнення товарів, а також створюємо й тестуємо профіль UCP та ендпоінти, доки інтеграція не буде готова до схвалення Google. Бренди залучають нас напряму, а агенції залучають нас під власним ім’ям, щоб налаштувати це для своїх клієнтів. Подивіться, як ми налаштовуємо UCP і замовте оцінку свого каталогу.