UCP 에이전트 성능 분석 (알파)

Merchant Reports API를 사용하면 검색의 AI 모드 및 Gemini를 비롯한 Google 서비스 전반에서 범용 상거래 프로토콜 (UCP) 결제 및 전환 실적 측정항목을 프로그래매틱 방식으로 검색할 수 있습니다. 이 보고서는 판매자 센터 UCP 분석 대시보드에서 제공되는 것과 동일한 실적 통계를 제공하여 전환 유입경로, 완료된 주문, 장바구니 전송, 상품 수준 참여도를 모니터링하는 데 도움이 됩니다.

보고 하위 API는 UCP 실적을 분석하기 위한 두 가지 뷰를 제공합니다.

  • UcpAgenticPerformanceView (ucp_agentic_performance_view): 날짜 및 고객 국가별로 분류된 계정 수준 전환 유입경로, 주문, 취소, 장바구니 전송 측정항목을 제공합니다.
  • UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view): 날짜 및 고객 국가별로 분류된 상품 수준(offer_id) 구매 버튼 클릭 측정항목을 제공합니다.

시작하기 전에

UCP 실적 보기를 쿼리하기 전에 다음 요구사항을 충족하는지 확인하세요.

  • v1alpha 엔드포인트 사용: v1alpha accounts.reports.search 메서드로 MCQL 쿼리를 전송합니다. 보고서 요청 실행에 관한 자세한 내용은 Merchant Reports API 시작하기를 참고하세요.
  • 리프 계정만 해당: ucp_agentic_performance_view 및 ucp_agentic_product_performance_view는 리프 계정 유형 (독립형 계정 및 개별 하위 계정)에만 사용할 수 있습니다. 보고 서비스는 고급 계정 (멀티 클라이언트 계정)을 지원하지 않습니다. 고급 계정 전체의 UCP 실적을 가져오려면 각 하위 계정을 개별적으로 쿼리하세요.
  • 필수 날짜 필터: 두 뷰의 모든 쿼리에서 WHERE 절에 date에 대한 조건을 지정해야 합니다.

계정 수준 UCP 실적 분석

ucp_agentic_performance_view를 사용하여 구매 버튼 클릭 및 계정 연결부터 구매 완료 및 장바구니 전송까지 전체 UCP 전환 유입경로를 추적합니다.

통화 및 가격 측정항목

ucp_agentic_performance_view는 실적 보고서와 동일한 방식으로 통화 및 Price 측정항목을 처리합니다.

  • Price 측정항목: 다음 측정항목은 amount_micros 값과 currency_code를 모두 포함하는 Price 객체를 반환합니다.
    • 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
  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'

응답은 각 고객 국가에 대해 집계된 유입경로 측정항목을 반환합니다.

{
  "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'

SELECT 절에서 date을 생략하여 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"
      }
    }
  ]
}
이전
Analyze YouTube Affiliate Performance (Alpha)
다음
Use Merchant Center Query Language