Часто задаваемые вопросы

Найдите ответы на часто задаваемые вопросы о Универсальном торговом протоколе (УТП).

Общий

Что такое Универсальный протокол коммерции (UCP)?

UCP — это наш новый открытый стандарт, разработанный для объединения цифровой коммерции. Мы создали его, чтобы обеспечить прямые, мгновенные покупки на платформах с использованием ИИ, таких как режим ИИ в поиске Google и приложение Gemini. Наша цель — уменьшить сложности в процессе покупки и помочь вам свести к минимуму отказы от покупки.

Каковы основные преимущества интеграции с UCP?

Интеграция с UCP дает вам следующие преимущества:

  • Расширенный охват: прямой доступ к пользователям на наших платформах, включая режим искусственного интеллекта в поиске Google и приложении Gemini.
  • Снижение сложностей при оформлении заказа: мы обеспечиваем возможность прямых покупок в рамках процесса взаимодействия с пользователем, поддерживая его вовлеченность.
  • Контроль: вы остаетесь официальным продавцом, сохраняя полный контроль над отношениями с клиентами и их данными.
  • Гибкость: мы предлагаем различные варианты интеграции (нативную и встроенную), чтобы соответствовать вашему бренду и техническому стеку.
  • Готовность к работе с агентами: мы разрабатываем это для поддержки будущих возможностей агентов, таких как корзины с несколькими товарами и привязка учетных записей.

Чем отличается UCP от других организаций?

  • Модульная и расширяемая архитектура: UCP разработана как модульная и расширяемая платформа для поддержки многофункционального коммерческого взаимодействия с использованием дополнительных возможностей и расширений.
  • Быстро и легко внедряется: UCP позволяет продавцам выбирать набор возможностей и расширений, которые они хотят поддерживать, а также средство связи, которое наилучшим образом соответствует их потребностям в разработке, например, API, MCP или A2A.
  • Разработанная совместно с лидерами отрасли: UCP — это программное обеспечение с открытым исходным кодом, созданное в результате сотрудничества лидеров отрасли для поддержки разнообразных потребностей развитой коммерческой экосистемы.
  • Безопасные и бесперебойные платежи: UCP поддерживает безопасные платежи с использованием токенизации и позволяет продавцам расширять существующие платежные интеграции с помощью обработчиков платежей.

На каких поверхностях будут отображаться наши интеграции?

На момент запуска ваша интеграция с UCP будет обеспечивать работу функций в режиме искусственного интеллекта в поиске Google, а также в веб-приложении Gemini и мобильном приложении Gemini. В будущем мы планируем добавить поддержку и других поверхностей.

Интеграция и настройка

Совместим ли UCP с моим существующим технологическим стеком?

Мы создали UCP на основе открытых стандартов, что обеспечивает его бесшовную совместимость с основными существующими протоколами, которые вы, возможно, уже используете, такими как AP2, A2A и MCP.

Нужно ли мне вносить изменения в свой аккаунт в Merchant Center?

Merchant Center остается центральным элементом нашей экосистемы. Вы должны убедиться, что ваши товарные фиды, фирменные элементы, политика возврата и контактная информация компании являются полными и актуальными. Конкретные требования к данным указаны в наших руководствах по внедрению .

Чем мы отличаемся от других протоколов?

Мы разработали UCP как всеобъемлющий открытый стандарт, специально предназначенный для коммерции, управляемой искусственным интеллектом, в сотрудничестве с отраслевыми партнерами. В отличие от протоколов, ориентированных исключительно на платежи, мы поддерживаем более широкий процесс совершения покупок (включая поиск и рассмотрение вариантов), основанный на нашем графе покупок.

Как отличить трафик из UCP от трафика из моих собственных каналов?

Вы можете отличить трафик UCP от обычного трафика вашего веб-сайта или приложения двумя способами:

  • HTTP-заголовки: Вы можете идентифицировать входящие запросы UCP на сетевом уровне, проверив, соответствует ли запрос двум условиям: присутствует заголовок с меткой UCP-Agent:Profile , и значение User-Agent начинается с Google/UCP .
  • Контракты API: Мы обмениваемся событиями жизненного цикла оформления заказа, транзакций и оформления покупки, используя контракты API, установленные в наших спецификациях. Это позволяет четко различать трафик и платежи, проходящие через наши интерфейсы ИИ на уровне приложения.

Как мы обрабатываем проверки запасов в режиме реального времени?

Как продавец, вы обязаны проводить проверку наличия товара в режиме реального времени. Если товар отсутствует на складе на любом этапе оформления заказа, ваш API должен вернуть ответное сообщение, содержащее код ошибки out_of_stock . Когда ваша система возвращает эту ошибку, мы показываем пользователю соответствующее сообщение об ошибке, например: «Этот товар в настоящее время отсутствует на складе. Попробуйте другой вариант или зайдите позже».

Для получения более подробной информации см. примеры ошибок, out_of_stock .

Как безопасно перевести мою интеграцию в рабочую среду на более новую версию спецификации UCP?

Для обеспечения безопасного тестирования и развертывания мы рекомендуем настроить отдельную конечную точку API для новой версии спецификации. Такой подход обеспечивает лучшую изоляцию трафика и позволяет Google безопасно управлять и отслеживать переход трафика между двумя конечными точками. В случае возникновения каких-либо проблем во время миграции Google сможет перенаправить трафик обратно на вашу исходную конечную точку.

Проверяет ли Google автоматически и блокирует ли международные адреса доставки?

Нет. Как продавец, вы несете ответственность за проверку адресов доставки. Когда пользователь выбирает адрес доставки, мы передаем данные о получателе (включая код address_country ) на ваш сервер во время вызовов API для создания или обновления заказа. Если адрес находится за пределами поддерживаемых вами зон доставки, ваша система должна отправить это в ответе API, используя стандартные коды ошибок UCP, такие как address_undeliverable или address_unverifiable .

Для получения более подробной информации см. раздел «Коды ошибок» .

Платежи и токенизация

Как UCP соотносится с Протоколом агентских платежей (AP2)?

AP2 — это наш стандарт для безопасных платежных транзакций, инициируемых агентами. Мы используем UCP для организации более широкого жизненного цикла покупки, в то время как AP2 может использоваться в качестве специализированного платежного уровня в рамках UCP. Это особенно полезно для будущих сценариев, связанных с транзакциями, осуществляемыми автономными агентами искусственного интеллекта.

Как мы обрабатываем платежи? Нужно ли мне поддерживать Google Pay?

Вам не обязательно поддерживать оформление заказа с использованием API Google Pay на вашем веб-сайте или в приложении, но ваш поставщик платежных услуг (PSP) должен уметь обрабатывать наши токены. Большинство крупных мировых PSP поддерживают Google Pay .

Если у меня несколько учетных записей Google Pay и Wallet (например, по одной на каждую страну), какую из них мне следует указать в своем профиле UCP?

Мы не требуем от вас использования разных профилей для разных стран. Вы можете использовать любую учетную запись Google Pay & Wallet или комбинацию учетных записей, которая лучше всего подходит для вашей бизнес-системы.

Если у меня уже есть Google Pay, будете ли вы учитывать мои существующие настройки (например, ограничения по картам)?

Поскольку UCP — это отдельная интеграция, вам необходимо явно указать конфигурацию Google Pay в своем профиле UCP. Вы можете использовать те же параметры конфигурации, что и для вашего веб-сайта или приложения, или указать другую конфигурацию. Учитывайте следующие требования:

  • Поддерживаемые параметры: Настройки аналогичны настройкам вашей существующей интеграции, но поддерживаемые параметры не совпадают один к одному (например, UCP использует snake_case вместо camelCase ). Полный список см. в конфигурации обработчика платежей Google Pay .
  • Поддерживаемые методы аутентификации: UCP на платформах Google AI поддерживает только PAN_ONLY в поле allowed_auth_methods . Вы можете указать другие методы (например, CRYPTOGRAM_3DS ), но они не будут использоваться в процессе оформления заказа UCP.

Безопасность и мониторинг

Как Google отслеживает работоспособность моей API-терминалы?

Google может периодически отправлять HTTP-запросы к вашим API-интерфейсам, чтобы убедиться в их доступности и работоспособности. Эти запросы на проверку работоспособности будут содержать специальный заголовок User-Agent: User-Agent: Google-UCP-Prober/1.0 .

Как я могу убедиться, что запросы к API действительно поступают от Google?

Чтобы убедиться, что запросы исходят от Google, следуйте официальным инструкциям по проверке запросов от Google, приведенным в разделе «Проверка запросов от Google» . В этом руководстве подробно описаны такие методы, как обратный DNS-запрос, и приведены ссылки на опубликованные нами файлы диапазонов IP-адресов.

Могу ли я ограничить входящие запросы к API Google определенными странами (геоограничение)?

Нет. Google динамически управляет исходящим трафиком, используя основные серверы, поэтому мы не можем гарантировать, что запросы будут исходить из конкретной страны. Вместо блокировки по географическому признаку мы рекомендуем настроить брандмауэр для аутентификации и разрешения запросов Google на основе токена OAuth 2.0 Bearer или других безопасных подписей, предоставляемых в процессе аутентификации между машинами.

Пользовательский опыт

Повлияет ли нативная интеграция на рейтинг моего продукта?

Нет. Выбор нашей собственной интеграции не влияет на то, как мы ранжируем ваши предложения в списках товаров. Пользовательский интерфейс списков остается неизменным; однако предложения, интегрированные с UCP, будут содержать опцию прямой покупки.

Могут ли пользователи изменить адрес доставки во время оформления заказа?

Да. Мы позволяем пользователям просматривать и изменять свой адрес доставки в процессе оформления заказа. Мы ожидаем, что ваша система будет динамически обновлять стоимость доставки и налоги на основе предоставленного нового адреса.

Как мне сообщить о наличии возможности дополнительной аутентификации пользователя (связывание идентификационных данных)?

Чтобы указать на наличие дополнительной аутентификации, необходимо активировать функцию «Связывание идентификаторов» в вашем профиле UCP. Это позволит устройствам Google обнаружить эту функцию до начала сеанса оформления заказа.

Для получения дополнительной информации см. раздел «Связывание идентификаторов — OAuth 2.0» .

Как пользователю отображаются устранимые ошибки оформления заказа?

Когда ваш API возвращает устранимую ошибку, например, address_undeliverable , наш пользовательский интерфейс предлагает пользователю обновить свои данные (например, выбрав другой адрес доставки). Убедитесь, что вы правильно указали уровень серьезности как recoverable в массиве messages ; в противном случае пользователь столкнется с блокирующим экраном ошибки и не сможет завершить оформление заказа.

Для получения более подробной информации см. раздел «Коды ошибок» .

Потеряю ли я контроль над данными своих клиентов?

Нет. Вы являетесь официальным продавцом. Вы сохраняете полное право собственности на ваши отношения с клиентами и их данные.

Как мы обеспечиваем конфиденциальность данных клиентов?

К взаимодействию применяются наши стандартные методы обеспечения безопасности и конфиденциальности, но данные о транзакциях принадлежат вам. Мы также разрабатываем такие функции, как привязка учетных записей, которые призваны обеспечить пользователю контроль над своими данными.

Какие условия и положения применяются к сделкам UCP?

Ваши Условия и положения регулируют покупку так же, как если бы покупатель оформил заказ на вашем собственном веб-сайте. Мы отображаем эти условия покупателю, и он должен принять их в процессе оформления заказа.

Существуют ли ограничения на повторный маркетинг для клиентов, привлеченных через UCP?

Поскольку вы являетесь официальным продавцом, вы обладаете информацией о клиенте так же, как и при прямой покупке. Действуют стандартные правила конфиденциальности и процедуры получения согласия. В будущем обновлении мы планируем добавить функцию, которая позволит пользователям явно давать согласие на получение маркетинговых сообщений во время оформления заказа.

Какова политика хранения данных о заказах, передаваемых в Google?

Google хранит стандартные данные о заказах (информацию, которая отображается на странице пользователя «Мои заказы») бессрочно, пока пользователь явно не запросит их удаление в соответствии со стандартной политикой удаления данных.

Поскольку вы являетесь официальным продавцом, на данные, хранящиеся в ваших системах, продолжают распространяться политики вашей компании в отношении хранения данных и соблюдения нормативных требований (например, хранение финансовых отчетов в течение 7 лет).

,

Найдите ответы на часто задаваемые вопросы о Универсальном торговом протоколе (УТП).

Общий

Что такое Универсальный протокол коммерции (UCP)?

UCP — это наш новый открытый стандарт, разработанный для объединения цифровой коммерции. Мы создали его, чтобы обеспечить прямые, мгновенные покупки на платформах с использованием ИИ, таких как режим ИИ в поиске Google и приложение Gemini. Наша цель — уменьшить сложности в процессе покупки и помочь вам свести к минимуму отказы от покупки.

Каковы основные преимущества интеграции с UCP?

Интеграция с UCP дает вам следующие преимущества:

  • Расширенный охват: прямой доступ к пользователям на наших платформах, включая режим искусственного интеллекта в поиске Google и приложении Gemini.
  • Снижение сложностей при оформлении заказа: мы обеспечиваем возможность прямых покупок в рамках процесса взаимодействия с пользователем, поддерживая его вовлеченность.
  • Контроль: вы остаетесь официальным продавцом, сохраняя полный контроль над отношениями с клиентами и их данными.
  • Гибкость: мы предлагаем различные варианты интеграции (нативную и встроенную), чтобы соответствовать вашему бренду и техническому стеку.
  • Готовность к работе с агентами: мы разрабатываем это для поддержки будущих возможностей агентов, таких как корзины с несколькими товарами и привязка учетных записей.

Чем отличается UCP от других организаций?

  • Модульная и расширяемая архитектура: UCP разработана как модульная и расширяемая платформа для поддержки многофункционального коммерческого взаимодействия с использованием дополнительных возможностей и расширений.
  • Быстро и легко внедряется: UCP позволяет продавцам выбирать набор возможностей и расширений, которые они хотят поддерживать, а также средство связи, которое наилучшим образом соответствует их потребностям в разработке, например, API, MCP или A2A.
  • Разработанная совместно с лидерами отрасли: UCP — это программное обеспечение с открытым исходным кодом, созданное в результате сотрудничества лидеров отрасли для поддержки разнообразных потребностей развитой коммерческой экосистемы.
  • Безопасные и бесперебойные платежи: UCP поддерживает безопасные платежи с использованием токенизации и позволяет продавцам расширять существующие платежные интеграции с помощью обработчиков платежей.

На каких поверхностях будут отображаться наши интеграции?

На момент запуска ваша интеграция с UCP будет обеспечивать работу функций в режиме искусственного интеллекта в поиске Google, а также в веб-приложении Gemini и мобильном приложении Gemini. В будущем мы планируем добавить поддержку и других поверхностей.

Интеграция и настройка

Совместим ли UCP с моим существующим технологическим стеком?

Мы создали UCP на основе открытых стандартов, что обеспечивает его бесшовную совместимость с основными существующими протоколами, которые вы, возможно, уже используете, такими как AP2, A2A и MCP.

Нужно ли мне вносить изменения в свой аккаунт в Merchant Center?

Merchant Center остается центральным элементом нашей экосистемы. Вы должны убедиться, что ваши товарные фиды, фирменные элементы, политика возврата и контактная информация компании являются полными и актуальными. Конкретные требования к данным указаны в наших руководствах по внедрению .

Чем мы отличаемся от других протоколов?

Мы разработали UCP как всеобъемлющий открытый стандарт, специально предназначенный для коммерции, управляемой искусственным интеллектом, в сотрудничестве с отраслевыми партнерами. В отличие от протоколов, ориентированных исключительно на платежи, мы поддерживаем более широкий процесс совершения покупок (включая поиск и рассмотрение вариантов), основанный на нашем графе покупок.

Как отличить трафик из UCP от трафика из моих собственных каналов?

Вы можете отличить трафик UCP от обычного трафика вашего веб-сайта или приложения двумя способами:

  • HTTP-заголовки: Вы можете идентифицировать входящие запросы UCP на сетевом уровне, проверив, соответствует ли запрос двум условиям: присутствует заголовок с меткой UCP-Agent:Profile , и значение User-Agent начинается с Google/UCP .
  • Контракты API: Мы обмениваемся событиями жизненного цикла оформления заказа, транзакций и оформления покупки, используя контракты API, установленные в наших спецификациях. Это позволяет четко различать трафик и платежи, проходящие через наши интерфейсы ИИ на уровне приложения.

Как мы обрабатываем проверки запасов в режиме реального времени?

Как продавец, вы обязаны проводить проверку наличия товара в режиме реального времени. Если товар отсутствует на складе на любом этапе оформления заказа, ваш API должен вернуть ответное сообщение, содержащее код ошибки out_of_stock . Когда ваша система возвращает эту ошибку, мы показываем пользователю соответствующее сообщение об ошибке, например: «Этот товар в настоящее время отсутствует на складе. Попробуйте другой вариант или зайдите позже».

Для получения более подробной информации см. примеры ошибок, out_of_stock .

Как безопасно перевести мою интеграцию в рабочую среду на более новую версию спецификации UCP?

Для обеспечения безопасного тестирования и развертывания мы рекомендуем настроить отдельную конечную точку API для новой версии спецификации. Такой подход обеспечивает лучшую изоляцию трафика и позволяет Google безопасно управлять и отслеживать переход трафика между двумя конечными точками. В случае возникновения каких-либо проблем во время миграции Google сможет перенаправить трафик обратно на вашу исходную конечную точку.

Проверяет ли Google автоматически и блокирует ли международные адреса доставки?

Нет. Как продавец, вы несете ответственность за проверку адресов доставки. Когда пользователь выбирает адрес доставки, мы передаем данные о получателе (включая код address_country ) на ваш сервер во время вызовов API для создания или обновления заказа. Если адрес находится за пределами поддерживаемых вами зон доставки, ваша система должна отправить это в ответе API, используя стандартные коды ошибок UCP, такие как address_undeliverable или address_unverifiable .

Для получения более подробной информации см. раздел «Коды ошибок» .

Платежи и токенизация

Как UCP соотносится с Протоколом агентских платежей (AP2)?

AP2 — это наш стандарт для безопасных платежных транзакций, инициируемых агентами. Мы используем UCP для организации более широкого жизненного цикла покупки, в то время как AP2 может использоваться в качестве специализированного платежного уровня в рамках UCP. Это особенно полезно для будущих сценариев, связанных с транзакциями, осуществляемыми автономными агентами искусственного интеллекта.

Как мы обрабатываем платежи? Нужно ли мне поддерживать Google Pay?

Вам не обязательно поддерживать оформление заказа с использованием API Google Pay на вашем веб-сайте или в приложении, но ваш поставщик платежных услуг (PSP) должен уметь обрабатывать наши токены. Большинство крупных мировых PSP поддерживают Google Pay .

Если у меня несколько учетных записей Google Pay и Wallet (например, по одной на каждую страну), какую из них мне следует указать в своем профиле UCP?

Мы не требуем от вас использования разных профилей для разных стран. Вы можете использовать любую учетную запись Google Pay & Wallet или комбинацию учетных записей, которая лучше всего подходит для вашей бизнес-системы.

Если у меня уже есть Google Pay, будете ли вы учитывать мои существующие настройки (например, ограничения по картам)?

Поскольку UCP — это отдельная интеграция, вам необходимо явно указать конфигурацию Google Pay в своем профиле UCP. Вы можете использовать те же параметры конфигурации, что и для вашего веб-сайта или приложения, или указать другую конфигурацию. Учитывайте следующие требования:

  • Поддерживаемые параметры: Настройки аналогичны настройкам вашей существующей интеграции, но поддерживаемые параметры не совпадают один к одному (например, UCP использует snake_case вместо camelCase ). Полный список см. в конфигурации обработчика платежей Google Pay .
  • Поддерживаемые методы аутентификации: UCP на платформах Google AI поддерживает только PAN_ONLY в поле allowed_auth_methods . Вы можете указать другие методы (например, CRYPTOGRAM_3DS ), но они не будут использоваться в процессе оформления заказа UCP.

Безопасность и мониторинг

Как Google отслеживает работоспособность моей API-терминалы?

Google может периодически отправлять HTTP-запросы к вашим API-интерфейсам, чтобы убедиться в их доступности и работоспособности. Эти запросы на проверку работоспособности будут содержать специальный заголовок User-Agent: User-Agent: Google-UCP-Prober/1.0 .

Как я могу убедиться, что запросы к API действительно поступают от Google?

Чтобы убедиться, что запросы исходят от Google, следуйте официальным инструкциям по проверке запросов от Google, приведенным в разделе «Проверка запросов от Google» . В этом руководстве подробно описаны такие методы, как обратный DNS-запрос, и приведены ссылки на опубликованные нами файлы диапазонов IP-адресов.

Могу ли я ограничить входящие запросы к API Google определенными странами (геоограничение)?

Нет. Google динамически управляет исходящим трафиком, используя основные серверы, поэтому мы не можем гарантировать, что запросы будут исходить из конкретной страны. Вместо блокировки по географическому признаку мы рекомендуем настроить брандмауэр для аутентификации и разрешения запросов Google на основе токена OAuth 2.0 Bearer или других безопасных подписей, предоставляемых в процессе аутентификации между машинами.

Пользовательский опыт

Повлияет ли нативная интеграция на рейтинг моего продукта?

Нет. Выбор нашей собственной интеграции не влияет на то, как мы ранжируем ваши предложения в списках товаров. Пользовательский интерфейс списков остается неизменным; однако предложения, интегрированные с UCP, будут содержать опцию прямой покупки.

Могут ли пользователи изменить адрес доставки во время оформления заказа?

Да. Мы позволяем пользователям просматривать и изменять свой адрес доставки в процессе оформления заказа. Мы ожидаем, что ваша система будет динамически обновлять стоимость доставки и налоги на основе предоставленного нового адреса.

Как мне сообщить о наличии возможности дополнительной аутентификации пользователя (связывание идентификационных данных)?

Чтобы указать на наличие дополнительной аутентификации, необходимо активировать функцию «Связывание идентификаторов» в вашем профиле UCP. Это позволит устройствам Google обнаружить эту функцию до начала сеанса оформления заказа.

Для получения дополнительной информации см. раздел «Связывание идентификаторов — OAuth 2.0» .

Как пользователю отображаются устранимые ошибки оформления заказа?

Когда ваш API возвращает устранимую ошибку, например, address_undeliverable , наш пользовательский интерфейс предлагает пользователю обновить свои данные (например, выбрав другой адрес доставки). Убедитесь, что вы правильно указали уровень серьезности как recoverable в массиве messages ; в противном случае пользователь столкнется с блокирующим экраном ошибки и не сможет завершить оформление заказа.

Для получения более подробной информации см. раздел «Коды ошибок» .

Потеряю ли я контроль над данными своих клиентов?

Нет. Вы являетесь официальным продавцом. Вы сохраняете полное право собственности на ваши отношения с клиентами и их данные.

Как мы обеспечиваем конфиденциальность данных клиентов?

К взаимодействию применяются наши стандартные методы обеспечения безопасности и конфиденциальности, но данные о транзакциях принадлежат вам. Мы также разрабатываем такие функции, как привязка учетных записей, которые призваны обеспечить пользователю контроль над своими данными.

Какие условия и положения применяются к сделкам UCP?

Ваши Условия и положения регулируют покупку так же, как если бы покупатель оформил заказ на вашем собственном веб-сайте. Мы отображаем эти условия покупателю, и он должен принять их в процессе оформления заказа.

Существуют ли ограничения на повторный маркетинг для клиентов, привлеченных через UCP?

Поскольку вы являетесь официальным продавцом, вы обладаете информацией о клиенте так же, как и при прямой покупке. Действуют стандартные правила конфиденциальности и процедуры получения согласия. В будущем обновлении мы планируем добавить функцию, которая позволит пользователям явно давать согласие на получение маркетинговых сообщений во время оформления заказа.

Какова политика хранения данных о заказах, передаваемых в Google?

Google хранит стандартные данные о заказах (информацию, которая отображается на странице пользователя «Мои заказы») бессрочно, пока пользователь явно не запросит их удаление в соответствии со стандартной политикой удаления данных.

Поскольку вы являетесь официальным продавцом, на данные, хранящиеся в ваших системах, продолжают распространяться политики вашей компании в отношении хранения данных и соблюдения нормативных требований (например, хранение финансовых отчетов в течение 7 лет).