Искусственный интеллект Google предоставляет продавцам контекстные данные, помогая им оценивать риски транзакций и принимать решения о целесообразности их проведения. Это позволяет продавцам полностью контролировать покупки, совершаемые на их платформах.
Эти данные передаются преимущественно во время вызова API Complete Checkout .
В спецификации от 08.04.2026 эти сигналы находятся внутри объекта signals и используют префиксы com.google. и dev.ucp. для имен сигналов.
Google предоставляет продавцам следующие типы данных:
Данные сессии
| Название сигнала | Описание | Путь API |
|---|---|---|
| IP-адрес | IP-адрес пользователя в сессии. | com.google.ip_addressdev.ucp.buyer_ip |
| Время начала сессии | Время начала покупки (метка времени Unix epoch). | com.google.session_start_time |
Данные устройства
| Название сигнала | Описание | Путь API |
|---|---|---|
| Тип устройства | Тип используемого устройства (например, MOBILE УСТРОЙСТВО, DESKTOP , TABLET или UNKNOWN ). Определяется на основе User Agent. | com.google.device_type |
| Часовой пояс устройства | Текущий часовой пояс устройства, используемого в сессии. | com.google.device_timezone |
Данные о местоположении
Следующие приблизительные сигналы географического местоположения получены для оказания помощи в предотвращении мошенничества и обнаружении захвата учетных записей.
| Название сигнала | Описание | Путь API |
|---|---|---|
| Страна пользователя | Примерное местоположение покупателя (например, United States ). | com.google.user_country |
| Состояние пользователя | Примерное указание штата или провинции, где находится покупатель (например, California ). | com.google.user_state |
Данные браузера
| Название сигнала | Описание | Путь API |
|---|---|---|
| Агент пользователя | Строка с информацией о клиенте браузера. | dev.ucp.user_agent |
| Язык браузера | Язык, используемый в браузере на устройстве (например, "en"). | com.google.locale |
| Высота области просмотра | Высота области просмотра браузера в пикселях. | com.google.viewport_height_px |
| Ширина области просмотра | Ширина области просмотра браузера в пикселях. | com.google.viewport_width_px |
Данные заказа
В вызовах API Create/Update Checkout доступны следующие данные, которые обеспечивают контекст для заказа:
| Название сигнала | Описание | Путь к API ( Create/Update Checkout ) |
|---|---|---|
| Идентификатор продукта | Помогает продавцу идентифицировать товар. | line_items[x].item.id |
| Идентификатор выполнения заказа | Помогает определить тип и способ доставки. | Зависит от настроек выполнения заказа. |
Данные о доставке и выставлении счетов
Адрес и информация о покупателе предоставляются в основном во время вызовов API Create/Update Checkout .
- Информация для покупателя:
| Название сигнала | Описание | Путь к API ( Create/Update Checkout ) |
|---|---|---|
| Адрес электронной почты пользователя | Адрес электронной почты Google пользователя, вошедшего в систему. | buyer.email |
- Адрес доставки: доступен в
Create/Update Checkoutв полеfulfillment.methods.destinations[x](гдеtype— "shipping", аx—selected_destination_id).
| Название сигнала | Описание | Путь API | Необязательный |
|---|---|---|---|
| Имя | Имя получателя | first_name | Нет |
| Фамилия | Фамилия получателя | last_name | Нет |
| Полное имя | Полное имя получателя | full_name | Да |
| Номер телефона | Номер телефона получателя | phone_number | Да |
| Адрес улицы | Главная улица, адресная строка | street_address | Нет |
| Расширенный адрес | Квартира, люкс и т. д. | extended_address | Да |
| Город | Город или населенный пункт | address_locality | Нет |
| Область | Штат или регион | address_region | Нет |
| Почтовый индекс | Почтовый индекс | postal_code | Нет |
| Страна | Код страны | address_country | Нет |
- Адрес для выставления счетов: доступен в
Complete Checkout. Поля те же, что и в таблице «Адрес доставки», и находятся в объектеpayment.instruments[x].billing_address(гдеx— этоselected_instrument_id).
Данные для проверки платежей
В объекте signals в ответе Complete Checkout доступны следующие поля.
| Название сигнала | Описание | Путь API |
|---|---|---|
| Полные результаты AVS | Результат проверки системы проверки адресов (AVS). | com.google.avs_full_result |
| Результат CVV | Результат проверки кода подтверждения карты (CVV). | com.google.cvv_result |
| Запущена аутентификация | Указывает, была ли выполнена дополнительная аутентификация пользователя. | com.google.authentication_triggered |
| Авторизация обработана с помощью 3DS. | Указывает, была ли выполнена проверка 3D Secure. | com.google.authorization_processed_with_3ds |
Пример
В следующем примере показана структура объекта сигналов риска для версии 2026-04-08 .
{
"signals": {
"com.google.authentication_triggered": "",
"com.google.authorization_processed_with_3ds": "",
"com.google.avs_full_result": "",
"com.google.cvv_result": "",
"com.google.device_timezone": "America/Los_Angeles",
"com.google.device_type": "DESKTOP",
"com.google.ip_address": "2601:646:8600:3360:cce8:3033:4e1f:f6a8",
"com.google.locale": "en",
"com.google.session_start_time": "1781883906339",
"com.google.viewport_height_px": "1991",
"com.google.viewport_width_px": "2036",
"dev.ucp.buyer_ip": "2601:646:8600:3360:cce8:3033:4e1f:f6a8",
"dev.ucp.user_agent": "Mozilla/5.0 (X11; CrOS x86_64 14541.0.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36"
}
}