Mit der Merchant Reports API können Sie Leistungsmesswerte für die Kaufabwicklung und Conversions über das Universal Commerce Protocol (UCP) auf Google-Plattformen, einschließlich des KI-Modus in der Google Suche und Gemini, programmatisch abrufen. 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 dieaccounts.reports.search-Methode vonv1alpha. Weitere Informationen zum Ausführen von Berichtsanfragen finden Sie unter Erste Schritte mit der Merchant Reports API.- Unterstützte Kontotypen: Sowohl
ucp_agentic_performance_viewals auchucp_agentic_product_performance_viewunterstützen Blattkonten (eigenständige Konten und einzelne Unterkonten) sowie erweiterte Konten (Mehrfachkundenkonten oder Aggregatorkonten). Weitere Informationen und Beispiele finden Sie unter Abfrage auf der Ebene des erweiterten Kontos. - Erforderlicher Datumsfilter: Sie müssen in der
WHERE-Klausel jeder Abfrage für beide Ansichten eine Bedingung fürdateangeben.
UCP-Leistung 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:
Preismesswerte: Die folgenden Messwerte geben ein
Price-Objekt zurück, das sowohl einenamount_micros-Wert als auch einencurrency_codeenthält:purchase_valueaverage_order_valueaverage_purchase_product_valueaverage_cart_valueaverage_cart_product_value
Nicht preisbezogene Messwerte: Die folgenden Messwerte haben keine zugehörige Währung:
buy_button_clicksaccounts_linkedaccount_linking_attemptsaccount_linking_ratepurchase_countcancellationsaverage_purchase_product_countcart_transfersaverage_cart_product_count
- 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.
- Messwerte für Kauf- und Warenkorbwert (nach Währung): Wählen Sie
Price-Messwerte zusammen mit der entsprechenden Anzahl von Bestellungen und Warenkörben 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_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'
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",
"accountLinkingAttempts": "125",
"accountLinkingRate": 0.68,
"purchaseCount": "64",
"cancellations": "3",
"averagePurchaseProductCount": 1.75,
"cartTransfers": "52",
"averageCartProductCount": 2.1
}
}
]
}
Abfrage 2: Messwerte für Kauf- und Warenkorbwert abrufen (nach Währung)
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 direkt auf Google-Oberflächen Klicks auf die Schaltfläche „Kaufen“ 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-Merchant Center-Konto-ID (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, hängt die Gruppierung der Messwerte davon ab, ob Sie account_id in die SELECT-Klausel aufnehmen:
account_idweglassen (auf der Ebene des erweiterten Kontos aggregiert): Wennaccount_idnicht ausgewählt ist, werden in der Antwort Messwerte für alle Unterkonten des erweiterten Kontos aggregiert.account_id(aufgeschlüsselt nach Unterkonto) auswählen: Wennaccount_idausgewählt ist, werden die Statistiken in der Antwort nach Blatt-account_idsegmentiert. Für jedes Unterkonto im erweiterten Konto werden separate Zeilen zurückgegeben.
Zusammengefasste Messwerte für ein erweitertes Konto abrufen
Wenn Sie die gesamten Trichter-Messwerte für einheitliche Kaufplattformen 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_attempts,
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",
"accountLinkingAttempts": "200",
"accountLinkingRate": 0.7,
"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_attempts,
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",
"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"
}
}
]
}