Как анализировать эффективность агентов UCP (альфа-версия)

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

Reporting sub-API предоставляет два представления для анализа эффективности UCP:

  • UcpAgenticPerformanceView (ucp_agentic_performance_view). Содержит показатели воронки конверсии, заказов, отмен и переносов корзины на уровне аккаунта с сегментацией по дате и стране клиента.
  • UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view): предоставляет показатели кликов по кнопке "Купить" на уровне товара (offer_id) с сегментацией по дате и стране клиента.

Подготовка

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

  • Используйте конечную точку v1alpha. Отправляйте запросы MCQL методу v1alpha accounts.reports.search. Подробнее о том, как начать работу с Merchant Reports API…
  • Поддерживаемые типы аккаунтов. ucp_agentic_performance_view и ucp_agentic_product_performance_view поддерживают дочерние аккаунты (отдельные аккаунты и отдельные дочерние аккаунты), а также расширенные аккаунты (мультиаккаунты или аккаунты агрегаторов). Подробные сведения и примеры приведены в статье Запросы на уровне расширенного аккаунта.
  • Обязательный фильтр по дате. В пункте WHERE каждого запроса для обоих представлений необходимо указать условие для date.

Как анализировать эффективность UCP на уровне аккаунта

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

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

ucp_agentic_performance_view обрабатывает валюту и показатели 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_attempts
    • account_linking_rate
    • purchase_count
    • cancellations
    • average_purchase_product_count
    • cart_transfers
    • average_cart_product_count
  1. Общие показатели воронки и количества (не зависят от валюты). Выберите только показатели, не связанные с ценой, чтобы получить агрегированные данные, не зависящие от валюты.
  2. Показатели ценности покупки и корзины (по валюте). Выберите Price показателей вместе с соответствующим количеством заказов и корзин, чтобы проанализировать доход и ценность по валюте.

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

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

SELECT
  date,
  account_id,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_attempts,
  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'

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

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "buyButtonClicks": "420",
        "accountsLinked": "85",
        "accountLinkingAttempts": "125",
        "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"
      }
    }
  ]
}

Запрос на уровне расширенного аккаунта

Вы можете запрашивать данные как из ucp_agentic_performance_view, так и из ucp_agentic_product_performance_view, указав расширенный аккаунт (мультиаккаунт или аккаунт агрегатора) в параметре parent запроса accounts.reports.search, например accounts/{advanced_account_id}.

В обоих представлениях столбец account_id всегда содержит идентификатор дочернего аккаунта Merchant Center (идентификатор отдельного дочернего аккаунта при запросе в расширенном аккаунте или идентификатор отдельного аккаунта при запросе в отдельном аккаунте). При запросе на уровне расширенного аккаунта включение account_id в предложение SELECT определяет, как группируются показатели:

  • Пропустить account_id (агрегировать на уровне расширенного аккаунта). Если параметр account_id не выбран, в ответе будут агрегированы показатели по всем дочерним аккаунтам, принадлежащим расширенному аккаунту.
  • Выбрать account_id (с разбивкой по дочерним аккаунтам). Если выбран параметр account_id, в ответе статистика будет сегментирована по дочерним аккаунтам account_id, то есть для каждого дочернего аккаунта в расширенном аккаунте будет возвращена отдельная строка.

Как получить агрегированные показатели по расширенному аккаунту

Чтобы получить общие показатели воронки UCP, агрегированные на уровне расширенного аккаунта, отправьте запрос, используя идентификатор расширенного аккаунта в качестве ресурса parent и опустив account_id в предложении SELECT:

SELECT
  date,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_attempts,
  account_linking_rate,
  purchase_count,
  cancellations
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20'

В ответе возвращается одна агрегированная строка для каждой даты и страны клиента по всем дочерним аккаунтам расширенного аккаунта:

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "customerCountryCode": "US",
        "buyButtonClicks": "730",
        "accountsLinked": "140",
        "accountLinkingAttempts": "200",
        "accountLinkingRate": 0.7,
        "purchaseCount": "110",
        "cancellations": "5"
      }
    }
  ]
}

Как получить показатели с разбивкой по дочерним аккаунтам

Чтобы разбить результаты по дочерним аккаунтам при запросе расширенного аккаунта, включите account_id в предложение SELECT:

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

Поскольку account_id всегда содержит идентификатор конечного аккаунта, ответ возвращает отдельную строку для каждого дочернего аккаунта в расширенном аккаунте:

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "buyButtonClicks": "420",
        "accountsLinked": "85",
        "accountLinkingAttempts": "125",
        "accountLinkingRate": 0.68,
        "purchaseCount": "64",
        "cancellations": "3"
      }
    },
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "987654321",
        "customerCountryCode": "US",
        "buyButtonClicks": "310",
        "accountsLinked": "55",
        "accountLinkingAttempts": "100",
        "accountLinkingRate": 0.55,
        "purchaseCount": "46",
        "cancellations": "2"
      }
    }
  ]
}
Назад
Analyze YouTube Affiliate Performance (Alpha)
Далее
Use Merchant Center Query Language