Анализ эффективности агента UCP (Альфа)

Экспериментальная функция: Эта функция находится в альфа-версии (экспериментальной) и может быть изменена.

API отчетов для продавцов позволяет программно получать метрики эффективности оформления заказа и конверсии по протоколу Universal Commerce Protocol (UCP) на всех платформах Google, включая режим AI в Поиске и Gemini. Эти отчеты предоставляют те же данные об эффективности, что и панель аналитики UCP в Merchant Center , помогая отслеживать воронки конверсии, завершенные заказы, перемещения по корзинам и вовлеченность на уровне товаров.

Вспомогательный API для отчетности предоставляет два представления для анализа производительности UCP:

• UcpAgenticPerformanceView ( ucp_agentic_performance_view ) : Предоставляет метрики воронки конверсии, заказов, отмен и перемещений по корзине на уровне аккаунта, сегментированные по дате и стране клиента.
• UcpAgenticProductPerformanceView ( ucp_agentic_product_performance_view ) : Предоставляет метрики кликов по кнопке покупки на уровне продукта ( offer_id ), сегментированные по дате и стране клиента.

Прежде чем начать

Перед тем как запрашивать данные о производительности UCP, убедитесь, что выполняются следующие требования:

• Используйте конечную точку v1alpha : отправляйте ваши MCQL -запросы методу accounts.reports.search в v1alpha . Подробную информацию о выполнении запросов на создание отчетов см. в разделе «Начало работы с API отчетов для продавцов» .
• Только для конечных учетных записей : Параметры ucp_agentic_performance_view и ucp_agentic_product_performance_view доступны только для конечных типов учетных записей (автономные учетные записи и отдельные суб-учетные записи). Служба отчетности не поддерживает расширенные учетные записи (многоклиентские учетные записи). Для получения данных о производительности UCP по расширенной учетной записи необходимо запрашивать данные по каждой суб-учетной записи отдельно.
• Обязательный фильтр по дате : Для обоих представлений необходимо указать условие по date в предложении WHERE каждого запроса.

Анализ производительности UCP на уровне учетной записи

Используйте ucp_agentic_performance_view для отслеживания всей воронки конверсии UCP, от кликов по кнопке покупки и привязки аккаунта до завершенных покупок и перемещения товаров по корзине.

Показатели валюты и цен

ucp_agentic_performance_view обрабатывает показатели валюты и Price так же, как и отчеты о производительности :

• Показатели Price : Следующие показатели возвращают объект Price , содержащий как значение amount_micros , так и currency_code :
  • purchase_value
  • average_order_value
  • average_purchase_product_value
  • average_cart_value
  • average_cart_product_value
• Показатели, не связанные с ценой : Следующие показатели не имеют связанной валюты:
  • buy_button_clicks
  • accounts_linked
  • account_linking_rate
  • purchase_count
  • cancellations
  • average_purchase_product_count
  • cart_transfers
  • average_cart_product_count

Важно: включение метрик воронки продаж или подсчета (например, buy_button_clicks ) в тот же запрос, что и метрик стоимости Price , разделяет возвращаемые строки по валюте. Поскольку такие метрики, как buy_button_clicks , сами по себе не имеют связанной валюты, их объединение с метриками Price может привести к разделению или пропуску строк без значений покупок. Чтобы избежать этого и получить точные итоговые данные, выполните два отдельных запроса:

1. Общие показатели воронки продаж и количества покупок (независимые от валюты) : выберите только показатели, не связанные с ценой, чтобы получить сводные данные, не зависящие от валюты.
2. Показатели стоимости покупок и корзины (по валютам) : Выберите показатели Price вместе с соответствующими количествами заказов и корзин, чтобы проанализировать выручку и стоимость по каждой валюте.

Запрос 1: Получение общих показателей воронки продаж (независимых от валюты).

Используйте следующий запрос для получения общих показателей воронки конверсии, количества заказов и перемещений по корзине независимо от валюты (без учета показателей стоимости Price ):

SELECT
  date,
  account_id,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_rate,
  purchase_count,
  cancellations,
  average_purchase_product_count,
  cart_transfers,
  average_cart_product_count
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20'

Примечание: Поскольку average_cart_value — это метрика Price со связанным с ней currency_code , исключите её из общего запроса воронки продаж и включите вместо этого в запрос по сумме покупок и стоимости корзины.

В ответе возвращаются агрегированные показатели воронки продаж для каждой страны-клиента:

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "buyButtonClicks": "420",
        "accountsLinked": "85",
        "accountLinkingRate": 0.68,
        "purchaseCount": "64",
        "cancellations": "3",
        "averagePurchaseProductCount": 1.75,
        "cartTransfers": "52",
        "averageCartProductCount": 2.1
      }
    }
  ]
}

Запрос 2: Получение показателей покупки и стоимости корзины (по валюте)

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

SELECT
  date,
  account_id,
  customer_country_code,
  purchase_count,
  purchase_value,
  average_order_value,
  average_purchase_product_count,
  average_purchase_product_value,
  average_cart_value,
  average_cart_product_value
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20' AND purchase_count > 0

В ответе возвращается отдельная строка для каждой валюты, присутствующей в показателях покупки или стоимости корзины:

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "purchaseCount": "64",
        "purchaseValue": {
          "amountMicros": "5120000000",
          "currencyCode": "USD"
        },
        "averageOrderValue": {
          "amountMicros": "80000000",
          "currencyCode": "USD"
        },
        "averagePurchaseProductCount": 1.75,
        "averagePurchaseProductValue": {
          "amountMicros": "45714285",
          "currencyCode": "USD"
        },
        "cartTransfers": "52",
        "averageCartValue": {
          "amountMicros": "94500000",
          "currencyCode": "USD"
        },
        "averageCartProductCount": 2.1,
        "averageCartProductValue": {
          "amountMicros": "45000000",
          "currencyCode": "USD"
        }
      }
    }
  ]
}

Анализ производительности UCP на уровне продукта.

Используйте ucp_agentic_product_performance_view чтобы увидеть, какие именно товары получают клики по кнопке покупки непосредственно с платформ Google.

Получение данных о кликах по кнопке «Купить» по каждому товару.

Используйте следующий запрос для получения информации о кликах по кнопке покупки на уровне отдельных товаров за определенную дату:

SELECT
  date,
  account_id,
  customer_country_code,
  offer_id,
  title,
  buy_button_clicks
FROM ucp_agentic_product_performance_view
WHERE date = '2026-09-20'

Также можно опустить date в предложении SELECT , чтобы агрегировать клики по диапазону дат, используя BETWEEN :

SELECT
  account_id,
  customer_country_code,
  offer_id,
  title,
  buy_button_clicks
FROM ucp_agentic_product_performance_view
WHERE date BETWEEN '2026-09-01' AND '2026-09-20'
ORDER BY buy_button_clicks DESC

В ответе отображаются суммарные клики по кнопке покупки для каждого соответствующего предложения:

{
  "results": [
    {
      "ucpAgenticProductPerformanceView": {
        "accountId": "123456789",
        "customerCountryCode": "US",
        "offerId": "sku-10042",
        "title": "Lightweight Running Shoes - Blue / Size 10",
        "buyButtonClicks": "38"
      }
    }
  ]
}