UCP-Agentenleistung analysieren (Alpha)

Experimentell :Diese Funktion befindet sich in der Alphaphase (experimentell) und kann sich ändern.

Mit der Merchant Reports API können Sie programmatisch UCP-Messwerte (Universal Commerce Protocol) zur Kaufabwicklung und Conversion-Leistung auf allen Google-Plattformen abrufen, einschließlich des KI-Modus in der Google Suche und in Gemini. Diese Berichte enthalten dieselben Leistungsstatistiken wie das UCP-Analysedashboard im Merchant Center. So können Sie Conversion-Trichter, abgeschlossene Bestellungen, Warenkorbübertragungen und Interaktionen auf Produktebene im Blick behalten.

Die Reporting-Unter-API bietet zwei Ansichten zum Analysieren der UCP-Leistung:

• UcpAgenticPerformanceView (ucp_agentic_performance_view): Enthält Messwerte für den Conversion-Trichter, Bestellungen, Stornierungen und die Übertragung von Einkaufswagen auf Kontoebene, segmentiert nach Datum und Kundenland.
• UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view): Enthält Messwerte für Klicks auf die Schaltfläche „Kaufen“ auf Produktebene (offer_id), segmentiert nach Datum und Kundenland.

Hinweis

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

• v1alpha-Endpunkt verwenden: Senden Sie Ihre MCQL-Anfragen an die Methode v1alpha accounts.reports.search. Weitere Informationen zum Ausführen von Berichtsanfragen finden Sie unter Erste Schritte mit der Merchant Reports API.
• Nur für untergeordnete Konten: Sowohl ucp_agentic_performance_view als auch ucp_agentic_product_performance_view sind nur für untergeordnete Kontotypen (eigenständige Konten und einzelne Unterkonten) verfügbar. Der Berichterstellungsdienst unterstützt keine erweiterten Konten (Mehrfachkundenkonten). Wenn Sie die UCP-Leistung für ein erweitertes Konto abrufen möchten, müssen Sie die einzelnen Unterkonten abfragen.
• Erforderlicher Datumsfilter: Sie müssen für beide Ansichten in der WHERE-Anweisung jeder Abfrage eine Bedingung für date angeben.

Leistung von UCP auf Kontoebene analysieren

Mit ucp_agentic_performance_view können Sie den gesamten UCP-Conversion-Trichter nachvollziehen, von Klicks auf den Kauf-Button 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-Wert enthält:
  • purchase_value
  • average_order_value
  • average_purchase_product_value
  • average_cart_value
  • average_cart_product_value
• Messwerte ohne Preisangabe: Die folgenden Messwerte haben keine zugehörige Währung:
  • buy_button_clicks
  • accounts_linked
  • account_linking_rate
  • purchase_count
  • cancellations
  • average_purchase_product_count
  • cart_transfers
  • average_cart_product_count

Wichtig :Wenn Sie Trichter- oder Zählmesswerte (z. B. buy_button_clicks) in dieselbe Abfrage wie Price-Wertmesswerte einfügen, werden die zurückgegebenen Zeilen nach Währung getrennt. Da Messwerte wie buy_button_clicks keine eigene Währung haben, können beim Kombinieren mit Price-Messwerten Zeilen ohne Kaufwerte aufgeteilt oder ausgelassen werden. Um das zu vermeiden und genaue Gesamtsummen zu erhalten, führen Sie zwei separate Abfragen aus:

1. Messwerte für den gesamten Trichter und Zählungen (währungsunabhängig): Wählen Sie nur Messwerte ohne Preis aus, um aggregierte Zählungen 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 Warenkorbzahlen aus, um Umsatz und Wert pro Währung zu analysieren.

Abfrage 1: Gesamte Trichtermesswerte abrufen (währungsunabhängig)

Mit der folgenden Abfrage lassen sich der Conversion-Trichter insgesamt, die Anzahl der Bestellungen und die Messwerte für die Warenkorbübertragung unabhängig von der Währung abrufen (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'

Hinweis :Da average_cart_value ein Price-Messwert mit einem zugehörigen currency_code ist, sollten Sie ihn aus Ihrer allgemeinen Trichterabfrage entfernen und stattdessen in Ihre Abfrage für Kauf- und Warenkorbwert einfügen.

Die Antwort enthält aggregierte Trichtermesswerte 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 abrufen (nach Währung)

Mit der folgenden Abfrage können Sie Kaufwerte, durchschnittliche Bestellwerte und Werte für die Warenkorbübertragung nach Währung segmentiert abrufen:

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

In der Antwort wird für jede Währung, die in den Messwerten für Kauf- oder Warenkorbwert enthalten ist, eine separate Zeile zurückgegeben:

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

Leistung von UCP auf Produktebene analysieren

Mit ucp_agentic_product_performance_view können Sie sehen, für welche einzelnen Produkte Klicks auf den „Jetzt kaufen“-Button direkt über Google-Plattformen erfolgen.

Klicks auf den „Kaufen“-Button nach Produkt abrufen

Mit der folgenden Abfrage können Sie Klicks auf den Schaltfläche „Jetzt kaufen“ auf Produktebene für ein bestimmtes Datum abrufen:

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 hinweg mit BETWEEN zusammenzufassen:

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 den Schaltflächen „Kaufen“ für jedes übereinstimmende Angebot:

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