UCP-Agentenleistung analysieren (Alpha)

Mit der Merchant Reports API können Sie programmatisch Leistungsmesswerte für Direktkäufe und Conversions über das Universal Commerce Protocol (UCP) auf Google-Plattformen abrufen, einschließlich des KI-Modus in der Google Suche und in Gemini. Diese Berichte enthalten dieselben Leistungsstatistiken wie das UCP-Analyse-Dashboard im Merchant Center. So können Sie Conversion-Trichter, abgeschlossene Bestellungen, Warenkorbübertragungen und Interaktionen auf Produktebene im Blick behalten.

Die Reporting-Sub-API bietet zwei Ansichten zur Analyse der UCP-Leistung:

  • UcpAgenticPerformanceView (ucp_agentic_performance_view): Liefert Messwerte auf Kontoebene zu Conversion-Trichter, Bestellungen, Stornierungen und Warenkorbübertragungen, segmentiert nach Datum und Kundenland.
  • UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view): Liefert Messwerte zu Klicks auf die Schaltfläche „Kaufen“ auf Produktebene (offer_id), segmentiert nach Datum und Land des Kunden.

Hinweis

Bevor Sie die UCP-Leistungsansichten abfragen, müssen Sie die folgenden Anforderungen erfüllen:

  • v1alpha-Endpunkt verwenden: Senden Sie Ihre MCQL-Abfragen an die accounts.reports.search-Methode von v1alpha. Weitere Informationen zum Ausführen von Berichtsanfragen finden Sie unter Erste Schritte mit der Merchant Reports API.
  • Unterstützte Kontotypen: Sowohl ucp_agentic_performance_view als auch ucp_agentic_product_performance_view unterstützen Blattkonten (eigenständige Konten und einzelne Unterkonten) sowie erweiterte Konten (Mehrfachkundenkonten oder Aggregatorkonten). Weitere Informationen und Beispiele finden Sie unter Abfrage auf Ebene des erweiterten Kontos.
  • Erforderlicher Datumsfilter: Sie müssen in der WHERE-Klausel jeder Abfrage für beide Ansichten eine Bedingung für date angeben.

Leistung von Nutzerkategorien auf Kontoebene analysieren

Mit ucp_agentic_performance_view können Sie den gesamten UCP-Conversion-Trichter verfolgen, von Klicks auf die Schaltfläche „Kaufen“ und der Kontoverknüpfung bis hin zu abgeschlossenen Käufen und Warenkorbübertragungen.

Währungs- und Preismesswerte

ucp_agentic_performance_view verarbeitet Währungs- und Price-Messwerte auf dieselbe Weise wie Leistungsberichte:

  • Price-Messwerte: Die folgenden Messwerte geben ein Price-Objekt zurück, das sowohl einen amount_micros-Wert als auch einen currency_code enthält:
    • purchase_value
    • average_order_value
    • average_purchase_product_value
    • average_cart_value
    • average_cart_product_value
  • Nicht preisbezogene Messwerte: Die folgenden Messwerte sind nicht mit einer Währung verknüpft:
    • buy_button_clicks
    • accounts_linked
    • account_linking_rate
    • purchase_count
    • cancellations
    • average_purchase_product_count
    • cart_transfers
    • average_cart_product_count
  1. Gesamttrichter und Zählwerte (währungsunabhängig): Wählen Sie nur Messwerte aus, die sich nicht auf den Preis beziehen, um aggregierte Zählwerte unabhängig von der Währung zu erhalten.
  2. Messwerte für Kauf- und Warenkorbwert (nach Währung): Wählen Sie Price-Messwerte zusammen mit den entsprechenden Bestell- und Warenkorbanzahlen aus, um den Umsatz und den Wert pro Währung zu analysieren.

Abfrage 1: Allgemeine Trichter-Messwerte abrufen (währungsunabhängig)

Verwenden Sie die folgende Abfrage, um Messwerte für den gesamten Conversion-Trichter, die Anzahl der Bestellungen und die Warenkorbübertragung unabhängig von der Währung abzurufen (ohne Price-Wertmesswerte):

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'

Die Antwort enthält aggregierte Trichter-Messwerte für jedes Kundenland:

{
  "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
      }
    }
  ]
}

Abfrage 2: Messwerte für Kauf- und Einkaufswagenwert (nach Währung) abrufen

Verwenden Sie die folgende Abfrage, um Kaufwerte, durchschnittliche Bestellwerte und Warenkorb-Übertragungswerte nach Währung segmentiert abzurufen:

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

Die Antwort enthält für jede Währung, die in den Messwerten für den Kauf- oder Warenkorbwert vorhanden ist, eine separate Zeile:

{
  "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-Leistung auf Produktebene analysieren

Mit ucp_agentic_product_performance_view können Sie sehen, welche einzelnen Produkte Klicks auf die Schaltfläche „Kaufen“ direkt auf Google-Plattformen erhalten.

Klicks auf den „Kaufen“-Button nach Produkt abrufen

Verwenden Sie die folgende Abfrage, um die Klicks auf die Schaltfläche „Kaufen“ auf Produktebene für ein bestimmtes Datum abzurufen:

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

Sie können date auch aus der SELECT-Klausel weglassen, um Klicks über einen Zeitraum mit BETWEEN zu aggregieren:

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

Die Antwort enthält die aggregierten Klicks auf die Schaltfläche „Kaufen“ für jedes übereinstimmende Angebot:

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

Abfrage auf der Ebene des erweiterten Kontos

Sie können sowohl ucp_agentic_performance_view als auch ucp_agentic_product_performance_view abfragen, indem Sie im Parameter parent der accounts.reports.search-Anfrage ein erweitertes Konto (Mehrfachkundenkonto oder Dienstleister-Konto) angeben, z. B. accounts/{advanced_account_id}.

In beiden Ansichten enthält die Spalte account_id immer die Blatt-ID des Merchant Center-Kontos (die ID des einzelnen Unterkontos bei Abfragen unter einem erweiterten Konto oder die ID des eigenständigen Kontos bei Abfragen eines eigenständigen Kontos). Wenn Sie Abfragen auf der Ebene des erweiterten Kontos ausführen, bestimmt die Angabe von account_id in der SELECT-Klausel, wie die Messwerte gruppiert werden:

  • account_id weglassen (auf der Ebene des erweiterten Kontos aggregiert): Wenn account_id nicht ausgewählt ist, werden in der Antwort Messwerte für alle Unterkonten des erweiterten Kontos aggregiert.
  • account_id (aufgeschlüsselt nach Unterkonto) auswählen: Wenn account_id ausgewählt ist, werden die Statistiken in der Antwort nach Blatt-account_id segmentiert. Für jedes Unterkonto des erweiterten Kontos wird eine separate Zeile zurückgegeben.

Zusammengefasste Messwerte für ein erweitertes Konto abrufen

Wenn Sie die Messwerte für den gesamten UCP-Trichter auf der Ebene des erweiterten Kontos abrufen möchten, senden Sie die Anfrage mit der ID Ihres erweiterten Kontos als parent-Ressource und lassen Sie account_id in der SELECT-Klausel weg:

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

Die Antwort enthält eine einzelne aggregierte Zeile pro Datum und Kundenland für alle Unterkonten des erweiterten Kontos:

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

Messwerte nach Unterkonto abrufen

Wenn Sie die Ergebnisse beim Abfragen eines erweiterten Kontos nach Unterkonto aufschlüsseln möchten, fügen Sie account_id in die SELECT-Klausel ein:

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

Da account_id immer die ID des Blattkontos enthält, wird in der Antwort für jedes Unterkonto des erweiterten Kontos eine separate Zeile zurückgegeben:

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "buyButtonClicks": "420",
        "accountsLinked": "85",
        "accountLinkingRate": 0.68,
        "purchaseCount": "64",
        "cancellations": "3"
      }
    },
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "987654321",
        "customerCountryCode": "US",
        "buyButtonClicks": "310",
        "accountsLinked": "55",
        "accountLinkingRate": 0.61,
        "purchaseCount": "46",
        "cancellations": "2"
      }
    }
  ]
}
Zurück
Analyze YouTube Affiliate Performance (Alpha)
Weiter
Use Merchant Center Query Language